docs / tripadvisor

Tripadvisor

Hotels, restaurants and attractions with reviews.

base /tripadvisor/v12 endpoints

post/tripadvisor/v1/reviews1 credit

Reviews + the full place profile (rating histogram, subratings, amenities) for one or more Tripadvisor places, by page URL.

Parameter		Allowed / range	Description
url	optional	—	Tripadvisor page URL of the hotel/restaurant/attraction (the reliable input — copy it from the browser). Provide this OR startUrls.
startUrls	optional	—	Several place URLs in one call (strings or {url:…} objects). One minted session is reused across them.
query	optional	—	UNRELIABLE: place-name lookup often fails to resolve ('Could not resolve a locationId'). Use `url` instead.
queries	optional	—	UNRELIABLE (same lookup as `query`): several place names in one call. Prefer `startUrls`.
maxReviews = 200	optional	1–10000	How many of the newest reviews to fetch per place (1–10000). More reviews = longer runtime.
language = en	optional	—	Review language filter (ISO 639-1: en, es, de…). Use 'all' for every language (machine-translated).

Try in playground →

post/tripadvisor/v1/places/list2 credits

Discover hotels, restaurants or attractions in a city/area (name, rating, review count) — the feeder for `reviews`.

Parameter		Allowed / range	Description
location	required	—	City or area name. Resolved to a Tripadvisor geo automatically (or pin it exactly with geo_id).
category = hotels	optional	hotels · restaurants · attractions	What kind of places to list (singular forms also accepted).
max_results = 30	optional	1–500	How many places to return (1–500). The engine pages the results internally.
geo_id	optional	—	Advanced: Tripadvisor geo ID (the g-number in URLs) — skips the location lookup.
location_slug	optional	—	Advanced: the URL slug that pairs with geo_id.

Try in playground →

Example request · reviews

curl -X POST https://api.reefapi.com/tripadvisor/v1/reviews \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"startUrls":[{"url":"https://www.tripadvisor.com/Hotel_Review-g45963-d91703-Reviews-Bellagio-Las_Vegas_Nevada.html"}],"maxReviews":45}'

Response shape

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