Scraperize
Spotify

Spotify Search API

To get spotify search results of every kind, call GET /v1/spotify/search?query=… with your API key. You get clean JSON back.

GET/v1/spotify/search
curl "https://api.scraperize.com/v1/spotify/search?query=odesza" \
  -H "x-api-key: YOUR_API_KEY"
Cost
1 credit / call
Only successful calls are charged. Errors are free.
Pagination
Single response
Everything comes back in one call.
Caching
0 credits
Set cache_max_age to reuse a recent result for free.
Rate limit
Per team / minute
Over the limit: 429 with a Retry-After header.

Parameters

queryRequired
What to search for.
cache_max_ageOptional
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.

Send your key in the x-api-key header. Full API reference

Example response

200 OK · application/json
{
  "data": {
    "query": "odesza",
    "count": 80,
    "topResults": [
      {
        "type": "artist",
        "item": {
          "id": "21mKp7DqtSNHhCAU2ugvUw",
          "name": "ODESZA",
          "url": "https://open.spotify.com/artist/21mKp7DqtSNHhCAU2ugvUw",
          "avatar": "https://i.scdn.co/image/ab6761610000e5eb9f4a0cbfcc9b274344681ccb",
          "verified": true
        }
      }
    ],
    "featuredPlaylists": [
      {
        "id": "37i9dQZF1DZ06evO18Xuco",
        "name": "This Is ODESZA",
        "url": "https://open.spotify.com/playlist/37i9dQZF1DZ06evO18Xuco",
        "description": "This is ODESZA. The essential tracks, all in one playlist.",
        "image": "https://pickasso.spotifycdn.com/image/ab67c0de0000deef/dt/v1/img/thisisv3/21mKp7DqtSNHhCAU2ugvUw/en",
        "owner": {
          "id": "spotify",
          "name": "Spotify",
          "url": "https://open.spotify.com/user/spotify",
          "avatar": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5"
        }
      }
    ],
    "tracks": [
      {
        "id": "59wlTaYOL5tDUgXnbBQ3my",
        "name": "A Moment Apart",
        "url": "https://open.spotify.com/track/59wlTaYOL5tDUgXnbBQ3my",
        "durationMs": 234244,
        "explicit": false,
        "playCount": null,
        "trackNumber": null,
        "discNumber": null,
        "playable": true,
        "mediaType": "AUDIO",
        "videoCount": 0,
        "artists": [
          {
            "id": "21mKp7DqtSNHhCAU2ugvUw",
            "name": "ODESZA",
            "url": "https://open.spotify.com/artist/21mKp7DqtSNHhCAU2ugvUw"
          }
        ],
        "album": {
          "id": "3VzsvmhnUb9OZ59bq2aoNZ",
          "name": "A Moment Apart",
          "url": "https://open.spotify.com/album/3VzsvmhnUb9OZ59bq2aoNZ",
          "image": "https://i.scdn.co/image/ab67616d0000b27345951a69fe39a6e163122eab",
          "releaseDate": null
        }
      }
    ],
    "artists": [
      {
        "id": "21mKp7DqtSNHhCAU2ugvUw",
        "name": "ODESZA",
        "url": "https://open.spotify.com/artist/21mKp7DqtSNHhCAU2ugvUw",
        "avatar": "https://i.scdn.co/image/ab6761610000e5eb9f4a0cbfcc9b274344681ccb",
        "verified": true
      }
    ],
    "albums": [
      {
        "id": "3VzsvmhnUb9OZ59bq2aoNZ",
        "name": "A Moment Apart",
        "url": "https://open.spotify.com/album/3VzsvmhnUb9OZ59bq2aoNZ",
        "type": "ALBUM",
        "releaseDate": "2017",
        "image": "https://i.scdn.co/image/ab67616d0000b27345951a69fe39a6e163122eab",
        "label": null,
        "trackCount": null,
        "playable": true,
        "copyrights": [],
        "artists": [
          {
            "id": "21mKp7DqtSNHhCAU2ugvUw",
            "name": "ODESZA",
            "url": "https://open.spotify.com/artist/21mKp7DqtSNHhCAU2ugvUw"
          }
        ]
      }
    ],
    "playlists": [
      {
        "id": "0UAJpPr27QrO01Xd4FC0Fo",
        "name": "chill Odesza vibes",
        "url": "https://open.spotify.com/playlist/0UAJpPr27QrO01Xd4FC0Fo",
        "description": null,
        "image": "https://mosaic.scdn.co/640/ab67616d00001e024d44b7f4fc30e8522d411bbeab67616d00001e0277077d99bb417d23d2f58afaab67616d00001…",
        "owner": {
          "id": "124206315",
          "name": "Michelle Vasquez",
          "url": "https://open.spotify.com/user/124206315",
          "avatar": "https://scontent-ams4-1.xx.fbcdn.net/v/t39.30808-1/795643987_28237657199230085_934977313494575863_n.jpg?stp=dst-jpg_s320…"
        }
      }
    ],
    "podcasts": [
      {
        "id": "3ovLDuweicQzEVHSq3g2fJ",
        "name": "The Ico - An Odesza / Foreign Family Fan Podcast",
        "url": "https://open.spotify.com/show/3ovLDuweicQzEVHSq3g2fJ",
        "publisher": "The Ico",
        "image": "https://i.scdn.co/image/ab6765630000ba8ac30c89fbd7251adebdf0359f",
        "mediaType": "AUDIO",
        "topics": [
          "Music"
        ]
      }
    ],
    "episodes": [
      {
        "id": "2aObeMVgRwtnVZkEa2pt9n",
        "name": "ODESZA - Kusanagi",
        "url": "https://open.spotify.com/episode/2aObeMVgRwtnVZkEa2pt9n",
        "description": "In September 2014, Odesza put out their album In Return. It debuted at #1 on Billboard's Dance/Electronic charts, and sp…",
        "htmlDescription": null,
        "durationMs": 833215,
        "releaseDate": "2016-06-14T07:52:00.000Z",
        "explicit": false,
        "mediaTypes": [
          "AUDIO"
        ],
        "type": null,
        "image": "https://i.scdn.co/image/ab6765630000ba8ad10df910a507806f8c559542",
        "playable": true,
        "paywalled": false,
        "previewUrl": null,
        "audioUrls": [],
        "podcast": {
          "id": "10lMwCjvzLCLwth2AW6cLG",
          "name": "Song Exploder",
          "url": "https://open.spotify.com/show/10lMwCjvzLCLwth2AW6cLG",
          "publisher": "Hrishikesh Hirway",
          "image": "https://i.scdn.co/image/ab6765630000ba8ad10df910a507806f8c559542"
        }
      }
    ],
    "audiobooks": [
      {
        "id": "2axRa6zv8qNihUgWOuTB4Y",
        "name": "Vertrau mir besser nicht",
        "url": "https://open.spotify.com/show/2axRa6zv8qNihUgWOuTB4Y",
        "authors": [
          "D. C. Odesza"
        ],
        "description": "Author(s): D. C. Odesza\nNarrator(s): Kai Schulz, Charlie Wiesemann, Richard Lingscheidt, Martin Kautz\n\nGefangen. Verlore…",
        "durationMs": 20528318,
        "publishDate": "2023-09-22T00:00:00.000Z",
        "image": "https://i.scdn.co/image/ab676663000022a800f7c92d40caefb12bfbc7ae"
      }
    ],
    "users": [
      {
        "id": "odesza",
        "name": "ODESZA",
        "url": "https://open.spotify.com/user/odesza",
        "avatar": null
      }
    ],
    "genres": [
      {
        "id": "0JQ5IMCbQBLsj7adK4X6VP",
        "name": "Sounds of Nigeria",
        "url": "https://open.spotify.com/genre/0JQ5IMCbQBLsj7adK4X6VP",
        "image": "https://t.scdn.co/images/728ed47fc1674feb95f7ac20236eb6d7.jpeg"
      }
    ],
    "totals": {
      "tracks": 21,
      "artists": 22,
      "albums": 18,
      "playlists": 21,
      "podcasts": 15,
      "episodes": 20,
      "audiobooks": 20,
      "users": 1,
      "genres": 10
    },
    "fetchedAt": "2026-11-16T13:05:38.808Z"
  },
  "meta": {
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
    "creditsCharged": 1,
    "creditsRemaining": 4999,
    "cached": false
  }
}

A real response, shortened to one item per list.

FAQ

Spotify Search API questions

How much does the Spotify Search API cost?

1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.

Do I need a Spotify account or API key?

No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Spotify login or developer app is needed.

How fresh is the data?

Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.

Where are the full parameters and response fields?

In the API reference, with every parameter, field and error.

Try the Spotify Search API

Grab your key and 100 free credits, no card required, and run this call in minutes.