drain.lat API

GET /search

Search for artists on Spotify by name.

GET /api/v1/spotify/search

string

required

Artist name to search.

curl "https://drain.lat/api/v1/spotify/search?q=drake" \
  -H "x-api-key: YOUR_API_KEY"

query

string

The search query used.

artists

array

Show artist object

string

Spotify artist ID.

name

string

Artist name.

genres

string[]

List of genres.

followers

number

Follower count.

popularity

number

Popularity score (0-100).

avatarUrl

string

Artist image URL.

spotifyUrl

string

Link to Spotify artist page.

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.

GET /api/v1/spotify/artist/:id

string

required

Spotify artist ID (e.g. 3TVXtAsR1Inumwj472S9r4 for Drake).

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.

GET /api/v1/spotify/artist/:id/tracks

string

required

Spotify artist ID.

curl "https://drain.lat/api/v1/spotify/artist/3TVXtAsR1Inumwj472S9r4/tracks" \
  -H "x-api-key: YOUR_API_KEY"

artistId

string

Spotify artist ID.

tracks

array

Show track object

string

Track ID.

name

string

Track name.

album

string

Album name.

albumArt

string

Album art URL.

durationMs

number

Track duration in milliseconds.

popularity

number

Popularity score (0-100).

previewUrl

string

30-second preview URL.

spotifyUrl

string

Link to the track on Spotify.

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"
    }
  ],
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

GET /search/tracks

Search for tracks on Spotify.

GET /api/v1/spotify/search/tracks

string

required

Track name or search query.

curl "https://drain.lat/api/v1/spotify/search/tracks?q=god%27s+plan" \
  -H "x-api-key: YOUR_API_KEY"

query

string

The search query used.

tracks

array

Show track object

string

Track ID.

name

string

Track name.

artists

array

List of artists with id and name.

album

string

Album name.

albumArt

string

Album art URL.

durationMs

number

Duration in milliseconds.

popularity

number

Popularity score (0-100).

previewUrl

string

30-second preview URL.

explicit

boolean

Whether the track is explicit.

spotifyUrl

string

Link to the track on Spotify.

Response

{
  "query": "god's plan",
  "tracks": [
    {
      "id": "6DCZcSspjsKoFjzjrWoCdn",
      "name": "God's Plan",
      "artists": [{ "id": "3TVXtAsR1Inumwj472S9r4", "name": "Drake" }],
      "album": "Scorpion",
      "albumArt": "https://...",
      "durationMs": 198973,
      "popularity": 88,
      "previewUrl": "https://...",
      "explicit": true,
      "spotifyUrl": "https://open.spotify.com/track/6DCZcSspjsKoFjzjrWoCdn"
    }
  ],
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /search/albums

Search for albums on Spotify.

GET /api/v1/spotify/search/albums

string

required

Album name or search query.

curl "https://drain.lat/api/v1/spotify/search/albums?q=scorpion" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "query": "scorpion",
  "albums": [
    {
      "id": "1ATL5GLyefJaxhQzSPVrLX",
      "name": "Scorpion",
      "artists": [{ "id": "3TVXtAsR1Inumwj472S9r4", "name": "Drake" }],
      "releaseDate": "2018-06-29",
      "totalTracks": 25,
      "coverUrl": "https://...",
      "spotifyUrl": "https://open.spotify.com/album/1ATL5GLyefJaxhQzSPVrLX"
    }
  ],
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /artist/:id/albums

Get an artist’s albums and singles.

GET /api/v1/spotify/artist/:id/albums

string

required

Spotify artist ID.

curl "https://drain.lat/api/v1/spotify/artist/3TVXtAsR1Inumwj472S9r4/albums" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "artistId": "3TVXtAsR1Inumwj472S9r4",
  "albums": [
    {
      "id": "1ATL5GLyefJaxhQzSPVrLX",
      "name": "Scorpion",
      "type": "album",
      "releaseDate": "2018-06-29",
      "totalTracks": 25,
      "coverUrl": "https://...",
      "spotifyUrl": "https://open.spotify.com/album/1ATL5GLyefJaxhQzSPVrLX"
    }
  ],
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /artist/:id/related

Get artists related to a given artist.

GET /api/v1/spotify/artist/:id/related

string

required

Spotify artist ID.

curl "https://drain.lat/api/v1/spotify/artist/3TVXtAsR1Inumwj472S9r4/related" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "artistId": "3TVXtAsR1Inumwj472S9r4",
  "related": [
    {
      "id": "0Y5tJX1MQlPlqiwlOH1tJY",
      "name": "Travis Scott",
      "genres": ["rap", "trap"],
      "followers": 42000000,
      "popularity": 91,
      "avatarUrl": "https://...",
      "spotifyUrl": "https://open.spotify.com/artist/0Y5tJX1MQlPlqiwlOH1tJY"
    }
  ],
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /track/:id

Get info for a single Spotify track.

GET /api/v1/spotify/track/:id

string

required

Spotify track ID.

curl "https://drain.lat/api/v1/spotify/track/6DCZcSspjsKoFjzjrWoCdn" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "id": "6DCZcSspjsKoFjzjrWoCdn",
  "name": "God's Plan",
  "artists": [{ "id": "3TVXtAsR1Inumwj472S9r4", "name": "Drake" }],
  "album": "Scorpion",
  "albumId": "1ATL5GLyefJaxhQzSPVrLX",
  "albumArt": "https://...",
  "releaseDate": "2018-06-29",
  "durationMs": 198973,
  "popularity": 88,
  "previewUrl": "https://...",
  "explicit": true,
  "spotifyUrl": "https://open.spotify.com/track/6DCZcSspjsKoFjzjrWoCdn",
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /album/:id

Get a full album with tracklist.

GET /api/v1/spotify/album/:id

string

required

Spotify album ID.

curl "https://drain.lat/api/v1/spotify/album/1ATL5GLyefJaxhQzSPVrLX" \
  -H "x-api-key: YOUR_API_KEY"

string

Album ID.

name

string

Album name.

type

string

Album type (album, single, compilation).

artists

array

List of artists.

releaseDate

string

Release date.

totalTracks

number

Total track count.

coverUrl

string

Album cover URL.

label

string

Record label.

popularity

number

Popularity score (0-100).

tracks

array

Show track object

string

Track ID.

name

string

Track name.

trackNumber

number

Track number on album.

durationMs

number

Duration in milliseconds.

previewUrl

string

30-second preview URL.

explicit

boolean

Whether the track is explicit.

spotifyUrl

string

Link to the track.

Response

{
  "id": "1ATL5GLyefJaxhQzSPVrLX",
  "name": "Scorpion",
  "type": "album",
  "artists": [{ "id": "3TVXtAsR1Inumwj472S9r4", "name": "Drake" }],
  "releaseDate": "2018-06-29",
  "totalTracks": 25,
  "coverUrl": "https://...",
  "label": "Young Money",
  "popularity": 85,
  "tracks": [
    {
      "id": "6DCZcSspjsKoFjzjrWoCdn",
      "name": "God's Plan",
      "trackNumber": 1,
      "durationMs": 198973,
      "previewUrl": "https://...",
      "explicit": true,
      "spotifyUrl": "https://open.spotify.com/track/6DCZcSspjsKoFjzjrWoCdn"
    }
  ],
  "spotifyUrl": "https://open.spotify.com/album/1ATL5GLyefJaxhQzSPVrLX",
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

​Spotify

Spotify