GET
/spotify/albumapiKey3 credits/requestRetrieve Spotify album details
Returns normalized Spotify Web Player album metadata and tracks from private Pathfinder responses.
Required params: None
API Reference
Use Crawlora's Spotify API endpoints to extract supported public Spotify data as structured JSON. This documentation covers 30 active endpoints including Retrieve Spotify album details, Retrieve Spotify album tracks, Search Spotify albums, Retrieve Spotify artist details, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and AI-agent workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as q, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/spotify/album?uri=spotify%3Aalbum%3A4aawyAB9vmqN3uQ7FjRGTy&id=4aawyAB9vmqN3uQ7FjRGTy&offset=0&limit=50" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/spotify/albumapiKey3 credits/requestReturns normalized Spotify Web Player album metadata and tracks from private Pathfinder responses.
Required params: None
/spotify/album/tracksapiKey3 credits/requestReturns normalized Spotify Web Player album tracks from private Pathfinder responses.
Required params: None
/spotify/albums/searchapiKey3 credits/requestReturns normalized Spotify Web Player album search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: q:query
/spotify/artistapiKey3 credits/requestReturns normalized Spotify Web Player artist overview data from private Pathfinder responses.
Required params: None
/spotify/artist/albumsapiKey3 credits/requestReturns artist discography items from Spotify Web Player private Pathfinder responses.
Required params: None
/spotify/artist/playlistsapiKey3 credits/requestReturns artist playlists from Spotify Web Player private Pathfinder responses.
Required params: None
/spotify/artist/relatedapiKey3 credits/requestReturns related artists from Spotify Web Player private Pathfinder responses.
Required params: None
/spotify/artists/searchapiKey3 credits/requestReturns normalized Spotify Web Player artist search results for a search term.
Required params: q:query
/spotify/audiobookapiKey3 credits/requestReturns Spotify Web Player audiobook metadata from private Pathfinder responses. Spotify exposes audiobooks through show URIs.
Required params: None
/spotify/audiobook/chaptersapiKey3 credits/requestReturns audiobook chapters from Spotify Web Player private Pathfinder responses.
Required params: None
/spotify/audiobooks/searchapiKey3 credits/requestReturns normalized Spotify Web Player audiobook search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: q:query
/spotify/chapterapiKey2 credits/requestReturns a Spotify chapter from the same private Pathfinder operation used for episodes and chapters.
Required params: None
/spotify/episodes/searchapiKey3 credits/requestReturns normalized Spotify Web Player episode search results for a search term.
Required params: q:query
/spotify/featured-charts-by-countryapiKey3 credits/requestReturns normalized Spotify country hub content from Spotify's countryHubContent Pathfinder response. Defaults to the CHARTS content shelf for the requested country.
Required params: None
/spotify/genreapiKey3 credits/requestReturns normalized sections and items from Spotify's browsePage Pathfinder response for a Spotify genre or page URI.
Required params: None
/spotify/homeapiKey3 credits/requestReturns normalized shelves and items from Spotify's Web Player home Pathfinder response. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: None
/spotify/playlistapiKey3 credits/requestReturns normalized Spotify Web Player playlist metadata and items from Spotify's fetchPlaylist Pathfinder response. Provide either uri or id; defaults to a known public playlist when omitted.
Required params: None
/spotify/playlists/searchapiKey3 credits/requestReturns normalized Spotify Web Player playlist search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: q:query
/spotify/popular-by-countryapiKey3 credits/requestReturns normalized Spotify country hub shelves from Spotify's countryHubsPage Pathfinder response. The country_code parameter accepts Spotify popular-in country codes from open.spotify.com/popular-in/us.
Required params: None
/spotify/profileapiKey3 credits/requestReturns normalized public profile metadata and preview playlists from Spotify's Web Player user-profile service. Provide username, uri, or url; defaults to Spotify's official profile.
Required params: None
/spotify/profile/followersapiKey3 credits/requestReturns normalized public follower profiles from Spotify's Web Player user-profile service. Spotify exposes this as a public anonymous response for some profiles; private or restricted profiles may return an upstream error.
Required params: None
/spotify/profile/playlistsapiKey3 credits/requestReturns normalized public playlists from Spotify's Web Player user-profile service. Provide username, uri, or url; defaults to Spotify's official profile.
Required params: None
/spotify/profiles/searchapiKey3 credits/requestReturns normalized Spotify Web Player profile search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: q:query
/spotify/searchapiKey3 credits/requestReturns normalized Spotify Web Player catalog search results across tracks, artists, albums, playlists, shows, episodes, audiobooks, and top results. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: q:query
/spotify/sectionapiKey3 credits/requestReturns normalized items from Spotify's browseSection Pathfinder response for a Spotify section URI.
Required params: None
/spotify/shows/searchapiKey3 credits/requestReturns normalized Spotify Web Player show search results for a search term.
Required params: q:query
/spotify/trackapiKey2 credits/requestReturns normalized Spotify Web Player track metadata from Spotify's getTrack Pathfinder response. Provide either uri or id; defaults to a known public track when omitted.
Required params: None
/spotify/track/recommendedapiKey2 credits/requestReturns normalized recommended Spotify entities from the internalLinkRecommenderTrack Pathfinder response.
Required params: None
/spotify/track/similar-albumsapiKey3 credits/requestReturns normalized albums from the similarAlbumsBasedOnThisTrack Pathfinder response.
Required params: None
/spotify/tracks/searchapiKey3 credits/requestReturns normalized Spotify Web Player track search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.
Required params: q:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Retrieve Spotify album details | /spotify/album | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify album tracks | /spotify/album/tracks | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify albums | /spotify/albums/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify artist details | /spotify/artist | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify artist albums | /spotify/artist/albums | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify artist playlists | /spotify/artist/playlists | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify related artists | /spotify/artist/related | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify artists | /spotify/artists/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify audiobook details | /spotify/audiobook | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify audiobook chapters | /spotify/audiobook/chapters | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify audiobooks | /spotify/audiobooks/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify audiobook chapter details | /spotify/chapter | GET | 2 credits/request | None | View docs | Try endpoint |
| Search Spotify episodes | /spotify/episodes/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify featured charts by country | /spotify/featured-charts-by-country | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify genre page | /spotify/genre | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify home sections | /spotify/home | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify playlist details | /spotify/playlist | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify playlists | /spotify/playlists/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify popular by country | /spotify/popular-by-country | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify public profile | /spotify/profile | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify public profile followers | /spotify/profile/followers | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify public profile playlists | /spotify/profile/playlists | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify profiles | /spotify/profiles/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Search Spotify catalog | /spotify/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify browse section | /spotify/section | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify shows | /spotify/shows/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify track details | /spotify/track | GET | 2 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify recommended tracks | /spotify/track/recommended | GET | 2 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify track similar albums | /spotify/track/similar-albums | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify tracks | /spotify/tracks/search | GET | 3 credits/request | q:query | View docs | Try endpoint |