GetYourGuide API
The GetYourGuide API returns tours and activities as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns activities with id, title, images, category, price and original price, and you can browse, pull a detail, reviews and destinations. It is built for travel apps and activity aggregation that need GetYourGuide data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/getyourguide/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "Rome colosseum"
}
}{
"ok": true,
"meta": {
"api": "getyourguide",
"endpoint": "search",
"mode": "live",
"latency_ms": 2101.6,
"record_count": 24,
"bytes": 821563,
"cache_hit": false,
"method": "ssr_ld+json",
"query": "Rome colosseum"
},
"data": {
"activities": [
{
"activity_id": 195566,
"title": "Colosseum, Roman Forum & Palatine Hill Guided Tour",
"images": [
"https://cdn.getyourguide.com/img/tour/33cca66c19886c9f.jpeg/53.jpg"
],
"category": "guidedTour",
"url": "https://www.getyourguide.com/rome-l33/colosseum-roman-forum-palatine-hill-guided-tour-t195566/"
},
{
"activity_id": 562279,
"title": "Rome: Colosseum, Roman Forum & Palatine Hill Entry Ticket",
"images": [
"https://cdn.getyourguide.com/img/tour/376912ad96a4e631a7855a9d0ecc49f47d[redacted-phone]afd00aa30c3b0df.jpeg/53.jpg"
],
"category": "entryTicket",
"url": "https://www.getyourguide.com/rome-l33/rome-colosseum-forum-with-audio-guide-app-optional-arena-t562279/"
},
{
"activity_id": 1364353,
"title": "Coffee inside the Vatican City with Local Guide and Tickets",
"images": [
"https://cdn.getyourguide.com/img/tour/b41f84ba600e704f1424886c5e53ada63ea54db131326ebb47508056fe70ec4e.jpeg/53.jpg"
],
"category": "privateTour",
"url": "https://www.getyourguide.com/rome-l33/coffee-inside-the-vatican-city-with-local-guide-and-tickets-t1364353/"
}
]
}
}What the GetYourGuide API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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. | Travel apps call search to search GetYourGuide for tours & activities by free-text keyword or destination ('Rome colosse…. | query, currency, language |
| browse | 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. | Pricing monitors call browse to get browse the top tours & activities for a destination's landing page. | slug, location_id, city, destination, url, ... |
| detail | Full record for one tour/activity: title, description, supplier, price, rating, review count and photos. Identify it by its activity url (from search/browse). | Itinerary products call detail to get full record for one tour/activity. | url, slug, currency, language |
| reviews | 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. | Hospitality analysts call reviews to get the most-recent public traveler reviews for one activity (rating, text, author, date) plus th…. | url, slug, language |
| destinations | 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. | Travel apps call destinations to get destination metadata for a GetYourGuide location. | slug, location_id, city, destination, url, ... |
Call search from your stack
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"}'import requests
r = requests.post(
"https://api.reefapi.com/getyourguide/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "Rome colosseum"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/getyourguide/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "Rome colosseum"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.getyourguide.search with {"query":"Rome colosseum"}.Who uses this API and why
- Travel apps call search to list tours and activities for a destination.
- Aggregators use browse and detail to build an activity catalog.
- Reputation tools use reviews to surface top-rated experiences.
Questions developers ask before integrating
What is the GetYourGuide API?
GetYourGuide API is a ReefAPI endpoint group for getyourguide It returns live JSON through POST requests under /getyourguide/v1.
Is the GetYourGuide API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. GetYourGuide calls use the same shared credit balance as every other ReefAPI engine.
Do I need a GetYourGuide login or account?
No login to GetYourGuide is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the GetYourGuide data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the GetYourGuide API use?
GetYourGuide actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call GetYourGuide from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call getyourguide actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the GetYourGuide API a GetYourGuide scraper?
It is the managed alternative to a DIY GetYourGuide scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same getyourguide back as clean JSON.
Why does my GetYourGuide scraper keep getting blocked?
Most GetYourGuide scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.