-
Notifications
You must be signed in to change notification settings - Fork 3
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.
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:
| URL Query Parameter | Explanation |
|---|---|
| currency | The currencies in which prices should be displayed. |
| cnt_language | The language in which content should be displayed. |
| Currency Code (currency) | Currency Name | Symbol |
|---|---|---|
| AED | United Arab Emirates Dirham | د.إ |
| ARS | Argentine Peso | $ |
| AUD | Australian Dollar | $ |
| BGN | Bulgarian Lev | лв |
| CAD | Canadian Dollar | $ |
| CHF | Swiss Franc | CHF |
| CLP | Chilean Peso | $ |
| CNY | Chinese Yuan | ¥ |
| COP | Colombian Peso | $ |
| CZK | Czech Koruna | Kč |
| DKK | Danish Krone | kr |
| EGP | Egyptian Pound | £ |
| EUR | Euro | € |
| GBP | British Pound Sterling | £ |
| HKD | Hong Kong Dollar | $ |
| HRK | Croatian Kuna | kn |
| HUF | Hungarian Forint | Ft |
| IDR | Indonesian Rupiah | Rp |
| ILS | Israeli New Shekel | ₪ |
| INR | Indian Rupee | ₹ |
| JPY | Japanese Yen | ¥ |
| KRW | South Korean Won | ₩ |
| MAD | Moroccan Dirham | د.م. |
| MXN | Mexican Peso | $ |
| MYR | Malaysian Ringgit | RM |
| NOK | Norwegian Krone | kr |
| NZD | New Zealand Dollar | $ |
| PHP | Philippine Peso | ₱ |
| PLN | Polish Zloty | zł |
| RON | Romanian Leu | lei |
| RUB | Russian Ruble | ₽ |
| SEK | Swedish Krona | kr |
| SGD | Singapore Dollar | $ |
| THB | Thai Baht | ฿ |
| TRY | Turkish Lira | ₺ |
| UAH | Ukrainian Hryvnia | ₴ |
| USD | United States Dollar | $ |
| UYU | Uruguayan Peso | $ |
| VND | Vietnamese Dong | ₫ |
| ZAR | South African Rand | R |
| Currency Code (currency) | Currency Name | Symbol |
|---|---|---|
| AED | United Arab Emirates Dirham | د.إ |
| AUD | Australian Dollar | $ |
| CAD | Canadian Dollar | $ |
| CHF | Swiss Franc | CHF |
| EUR | Euro | € |
| GBP | British Pound Sterling | £ |
| NZD | New Zealand Dollar | $ |
| PLN | Polish Zloty | zł |
| SEK | Swedish Krona | kr |
| USD | United States Dollar | $ |
| Language Code (cnt_language) | Corresponding Locale Code |
|---|---|
| ar | ar-EG |
| ca | ca-ES |
| da | da-DK |
| de | de-DE |
| en | en-US |
| es | es-ES |
| et | et-EE |
| fi | fi-FI |
| fr | fr-FR |
| it | it-IT |
| ja | ja-JP |
| ko | ko-KR |
| lt | lt-LT |
| lv | lv-LV |
| nl | nl-NL |
| no | no-NO |
| pl | pl-PL |
| pt | pt-PT |
| ru | ru-RU |
| sv | sv-SE |
| zh-hant | 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¤cy=USD"
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.
Copyright 2025 GetYourGuide GmbH.