Spotify

Search Spotify catalog

Returns Spotify catalog search results across tracks, artists, albums, playlists, shows, episodes, audiobooks, and top results. Caller-supplied Spotify bearer or client tokens are not required.

get/spotify/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/spotify/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Search term

offsetinteger

Search offset

limitinteger

Result limit per section, clamped to 1-50

number_of_top_resultsinteger

Top result limit, clamped to 1-50

include_audiobooksboolean

Include audiobook results

include_artist_has_concerts_fieldboolean

Include artist concert availability fields

include_pre_releasesboolean

Include pre-release results

include_album_pre_releasesboolean

Include album pre-release results

include_authorsboolean

Include authors

include_episode_content_ratings_v2boolean

Include Spotify episode content ratings v2

is_prefixboolean

Treat the search term as a prefix

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "albums": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "artists": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "audiobooks": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "episodes": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "limit": 20,
    "meta": {
      "albumCount": 3,
      "appVersion": "1.2.90.403.gf901f20f",
      "artistCount": 5,
      "audiobookCount": 2,
      "episodeCount": 2,
      "fetchedAt": "2026-05-13T20:41:12Z",
      "operationName": "searchDesktop",
      "playlistCount": 2,
      "resultCount": 22,
      "showCount": 4,
      "topCount": 3,
      "trackCount": 2,
      "userCount": 2
    },
    "playlists": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "results": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "searchTerm": "hello",
    "shows": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "topResults": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "tracks": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "users": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "images": [
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0",
            "width": 640
          }
        ],
        "publisher": "Joe Rogan",
        "subtitle": "Joe Rogan",
        "title": "The Joe Rogan Experience",
        "type": "Podcast",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.