Skip to main content
GET
/
api
/
public
/
v2
/
subcategories
curl --location 'https://www.headout.com/api/public/v2/subcategories/?cityCode=<CITY_CODE>&languageCode=<LANGUAGE_CODE>' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "subCategories": [
    {
      "id": "1002",
      "name": "Museums",
      "categoryId": "1",
      "canonicalUrl": "https://www.headout.com/museums-new_york-sc-1002~21553/",
      "localeSpecificUrls": {
        "EN": "/museums-new_york-sc-1002~21553/",
        "ES": "/es/museos-new_york-sc-1002~21553/",
        "FR": "/fr/musees-new_york-sc-1002~21553/",
        "IT": "/it/musei-new_york-sc-1002~21553/",
        "DE": "/de/museen-new_york-sc-1002~21553/",
        "PT": "/pt/museus-new_york-sc-1002~21553/",
        "NL": "/nl/musea-new_york-sc-1002~21553/"
      }
    },
    {
      "id": "1001",
      "name": "Theme Parks",
      "categoryId": "1",
      "canonicalUrl": "https://www.headout.com/theme-parks-new_york-sc-1001~21553/",
      "localeSpecificUrls": {
        "EN": "/theme-parks-new_york-sc-1001~21553/",
        "ES": "/es/parques-tematicos-new_york-sc-1001~21553/",
        "FR": "/fr/parcs-a-theme-new_york-sc-1001~21553/",
        "IT": "/it/parchi-a-tema-new_york-sc-1001~21553/",
        "DE": "/de/freizeitparks-new_york-sc-1001~21553/",
        "PT": "/pt/parques-tematicos-new_york-sc-1001~21553/",
        "NL": "/nl/pretparken-new_york-sc-1001~21553/"
      }
    }
  ]
}
Retrieve subcategories within each main category for a specific city (e.g., “Museums”, “Landmarks”, “Religious Sites” under “Tickets”). Subcategories provide finer-grained filtering options for product discovery and help users navigate to specific experience types. Results are ordered by subcategory rank. Use the returned IDs as subCategoryId in the Products endpoint. 
curl --location 'https://www.headout.com/api/public/v2/subcategories/?cityCode=<CITY_CODE>&languageCode=<LANGUAGE_CODE>' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "subCategories": [
    {
      "id": "1002",
      "name": "Museums",
      "categoryId": "1",
      "canonicalUrl": "https://www.headout.com/museums-new_york-sc-1002~21553/",
      "localeSpecificUrls": {
        "EN": "/museums-new_york-sc-1002~21553/",
        "ES": "/es/museos-new_york-sc-1002~21553/",
        "FR": "/fr/musees-new_york-sc-1002~21553/",
        "IT": "/it/musei-new_york-sc-1002~21553/",
        "DE": "/de/museen-new_york-sc-1002~21553/",
        "PT": "/pt/museus-new_york-sc-1002~21553/",
        "NL": "/nl/musea-new_york-sc-1002~21553/"
      }
    },
    {
      "id": "1001",
      "name": "Theme Parks",
      "categoryId": "1",
      "canonicalUrl": "https://www.headout.com/theme-parks-new_york-sc-1001~21553/",
      "localeSpecificUrls": {
        "EN": "/theme-parks-new_york-sc-1001~21553/",
        "ES": "/es/parques-tematicos-new_york-sc-1001~21553/",
        "FR": "/fr/parcs-a-theme-new_york-sc-1001~21553/",
        "IT": "/it/parchi-a-tema-new_york-sc-1001~21553/",
        "DE": "/de/freizeitparks-new_york-sc-1001~21553/",
        "PT": "/pt/parques-tematicos-new_york-sc-1001~21553/",
        "NL": "/nl/pretparken-new_york-sc-1001~21553/"
      }
    }
  ]
}

Authorizations

​
Headout-Auth
string
header
required

Query Parameters

​
cityCode
string
required

Uppercase city identifier (e.g., NEW_YORK, DUBAI, LONDON). Available city codes are returned by the Cities endpoint.

​
languageCode
enum<string>
default:EN

Language code for localizing response content including product names, descriptions, and URLs. Defaults to English (EN). Content falls back to English when a translation is unavailable. See supported language codes.

Available options:
EN,
ES,
FR,
IT,
DE,
PT,
NL,
PL,
KO,
JA,
ZH_HANS,
ZH_HANT,
AR,
DA,
false,
RO,
RU,
SV,
TR

Response

200 - application/json

Successful response

​
subCategories
object[]

All subcategories available in the requested city.