Crawlora
Open navigation
Sign inTry Playground Console
Docs menu

Spotify API endpoint

Search Spotify artists

Returns normalized Spotify Web Player artist search results for a search term.

GETapiKey3 credits/requestSpotifyspotify.searchCatalogResponseDoc/spotify/artists/search

Overview

Returns normalized Spotify Web Player artist search results for a search term.

View Spotify platform pageOpen in PlaygroundCopy language examples

Request schema

NameInTypeRequiredEnumExampleDescription
qquerystringYeshelloSearch term
offsetqueryintegerNo0Search offset
limitqueryintegerNo20Result limit, clamped to 1-50
x-api-keyheaderstringYesAPI key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost
3 credits/request
Charged response
Successful 2xx responses
PlanPriceIncluded creditsDaily capRate limitOverage
Free$0/mo2,000500 daily credits5/minNo overage
Starter$9/mo20,0005,000 daily credits15/min$0.75/1,000 overage credits when enabled
Growth$29/mo100,00025,000 daily credits45/min$0.45/1,000 overage credits when enabled
Pro$79/mo400,000No daily cap120/min$0.30/1,000 overage credits
Business$199/mo1,200,000No daily cap300/min$0.20/1,000 overage credits
Enterprise$499/mo5,000,000No daily cap1,000/min$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

  • Proxy strategy: managed automatically where needed
  • Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
  • Browser cluster: supported dynamic workloads can be routed through distributed browser instances
  • Retry behavior: automatic retry/fallback may be used depending on endpoint type
  • Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
  • Billing: credits are charged only for successful 2xx responses
  • Observability: responses include request context where available

Response behavior

The endpoint returns artist results in both `results` and `artists` for caller convenience. Missing `q` returns `400`; upstream private API failures return `502`.

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

StatusCommon failure case
400Invalid input or missing required parameter
429Plan or endpoint rate limit exceeded
500Internal execution error
502Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

