---
title: "GET /browse/categories"
method: GET
path: "/browse/categories"
---

# GET /browse/categories

`GET /browse/categories`

[Get a List of Browse Categories](https://developer.spotify.com/web-api/get-list-categories/)

## Query parameters

- `limit` integer
- `offset` integer
- `country` string
- `locale` string

## Headers

- `Accept` string

## Response `200`

OK

- CategoryPage
  - `href` string — A link to the Web API endpoint returning the full result of the request.
  - `items` Category[] — The requested data.
    - `href` string — A link to the Web API endpoint returning full details of the category.
    - `icons` Image[]
      - `height` integer — The image height in pixels. If unknown: null or not returned.
      - `url` string — The source URL of the image.
      - `width` integer — The image width in pixels. If unknown: null or not returned.
    - `id` string — The Spotify category ID of the category.
    - `name` string — The name of the category.
  - `limit` integer — The maximum number of items in the response (as set in the query or by default).
  - `next` string — URL to the next page of items. (null if none)
  - `offset` integer — The offset of the items returned (as set in the query or by default).
  - `previous` string — URL to the previous page of items. (null if none)
  - `total` integer — The total number of items available to return.

## Other responses

- `429` — API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

---

[API](https://skmtc.net/isa-group/apis/spotify.md) · [All operations](https://skmtc.net/isa-group/apis/spotify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isa-group/spotify/versions/acd86d5cc241/schema)