Get Spotify artist and search data

Find the id

Spotify has no handles. Artist, album and track routes take a 22 character id or an open.spotify.com url. If you only have a name, search first.

GET /v1/spotify/search

requires query. keyword and q are aliases. type is track, album, artist, playlist, show, episode or audiobook. Without type, every kind comes back, 10 of each. With type, you get 20 of that kind. type=show is how you find podcast ids. Episodes come back as songs with extra.type set to episode. Audiobooks come back as collections.

cursor

pages. region is accepted and does not change the results. The reference says results follow the country of the server's IP.

The recorded search is a name, with no type, so the sample mixes kinds. The first items in that recording are tracks (a song: title, artists, album, duration_seconds, stats.plays). An artist hit is a profile. Read object on each item before you assume a shape.

1curl -G "https://api.socialscrape.dev/v1/spotify/search" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "query=taylor swift"

1import os2import requests34params = {5    "query": "taylor swift",6}7res = requests.get(8    "https://api.socialscrape.dev/v1/spotify/search",9    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10    params=params,11)12body = res.json()1314if body["ok"]:15    print(body["data"])16else:17    print(body["error"]["code"], body["error"]["message"])

1const url = new URL("https://api.socialscrape.dev/v1/spotify/search");2url.search = new URLSearchParams({3  "query": "taylor swift"4}).toString();5const res = await fetch(url, {6  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11  console.log(body.data);12} else {13  console.error(body.error.code, body.error.message);14}

A track row's id is what you pass to the track endpoint. An artist row's id is what you pass to the artist endpoint.

The artist

GET /v1/spotify/artist takes url or id. One of them. The description lists followers, monthly listeners, world rank, top cities, bio, links, top tracks, albums, singles, related artists and playlists. Most of that lives in extra, because it does not fit the shared profile.

The recorded request uses an artist id.

1curl -G "https://api.socialscrape.dev/v1/spotify/artist" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "id=06HL4z0CvFAxyc27GXpf02"

1import os2import requests34params = {5    "id": "06HL4z0CvFAxyc27GXpf02",6}7res = requests.get(8    "https://api.socialscrape.dev/v1/spotify/artist",9    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10    params=params,11)12body = res.json()1314if body["ok"]:15    print(body["data"])16else:17    print(body["error"]["code"], body["error"]["message"])

1const url = new URL("https://api.socialscrape.dev/v1/spotify/artist");2url.search = new URLSearchParams({3  "id": "06HL4z0CvFAxyc27GXpf02"4}).toString();5const res = await fetch(url, {6  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11  console.log(body.data);12} else {13  console.error(body.error.code, body.error.message);14}

data.platform is spotify. name, bio, avatar_url, url, verified and external_url are the profile fields. stats.followers is the follower count. stats.following, stats.posts, stats.likes and stats.views are null when they do not apply.

Monthly listeners are not stats.followers. They are extra.monthly_listeners, a number. extra.world_rank is the rank. extra.top_cities entries have city, country, region and listeners.

extra.top_tracks entries have id, title, artists, url, duration_seconds, explicit and plays.

Also in extra on the recorded artist: albums, singles, compilations, appears_on, popular_releases, latest_release, related_artists, artist_playlists, discovered_on_playlists, featuring_playlists, uri, release_counts, concerts_count and playlists_count.

Album entries include id, title, url, release_date and track_count. Use the album id with GET /v1/spotify/album when you need the track list (up to 200 tracks, plus label and copyright).

Errors are invalid_params, unsupported_url and not_found.

A track

GET /v1/spotify/track takes url or id. The description says title, artists, album, duration, lifetime play count and the 30 second preview URL. In the payload that is title, artists, album, duration_seconds, stats.plays and preview_url.

isrc, explicit, cover_url and released_at are on the song too. extra includes uri, track_number, album_id and playable.

The recorded track request is an id. A successful call is 1 credit, same as the artist and the search page.