Spotify

Search Spotify shows

Searches Spotify podcast shows for the search term q, paged with offset (default 0) and limit (1 to 50). Each show has its title, URI, publisher, description, images and Spotify URL. Show matches appear under both results and shows. A missing q returns 400.

get/spotify/shows/search

Request

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

Query parameters

qstring required

Search term

offsetinteger

Search offset

limitinteger

Result limit, clamped to 1-50

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.