---
title: "Retrieve Spotify genre page"
method: GET
path: "/spotify/genre"
tags: ["Spotify"]
---

# Retrieve Spotify genre page

`GET /spotify/genre`

## Request

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

Returns the sections of a Spotify genre or browse page for `uri` (default `spotify:page:0JQ5DAB3zgCauRwnvdEQjJ`). Each section has a title, type, `totalCount` and items with title, subtitle, image and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; matching offsets default to 0.

## Query parameters

- `uri` string
- `page_offset` integer
- `page_limit` integer
- `section_offset` integer
- `section_limit` integer
- `include_episode_content_ratings_v2` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyBrowsePageResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyBrowsePageResponse
    - `meta` SpotifyBrowsePageMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `fetchedAt` string: Time the data was fetched, in UTC (RFC 3339).
      - `operationName` string: Name of the Spotify web player operation that returned the data.
      - `sectionCount` integer: Number of sections returned.
    - `sections` SpotifyBrowsePageSection[]: Sections of the page, in display order.
      - `items` SpotifyBrowsePageItem[]: Items returned for this section.
        - `description` string: Description text of the item.
        - `externalUrl` string: Link to the item on open.spotify.com.
        - `imageUrl` string: URL of the main image for the item.
        - `images` SpotifyImageAsset[]: Images available for the item, with their sizes.
          - `height` integer: Image height in pixels.
          - `url` string: URL of the image.
          - `width` integer: Image width in pixels.
        - `publisher` string: Publisher or creator name of the item.
        - `subtitle` string: Secondary line shown under the item title, such as the creator name.
        - `title` string: Item title as Spotify shows it.
        - `type` string: Kind of item as Spotify labels it, for example `Podcast`.
        - `uri` string: Spotify URI of the item.
      - `subtitle` string: Secondary line shown under the section heading.
      - `title` string: Section heading as Spotify shows it.
      - `totalCount` integer: Total number of items in the section on Spotify.
      - `type` string: Kind of section as Spotify labels it.
      - `uri` string: Spotify URI of the section.
    - `subtitle` string: Secondary line shown under the page title.
    - `title` string: Page title as Spotify shows it.
    - `type` string: Kind of page container as Spotify labels it.
    - `uri` string: Spotify URI of the page that was loaded.
  - `msg` unknown

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `503`: Spotify upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)