Skip to content
API REFERENCES/Beta/
/
Attraction constants

Attraction constants

Request

Returns localised attraction constants, including category and subcategory metadata.

  • Use this endpoint to retrieve and cache the category ID-to-name mapping before performing attraction searches with category filters.
  • Call this endpoint during initial integration or periodically to refresh cached values.
  • To retrieve all constants, send an empty request body.
Security
BearerAuth
Headers
X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json
languagesArray of strings, <= 50 items

List of language codes used to localise category names. Each category name is returned as an object keyed by language code.

  • If a requested language is not available, it may be omitted from the response.
  • If not provided, en-gb is used by default.
Default:["en-gb"]
Example:
[
  "es"
]
curl -i -X POST \
  https://demandapi.booking.com/3.2/attractions/constants \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "languages": [
      "en-gb"
    ]
  }'

Responses

Successful response. Returns localised attraction category constants.

Bodyapplication/json
request_idstring(requestId)

Uniquely identifies the request. Please provide this identifier when contacting support.

dataobject
Response
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": {
    "categories": [ … ]
  }
}