docs / getyourguide

GetYourGuide API

base /getyourguide/v15 endpoints

post/getyourguide/v1/search1 credit

Search GetYourGuide for tours & activities by free-text keyword or destination ('Rome colosseum', 'Paris', 'wine tasting Tuscany'). Returns activity cards with title, activity_id, price, photos, category and a link to the activity.

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	—	Price currency as an ISO code (EUR, USD, GBP, TRY, AUD…). Sent to GetYourGuide so prices come back in that currency.
language	optional	en · de · fr · es · it · nl · pt	Content language (locale). Default English.

Try in playground →

post/getyourguide/v1/browse1 credit

Browse 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	—	Price currency as an ISO code (EUR, USD, GBP, TRY, AUD…). Sent to GetYourGuide so prices come back in that currency.
language	optional	en · de · fr · es · it · nl · pt	Content language (locale). Default English.

Try in playground →

post/getyourguide/v1/detail2 credits

Full record for one tour/activity: title, description, supplier, 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	—	Price currency as an ISO code (EUR, USD, GBP, TRY, AUD…). Sent to GetYourGuide so prices come back in that currency.
language	optional	en · de · fr · es · it · nl · pt	Content language (locale). Default English.

Try in playground →

post/getyourguide/v1/reviews1 credit

The most-recent public traveler reviews for one activity (rating, text, author, date) plus the overall rating and total review count. GetYourGuide serves the 10 newest reviews server-side; older pages load behind an anti-bot wall, so this returns the 10 newest — use the review_count for the full volume.

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 · de · fr · es · it · nl · pt	Content language (locale). Default English.

Try in playground →

post/getyourguide/v1/destinations1 credit

Destination 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 · de · fr · es · it · nl · pt	Content language (locale). Default English.

Try in playground →

Example request · search

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"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}