Skip to main content
GET
/
api
/
public
/
v2
/
subcategories
cURL
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). Use the Cities API to retrieve all available city codes.

​
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,
NO,
RO,
RU,
SV,
TR

Response

200 - application/json

Successful response

​
subCategories
object[]

All subcategories available in the requested city.