Getting Started
Turn a place name into an id, then read everything Tripadvisor holds about it.
1. Get your API key
Create an account and generate a FetchLayer API key from your dashboard. There is no Tripadvisor partner application, content licence, or per-property key involved.
Create free account →2. Find the place
Every other endpoint takes a location: a Tripadvisor location id, or a hotel, restaurant or attraction URL. Search by name to get the id.
curl -X POST https://api.fetchlayer.dev/tripadvisor/search-locations \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"query":"Park Hyatt Tokyo","locationTypes":["hotel"],"limit":5}'Tip
/resolve-url instead — it returns the location id, the geo id of the city, and the kind of place, and it does not consume a credit. 3. Read the profile
One call returns the rating and its per-bubble distribution, the ranking within the city, price range, address and coordinates, phone, website, amenities, opening hours, awards and description. It is eight upstream operations resolved in a single request, and nothing renders a browser to do it.
curl -X POST https://api.fetchlayer.dev/tripadvisor/location-profile \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"location":"298106"}'4. Page the reviews
Reviews arrive 20 to a page. Use pages to walk deeper in one request, and cursor to resume where the last response stopped.
curl -X POST https://api.fetchlayer.dev/tripadvisor/location-reviews \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"location":"298106","pages":5,"sortBy":"recent","minRating":4}'20 per page is the hard ceiling
limit asks for — a request for 200 returns a byte-identical 20. Ask for depth with pages, and remember each page walked bills as one request. language does not filter
language is the language reviews are requested in, not a filter on what the reviewer wrote. It moves the reported reviewCount while the rows that come back stay a mix of languages. Set translate: true to get the text in your language, and read originalLanguage and isTranslated on each review to know what you are looking at. 5. Read the notes
Every JSON response carries a notes[] array of plain-English caveats — a walk cut short, an upstream limit hit, a field Tripadvisor does not publish for this place. A response can be complete-looking and still partial, and notes is where that is said. Log it alongside the payload.