Skip to content
DocumentationAPI Reference

Get Single Browse Category

client.Browse.Categories.Get(ctx, categoryID, query) (*BrowseCategoryGetResponse, error)
GET/browse/categories/{category_id}

Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).

ParametersExpand Collapse
categoryID string

The Spotify category ID for the category.

query BrowseCategoryGetParams
Locale param.Field[string]optional

The desired language, consisting of an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)". Provide this parameter if you want the category strings returned in a particular language.
Note: if locale is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English).

ReturnsExpand Collapse
type BrowseCategoryGetResponse struct{…}
ID string

The Spotify category ID of the category.

Href string

A link to the Web API endpoint returning full details of the category.

Icons []ImageObject

The category icon, in various sizes.

Height int64

The image height in pixels.

URL string

The source URL of the image.

Width int64

The image width in pixels.

Published booloptional

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Name string

The name of the category.

Published booloptional

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Get Single Browse Category

package main

import (
  "context"
  "fmt"

  "github.com/cjavdev/spotted-go"
  "github.com/cjavdev/spotted-go/option"
)

func main() {
  client := spotted.NewClient(
    option.WithAccessToken("My Access Token"),
  )
  category, err := client.Browse.Categories.Get(
    context.TODO(),
    "dinner",
    spotted.BrowseCategoryGetParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", category.ID)
}
{
  "id": "equal",
  "href": "href",
  "icons": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "name": "EQUAL",
  "published": true
}
Returns Examples
{
  "id": "equal",
  "href": "href",
  "icons": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "name": "EQUAL",
  "published": true
}