Spotify

Search Spotify episodes

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

get/spotify/episodes/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/spotify/episodes/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.