Getting started

This GetYourGuide Partner API provides access to GetYourGuide’s marketplace for tours and activities. It has a RESTful interface and uses the JSON media format. Access is secured via SSL and an API access token.

Connecting to the API

The base URL for accessing version 1 of the API is: https://api.getyourguide.com/1/. Configuration information, such as compatibility with the current client, can be accessed at: https://api.getyourguide.com/configuration/1.

Two headers are required to be passed with each request:

Headers	Description
X-ACCESS-TOKEN	An API access token used for authentication, provided by GetYourGuide.
Accept	The media type which are acceptable for the response. Set to application/json

Because the API is stateless, each API GET request should at least include the following two query parameters:

Parameters	Description
cnt_language	Definition of the content language as a two letter language code (ISO 639-1 specification). Available are: da, de, en, es, fr, it, nl, no, pl, pt, fi, sv, ru, ja
currency	Definition of the currency used for pricing as a three letter currency code (ISO 4217 specification). Available are: AED, ARS, AUD, BGN, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, HRK, HUF, IDR, ILS, INR, JPY, KRW, MAD, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, UAH, USD, UYU, VND, ZAR

<style> table { border-collapse: collapse; width: 100%; } th { background-color: #f2f2f2; font-weight: bold; text-align: left; } th, td { border: 1px solid #ddd; padding: 8px; } tr:nth-child(even) { background-color: #f9f9f9; } </style> Language Code | Locale Code -- | -- da | da-DK de | de-DE en | en-US es | es-ES fr | fr-FR it | it-IT nl | nl-NL no | no-NO pl | pl-PL pt | pt-PT fi | fi-FI sv | sv-SE ru | ru-RU ja | ja-JP ko | ko-KR ar | ar-EG xx | en-GB tw | zh-TW

Using curl, a valid GET request is:

curl -H "Accept: application/json" -H "X-ACCESS-TOKEN: [YOUR TOKEN]" -X GET "https://api.getyourguide.com/1/tours/62484?cnt_language=en&currency=USD"

Request Limitation

The default rate limit is 130 calls per minute. Once the rate limit is reached, all subsequent calls will be blocked for 5 minutes. GetYourGuide also monitors API traffic and warns about excessive usage in relation to bookings being made. We encourage to access the API in real-time; please do not scrape the API in an attempt to cache its output.