======================================================================
                                API REFERENCE
======================================================================

Base URL: https://ytm-search.fakcloud.tech
Response Format: JSON
CORS: Enabled (Access-Control-Allow-Origin: *)

----------------------------------------------------------------------
1. Search Tracks
----------------------------------------------------------------------
Endpoint: GET /api/search
Description: Search for tracks matching a keyword query.

Query Parameters:
  - q (string, required): Search keywords.

Example Request:
  GET https://ytm-search.fakcloud.tech/api/search?q=Daft+Punk

Example Response:
  [
    {
      "videoId": "gA4AnagC8sI",
      "title": "Get Lucky",
      "author": "Daft Punk",
      "duration": 248,
      "thumbnail": "https://img.youtube.com/vi/gA4AnagC8sI/hqdefault.jpg"
    }
  ]

----------------------------------------------------------------------
2. Trending Tracks
----------------------------------------------------------------------
Endpoint: GET /api/trending
Description: Retrieve top popular/trending tracks.

Query Parameters:
  None

Example Request:
  GET https://ytm-search.fakcloud.tech/api/trending

Example Response:
  [
    {
      "videoId": "...",
      "title": "...",
      "author": "...",
      "duration": 0,
      "thumbnail": "..."
    }
  ]

----------------------------------------------------------------------
3. Playlist Items
----------------------------------------------------------------------
Endpoint: GET /api/playlist
Description: Get items from a playlist.

Query Parameters:
  - list (string, required): Playlist ID.

Example Request:
  GET https://ytm-search.fakcloud.tech/api/playlist?list=PL4fGSI1pDJn6O1LS0XSdF3RyO0Rq_LDeI

Example Response:
  [
    {
      "videoId": "...",
      "title": "...",
      "author": "...",
      "duration": "3:45"
    }
  ]

----------------------------------------------------------------------
4. Lyrics
----------------------------------------------------------------------
Endpoint: GET /api/genius
Description: Get plain text lyrics for a song query.

Query Parameters:
  - q (string, required): Song title and artist.

Example Request:
  GET https://ytm-search.fakcloud.tech/api/genius?q=Queen+Bohemian+Rhapsody

Example Response:
  {
    "lyrics": "Is this the real life?...",
    "title": "Bohemian Rhapsody",
    "artist": "Queen",
    "url": "https://..."
  }

----------------------------------------------------------------------
5. Channel Image
----------------------------------------------------------------------
Endpoint: GET /api/channel-image
Description: Fetch channel profile image URL.

Query Parameters:
  - url (string, required): Channel profile page URL.

Example Request:
  GET https://ytm-search.fakcloud.tech/api/channel-image?url=https://www.youtube.com/@DaftPunk

Example Response:
  {
    "image": "https://..."
  }