StatusDescriptionSchema
400Bad Request#/definitions/app.Response
429Too Many Requests#/definitions/app.Response
502Bad Gateway#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "searchTerm": "hello",
    "results": [
      {
        "uri": "spotify:artist:example",
        "title": "Example Artist"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/spotify.searchCatalogResponseDoc

FieldTypeRequiredEnumBoundsExampleDescription
codeintegerNoCode is the HTTP status code or a custom code used to indicate the result of the request @example 200
dataspotify.SearchResponseNo
data.albumsarrayNo
data.albums[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.albums[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.albums[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.albums[].imagesarrayNo
data.albums[].images[].heightintegerNo640
data.albums[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.albums[].images[].widthintegerNo640
data.albums[].publisherstringNoJoe Rogan
data.albums[].subtitlestringNoJoe Rogan
data.albums[].titlestringNoThe Joe Rogan Experience
data.albums[].typestringNoPodcast
data.albums[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.artistsarrayNo
data.artists[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.artists[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.artists[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.artists[].imagesarrayNo
data.artists[].images[].heightintegerNo640
data.artists[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.artists[].images[].widthintegerNo640
data.artists[].publisherstringNoJoe Rogan
data.artists[].subtitlestringNoJoe Rogan
data.artists[].titlestringNoThe Joe Rogan Experience
data.artists[].typestringNoPodcast
data.artists[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.audiobooksarrayNo
data.audiobooks[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.audiobooks[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.audiobooks[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.audiobooks[].imagesarrayNo
data.audiobooks[].images[].heightintegerNo640
data.audiobooks[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.audiobooks[].images[].widthintegerNo640
data.audiobooks[].publisherstringNoJoe Rogan
data.audiobooks[].subtitlestringNoJoe Rogan
data.audiobooks[].titlestringNoThe Joe Rogan Experience
data.audiobooks[].typestringNoPodcast
data.audiobooks[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.episodesarrayNo
data.episodes[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.episodes[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.episodes[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.episodes[].imagesarrayNo
data.episodes[].images[].heightintegerNo640
data.episodes[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.episodes[].images[].widthintegerNo640
data.episodes[].publisherstringNoJoe Rogan
data.episodes[].subtitlestringNoJoe Rogan
data.episodes[].titlestringNoThe Joe Rogan Experience
data.episodes[].typestringNoPodcast
data.episodes[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.limitintegerNo20
data.metaspotify.SearchMetaNo
data.meta.albumCountintegerNo3
data.meta.appVersionstringNo1.2.90.403.gf901f20f
data.meta.artistCountintegerNo5
data.meta.audiobookCountintegerNo2
data.meta.episodeCountintegerNo2
data.meta.fetchedAtstringNo2026-05-13T20:41:12Z
data.meta.operationNamestringNosearchDesktop
data.meta.playlistCountintegerNo2
data.meta.resultCountintegerNo22
data.meta.showCountintegerNo4
data.meta.topCountintegerNo3
data.meta.trackCountintegerNo2
data.meta.userCountintegerNo2
data.offsetintegerNo0
data.playlistsarrayNo
data.playlists[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.playlists[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.playlists[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.playlists[].imagesarrayNo
data.playlists[].images[].heightintegerNo640
data.playlists[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.playlists[].images[].widthintegerNo640
data.playlists[].publisherstringNoJoe Rogan
data.playlists[].subtitlestringNoJoe Rogan
data.playlists[].titlestringNoThe Joe Rogan Experience
data.playlists[].typestringNoPodcast
data.playlists[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.resultsarrayNo
data.results[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.results[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.results[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.results[].imagesarrayNo
data.results[].images[].heightintegerNo640
data.results[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.results[].images[].widthintegerNo640
data.results[].publisherstringNoJoe Rogan
data.results[].subtitlestringNoJoe Rogan
data.results[].titlestringNoThe Joe Rogan Experience
data.results[].typestringNoPodcast
data.results[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.searchTermstringNohello
data.showsarrayNo
data.shows[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.shows[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.shows[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.shows[].imagesarrayNo
data.shows[].images[].heightintegerNo640
data.shows[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.shows[].images[].widthintegerNo640
data.shows[].publisherstringNoJoe Rogan
data.shows[].subtitlestringNoJoe Rogan
data.shows[].titlestringNoThe Joe Rogan Experience
data.shows[].typestringNoPodcast
data.shows[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.topResultsarrayNo
data.topResults[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.topResults[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.topResults[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.topResults[].imagesarrayNo
data.topResults[].images[].heightintegerNo640
data.topResults[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.topResults[].images[].widthintegerNo640
data.topResults[].publisherstringNoJoe Rogan
data.topResults[].subtitlestringNoJoe Rogan
data.topResults[].titlestringNoThe Joe Rogan Experience
data.topResults[].typestringNoPodcast
data.topResults[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.tracksarrayNo
data.tracks[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.tracks[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.tracks[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.tracks[].imagesarrayNo
data.tracks[].images[].heightintegerNo640
data.tracks[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.tracks[].images[].widthintegerNo640
data.tracks[].publisherstringNoJoe Rogan
data.tracks[].subtitlestringNoJoe Rogan
data.tracks[].titlestringNoThe Joe Rogan Experience
data.tracks[].typestringNoPodcast
data.tracks[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.usersarrayNo
data.users[].descriptionstringNoThe official podcast of comedian Joe Rogan.
data.users[].externalUrlstringNohttps://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.users[].imageUrlstringNohttps://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.users[].imagesarrayNo
data.users[].images[].heightintegerNo640
data.users[].images[].urlstringNohttps://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0
data.users[].images[].widthintegerNo640
data.users[].publisherstringNoJoe Rogan
data.users[].subtitlestringNoJoe Rogan
data.users[].titlestringNoThe Joe Rogan Experience
data.users[].typestringNoPodcast
data.users[].uristringNospotify:show:4rOoJ6Egrf8K2IrywzwOMk
msgunknownNoMsg is the message that describes the result of the request @example "Request successful"

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/spotify/artists/search?q=hello&offset=0&limit=20" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

Related

More Spotify endpointsSpotify platformPricingPlayground
Open in PlaygroundBack to group