GetYourGuide
GetYourGuide
/getyourguide/v1/search1 creditSearch GetYourGuide for tours & activities by free-text keyword or destination ('Rome colosseum', 'Paris', 'wine tasting Tuscany'). Returns activity cards with title, activity_id, price and list price, rating, review count, photos, category, duration and a link to the activity. GetYourGuide answers a query it cannot match with recommended activities rather than an empty page, so compare the titles against your query when it is very specific.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to look for — a city, attraction, activity type or any combination ('Barcelona', 'Eiffel Tower', 'Tuscany wine tour'). |
| currency | optional | AED · AUD · BRL · CAD · CHF · CLP · CNY · COP · CZK · DKK · EGP · EUR · GBP · HKD · HUF · IDR · ILS · INR · JPY · KRW · MAD · MXN · MYR · NOK · NZD · PHP · PLN · RON · SEK · SGD · THB · TRY · UAH · USD · UYU · VND · ZAR | ISO code the prices should be quoted in (EUR, USD, GBP…). Every returned record carries the `currency` it was priced in. Leave it out and GetYourGuide picks one itself, so it can differ between calls — set it when you need comparable prices. |
| language | optional | en · en-GB · en-AU · ar · bg · ca · cs · da · de · de-AT · de-CH · el · es · es-MX · et · fi · fr · he · hr · hu · id · it · ja · ko · lt · lv · ms · nl · no · pl · pt · pt-BR · ro · ru · sk · sl · sr · sv · th · tr · uk · zh · zh-HK · zh-TW | Language of the returned titles, descriptions, categories and destination names. Ids, prices, ratings and review counts are the same in every language. Default English. |
/getyourguide/v1/browse1 creditBrowse the top tours & activities for a destination's landing page. Returns activities with title, price, rating, review count, photos and a link. Identify the destination by its slug (from search/destinations) or by location_id + city.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| slug | optional | — | The destination URL slug — '<city>-l<id>' (e.g. 'rome-l33', 'paris-l16'). Returned by search/destinations. |
| location_id | optional | — | GetYourGuide location id (the number after '-l' in the URL). Pair with city; the city slug is cosmetic. |
| city | optional | — | City/destination name (used with location_id to build the URL slug). |
| url | optional | — | Alternatively a full GetYourGuide destination URL. |
| currency | optional | AED · AUD · BRL · CAD · CHF · CLP · CNY · COP · CZK · DKK · EGP · EUR · GBP · HKD · HUF · IDR · ILS · INR · JPY · KRW · MAD · MXN · MYR · NOK · NZD · PHP · PLN · RON · SEK · SGD · THB · TRY · UAH · USD · UYU · VND · ZAR | ISO code the prices should be quoted in (EUR, USD, GBP…). Every returned record carries the `currency` it was priced in. Leave it out and GetYourGuide picks one itself, so it can differ between calls — set it when you need comparable prices. |
| language | optional | en · en-GB · en-AU · ar · bg · ca · cs · da · de · de-AT · de-CH · el · es · es-MX · et · fi · fr · he · hr · hu · id · it · ja · ko · lt · lv · ms · nl · no · pl · pt · pt-BR · ro · ru · sk · sl · sr · sv · th · tr · uk · zh · zh-HK · zh-TW | Language of the returned titles, descriptions, categories and destination names. Ids, prices, ratings and review counts are the same in every language. Default English. |
/getyourguide/v1/detail2 creditsFull record for one tour/activity: title, description, the company that operates it, price and list price, rating, review count and photos. Identify it by its activity url (from search/browse).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | optional | — | The activity's GetYourGuide URL (from a search/browse result). |
| slug | optional | — | Alternatively the activity path ('…-lNN/…-tNN'). |
| currency | optional | AED · AUD · BRL · CAD · CHF · CLP · CNY · COP · CZK · DKK · EGP · EUR · GBP · HKD · HUF · IDR · ILS · INR · JPY · KRW · MAD · MXN · MYR · NOK · NZD · PHP · PLN · RON · SEK · SGD · THB · TRY · UAH · USD · UYU · VND · ZAR | ISO code the prices should be quoted in (EUR, USD, GBP…). Every returned record carries the `currency` it was priced in. Leave it out and GetYourGuide picks one itself, so it can differ between calls — set it when you need comparable prices. |
| language | optional | en · en-GB · en-AU · ar · bg · ca · cs · da · de · de-AT · de-CH · el · es · es-MX · et · fi · fr · he · hr · hu · id · it · ja · ko · lt · lv · ms · nl · no · pl · pt · pt-BR · ro · ru · sk · sl · sr · sv · th · tr · uk · zh · zh-HK · zh-TW | Language of the returned titles, descriptions, categories and destination names. Ids, prices, ratings and review counts are the same in every language. Default English. |
/getyourguide/v1/reviews1 creditThe most-recent public traveler reviews for one activity (rating, text, author, date) plus the overall rating and total review count. Returns the 10 newest reviews — that is the full set GetYourGuide publishes on the activity page itself; read review_count for the total volume behind them.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | optional | — | The activity's GetYourGuide URL (from search/browse). |
| slug | optional | — | Alternatively the activity path ('…-lNN/…-tNN'). |
| language | optional | en · en-GB · en-AU · ar · bg · ca · cs · da · de · de-AT · de-CH · el · es · es-MX · et · fi · fr · he · hr · hu · id · it · ja · ko · lt · lv · ms · nl · no · pl · pt · pt-BR · ro · ru · sk · sl · sr · sv · th · tr · uk · zh · zh-HK · zh-TW | Language of the returned titles, descriptions, categories and destination names. Ids, prices, ratings and review counts are the same in every language. Default English. |
/getyourguide/v1/destinations1 creditDestination metadata for a GetYourGuide location: id, name, type, country, the number of bookable activities, and its parent locations (region → country). Useful to confirm a destination and discover its hierarchy before browsing.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| slug | optional | — | The destination URL slug ('<city>-l<id>'). |
| location_id | optional | — | GetYourGuide location id (number after '-l'). |
| city | optional | — | City/destination name (used with location_id). |
| url | optional | — | Alternatively a full destination URL. |
| language | optional | en · en-GB · en-AU · ar · bg · ca · cs · da · de · de-AT · de-CH · el · es · es-MX · et · fi · fr · he · hr · hu · id · it · ja · ko · lt · lv · ms · nl · no · pl · pt · pt-BR · ro · ru · sk · sl · sr · sv · th · tr · uk · zh · zh-HK · zh-TW | Language of the returned titles, descriptions, categories and destination names. Ids, prices, ratings and review counts are the same in every language. Default English. |
curl -X POST https://api.reefapi.com/getyourguide/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Rome colosseum","currency":"EUR"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.