Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.drain.lat/llms.txt

Use this file to discover all available pages before exploring further.

​
Spotify

Base URL: https://drain.lat/api/v1/spotify All endpoints require the x-api-key header.

​
GET /search

Search for artists on Spotify by name. Endpoint 
GET /api/v1/spotify/search?q=drake
ParameterTypeRequiredDescription
qstringYesArtist name to search
curl "https://drain.lat/api/v1/spotify/search?q=drake" \
  -H "x-api-key: YOUR_API_KEY"
Response 
{
  "query": "drake",
  "artists": [
    {
      "id": "3TVXtAsR1Inumwj472S9r4",
      "name": "Drake",
      "genres": ["canadian hip hop", "rap", "toronto rap"],
      "followers": 88000000,
      "popularity": 96,
      "avatarUrl": "https://i.scdn.co/image/...",
      "spotifyUrl": "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4"
    }
  ],
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

​
GET /artist/:id

Get a Spotify artist by their Spotify ID. Endpoint 
GET /api/v1/spotify/artist/:id

curl "https://drain.lat/api/v1/spotify/artist/3TVXtAsR1Inumwj472S9r4" \
  -H "x-api-key: YOUR_API_KEY"
Response 
{
  "id": "3TVXtAsR1Inumwj472S9r4",
  "name": "Drake",
  "genres": ["canadian hip hop", "rap", "toronto rap"],
  "followers": 88000000,
  "popularity": 96,
  "avatarUrl": "https://i.scdn.co/image/...",
  "spotifyUrl": "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4",
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

​
GET /artist/:id/tracks

Get an artist’s top 10 tracks. Endpoint 
GET /api/v1/spotify/artist/:id/tracks

curl "https://drain.lat/api/v1/spotify/artist/3TVXtAsR1Inumwj472S9r4/tracks" \
  -H "x-api-key: YOUR_API_KEY"
Response 
{
  "artistId": "3TVXtAsR1Inumwj472S9r4",
  "tracks": [
    {
      "id": "2507CQMJ8xFZbFGSC9FXMX",
      "name": "God's Plan",
      "album": "Scorpion",
      "albumArt": "https://i.scdn.co/image/...",
      "durationMs": 198973,
      "popularity": 88,
      "previewUrl": "https://p.scdn.co/mp3-preview/...",
      "spotifyUrl": "https://open.spotify.com/track/2507CQMJ8xFZbFGSC9FXMX"
    },
    {
      "id": "1zi7xx7UVEFkmKfv06H8x0",
      "name": "One Dance",
      "album": "Views",
      "albumArt": "https://i.scdn.co/image/...",
      "durationMs": 173987,
      "popularity": 85,
      "previewUrl": "https://p.scdn.co/mp3-preview/...",
      "spotifyUrl": "https://open.spotify.com/track/1zi7xx7UVEFkmKfv06H8x0"
    }
  ],
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}