Spotify

Retrieve Spotify home sections

Returns Spotify home shelves and items. Caller-supplied Spotify bearer or client tokens are not required.

get/spotify/home

Request

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

Query parameters

time_zonestring

IANA time zone used by Spotify home personalization

sp_tstring

Optional Spotify session token. A random UUID is generated when omitted

facetstring

Optional Spotify home facet

section_items_limitinteger

Per-section item limit, clamped to 1-50

include_episode_content_ratings_v2boolean

Include Spotify episode content ratings v2

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": {
    "facet": "music",
    "greeting": "Good afternoon",
    "meta": {
      "appVersion": "1.2.90.403.gf901f20f",
      "fetchedAt": "2026-05-13T20:41:12Z",
      "operationName": "home",
      "sectionCount": 8
    },
    "sections": [
      {
        "items": [
          {
            "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"
          }
        ],
        "subtitle": "Recommended shows",
        "title": "Popular podcasts",
        "totalCount": 20,
        "type": "BrowseGenericSectionData",
        "uri": "spotify:section:0JQ5IMCbQBLqNPkcmYxQPQ"
      }
    ],
    "timeZone": "UTC"
  }
}

Changes

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