Tripadvisor API
The Tripadvisor API returns hotel, restaurant and attraction reviews and ratings 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 reviews endpoint returns a place with its location id, name, type, rating, review count, ranking, price range, rating histogram, subratings and amenities — plus the review text. You can also list places, pull a detail and run a search. It is built for travel apps, reputation monitoring and hospitality analytics that need Tripadvisor data without scraping a defended site. 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/tripadvisor/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "Bellagio Las Vegas",
"limit": 5
}
}{
"ok": true,
"meta": {
"api": "tripadvisor",
"endpoint": "search",
"mode": "live",
"latency_ms": 694.7,
"record_count": 5,
"bytes": 0,
"cache_hit": false,
"attempts": 1
},
"data": {
"results": [
{
"location_id": "91703",
"name": "Bellagio",
"entity_type": "hotel",
"url": "https://www.tripadvisor.com/Hotel_Review-g45963-d91703-Reviews-Bellagio-Las_Vegas_Nevada.html"
},
{
"location_id": "625114",
"name": "[redacted-name]",
"entity_type": "attraction",
"url": "https://www.tripadvisor.com/Attraction_Review-g45963-d625114-Reviews-Bellagio_Conservatory_Botanical_Garden-Las_Vegas_Nevada.html"
},
{
"location_id": "12165098",
"name": "[redacted-name]",
"entity_type": "activity",
"url": "https://www.tripadvisor.com/AttractionProductReview-g45963-d12165098-O_by_Cirque_du_SoleilR_at_the_Bellagio_Hotel_and_Casino-Las_Vegas_Nevada.html"
}
]
}
}What the Tripadvisor API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| reviews | Reviews + the full place profile (rating histogram, subratings, amenities) for one or more Tripadvisor places, by page URL. | Support teams call reviews to get reviews + the full place profile (rating histogram, subratings, amenities) for one or more Tr…. | startUrls, url, queries, query, maxReviews, ... |
| places/list | Discover hotels, restaurants or attractions in a city/area (name, rating, review count) — the feeder for `reviews`. | Reputation platforms call places/list to discover hotels, restaurants or attractions in a city/area (name, rating, review count). | location, category, geo_id, location_slug, max_results |
| detail | Full profile for one Tripadvisor hotel, restaurant or attraction by page URL: overall rating, total reviews, ranking, price level, the per-star rating breakdown, category subratings (cleanliness / service / value / location / food / atmosphere), amenities, cuisines, address, coordinates and phone. | Market researchers call detail to get full profile for one Tripadvisor hotel, restaurant or attraction by page URL. | url |
| search | Find Tripadvisor places (hotels, restaurants, attractions) and destinations by name — the typeahead the site's own search box uses. Returns the matching location IDs + page URLs to feed into `reviews` or `detail`. | B2B review analysts call search to find Tripadvisor places (hotels, restaurants, attractions) and destinations by name. | query |
Call search from your stack
curl -X POST https://api.reefapi.com/tripadvisor/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Bellagio Las Vegas","limit":5}'import requests
r = requests.post(
"https://api.reefapi.com/tripadvisor/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "Bellagio Las Vegas",
"limit": 5
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/tripadvisor/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "Bellagio Las Vegas",
"limit": 5
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.tripadvisor.search with {"query":"Bellagio Las Vegas","limit":5}.Who uses this API and why
- Hospitality teams call reviews to monitor a property's Tripadvisor rating, ranking and guest feedback.
- Travel apps use search and detail to show live ratings for hotels, restaurants and attractions.
- Market analysts use the rating histogram and subratings to benchmark a venue against competitors.
Questions developers ask before integrating
What is the Tripadvisor API?
Tripadvisor API is a ReefAPI endpoint group for hotels, restaurants and attractions with reviews. It returns live JSON through POST requests under /tripadvisor/v1.
Is the Tripadvisor API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Tripadvisor calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Tripadvisor login or account?
No login to Tripadvisor 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 Tripadvisor data?
The page example is captured from a live reviews call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Tripadvisor API use?
Tripadvisor 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 Tripadvisor from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call tripadvisor actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Tripadvisor API a Tripadvisor scraper?
It is the managed alternative to a DIY Tripadvisor 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 hotels, restaurants and attractions with reviews back as clean JSON.
Why does my Tripadvisor scraper keep getting blocked?
Most Tripadvisor 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.