> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/tripadvisor>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/tripadvisor.mdx>

---

# Tripadvisor API. Places, rankings and reviews as JSON.

Search, hotels, restaurants and attractions with their rating breakdown, a city's places, cruise search and cruise ships, and every review with the owner's reply. 16 routes under `/v1/tripadvisor`, one credit per request.

- 15 routes
- Places + reviews
- 1 credit per request

Social Fetch exposes 16 routes under `/v1/tripadvisor`. Every response uses the `{ data, meta }` envelope, and every lookup carries `data.lookupStatus`: `found` or `not_found`. HTTP 200 only means the request finished, so branch on `lookupStatus` before storing a row.

Tripadvisor names every place by a numeric location id, the `d` number in its address (`Hotel_Review-g60763-d93450-…` is `93450`), and every city or region by a geo id, the `g` number. `GET /v1/tripadvisor/search?query=eiffel tower` finds both by name; `type=geo` keeps cities and regions. `GET /v1/tripadvisor/place?url=` reads a place straight from its page link.

`GET /v1/tripadvisor/hotels/{locationId}`, `/restaurants/{locationId}` and `/attractions/{locationId}` read one place with its rating, reviews per star, aspect scores, ranking in its city, address, phone and website, plus what its kind has: amenities and room count for hotels, cuisines and opening hours for restaurants, categories for attractions. `GET /v1/tripadvisor/hotels?geoId=`, `/restaurants?geoId=` and `/attractions?geoId=` list the places of that kind in a city in the site's own order, up to the site's 10,000 (`truncated` says when a list stops short), and `/attractions/types?geoId=` counts the kinds of things to do. `GET /v1/tripadvisor/cruises?geoId=` searches cruises to a destination, with ship, ports, itinerary and departure dates, and `GET /v1/tripadvisor/cruise-ships/{locationId}` reads a cruise ship with its line, capacity, activities and dining. The reviews routes page through a place's reviews, newest first, with the owner's public replies. Cruise pages show shorter reviews: past the first page, a cruise review's `text` is a snippet of about 280 characters.

## What you can get

- Search by name for cities, regions, hotels, restaurants and attractions, with location ids, coordinates and page links.
- Any place from its Tripadvisor page link, on tripadvisor.com or a country site.
- Hotels, restaurants and attractions by location id: rating, reviews per star, aspect scores, ranking, address, coordinates, phone, website, price level and photo.
- Hotel amenities, styles and room count; restaurant cuisines and opening hours; attraction categories and opening hours.
- The hotels, restaurants or attractions in a city or region, up to the site's 10,000, 30 a page, in the site's own order, with rating, ranking, address and award.
- Cruise search by destination with ships, itineraries and departure dates; cruise ships with their line, rating, passengers, crew, cabins, activities and dining, and the kinds of things to do in a city with a count for each.
- Every review of a place, newest first: rating, title, text, trip type, visit date, photos, the reviewer and the owner's reply.

## Tripadvisor endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Search | GET /v1/tripadvisor/search | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/search/get) |
| Place by URL | GET /v1/tripadvisor/place | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/place/get) |
| Hotels in a city | GET /v1/tripadvisor/hotels | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/hotels/get) |
| Restaurants in a city | GET /v1/tripadvisor/restaurants | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/restaurants/get) |
| Attractions in a city | GET /v1/tripadvisor/attractions | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/get) |
| Attraction types in a city | GET /v1/tripadvisor/attractions/types | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/types/get) |
| Cruise search | GET /v1/tripadvisor/cruises | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/cruises/get) |
| Cruise ship | GET /v1/tripadvisor/cruise-ships/{locationId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/cruise-ships/locationid/get) |
| Cruise ship reviews | GET /v1/tripadvisor/cruise-ships/{locationId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/cruise-ships/locationid/reviews/get) |
| Hotel | GET /v1/tripadvisor/hotels/{locationId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/hotels/locationid/get) |
| Restaurant | GET /v1/tripadvisor/restaurants/{locationId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/restaurants/locationid/get) |
| Attraction | GET /v1/tripadvisor/attractions/{locationId} | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/locationid/get) |
| Place reviews | GET /v1/tripadvisor/places/{locationId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/places/locationid/reviews/get) |
| Hotel reviews | GET /v1/tripadvisor/hotels/{locationId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/hotels/locationid/reviews/get) |
| Restaurant reviews | GET /v1/tripadvisor/restaurants/{locationId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/restaurants/locationid/reviews/get) |
| Attraction reviews | GET /v1/tripadvisor/attractions/{locationId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/tripadvisor/attractions/locationid/reviews/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Tripadvisor route on real places.
2. **Find the id, then read.** Call `GET /v1/tripadvisor/search?query=eiffel tower`, then pass a match's `locationId` to `GET /v1/tripadvisor/attractions/{locationId}` or its reviews. Send `x-api-key` on every request.
3. **Branch, page and bill.** Check `data.lookupStatus` before writing a row. Follow `page.nextCursor` while `page.hasMore` is true. Bill from `meta.creditsCharged` and log `meta.requestId` for support.

## Pricing

Every Tripadvisor route charges 1 credit per completed request, a not-found answer included. Each page of a list or reviews is its own request. Credits never expire on pay-as-you-go packs. `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Tripadvisor's own Content API is for approved partners, needs a registered key and returns a handful of reviews per place. Social Fetch returns the public places, city lists and reviews any visitor sees, under one JSON envelope with typed `lookupStatus` values and absolute links. Photos are linked, never rehosted.

## FAQ

### Is there a Tripadvisor API for hotels, restaurants and reviews?

Yes. Social Fetch has 16 Tripadvisor routes under /v1/tripadvisor: search, a place by link, hotels, restaurants, attractions and cruise ships by id, a city's hotels, restaurants, attractions and attraction types, cruises to a destination, and reviews. Authenticate with your Social Fetch API key in x-api-key.

### What is a location id, and where do I find one?

Tripadvisor's number for a place: the d number in its address, so Hotel_Review-g60763-d93450-… is 93450. Search returns it as locationId, and so does every row of the city lists. You can also pass the page link itself to GET /v1/tripadvisor/place.

### How do I list the hotels or restaurants in a city?

Find the city's geo id with GET /v1/tripadvisor/search?type=geo (London is 186338, New York City 60763, Paris 187147), then call GET /v1/tripadvisor/hotels, /restaurants or /attractions with geoId. Follow page.nextCursor while page.hasMore is true. The site's lists stop at 10,000 places; truncated is true when a list stops before totalCount.

### Which reviews do I get?

Every review the US English site shows, newest first: those written in English and those the site has translated into English. translated says which, and originalLanguage names the language the reviewer wrote in.

### Do the reviews include the owner's replies?

Yes. ownerResponse holds the reply, when it was posted, the responder's name and role. It is null when the place has not replied.

### How much does the Tripadvisor API cost?

Every Tripadvisor route charges 1 credit per completed request. New accounts start with 100 free credits. Check meta.creditsCharged on each response for the amount actually billed.

### Does HTTP 200 mean the place exists?

No. HTTP 200 means the request finished. Check data.lookupStatus: found means it was read, not_found means no place of that kind has the id, or no city has the geo id.

## Related

- [Tripadvisor Search API](https://www.socialfetch.dev/platforms/tripadvisor/search): Cities, hotels, restaurants and attractions by name, with their ids (`GET /v1/tripadvisor/search`).
- [Tripadvisor Hotel API](https://www.socialfetch.dev/platforms/tripadvisor/hotels-locationid): One hotel with its ratings, ranking and amenities (`GET /v1/tripadvisor/hotels/{locationId}`).
- [Tripadvisor Restaurants API](https://www.socialfetch.dev/platforms/tripadvisor/restaurants): The restaurants in a city, in the site's order (`GET /v1/tripadvisor/restaurants`).
- [Tripadvisor Reviews API](https://www.socialfetch.dev/platforms/tripadvisor/places-locationid-reviews): Every review of any place, newest first (`GET /v1/tripadvisor/places/{locationId}/reviews`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language hotel, restaurant or review question to the matching Tripadvisor operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Tripadvisor tools from Cursor or Claude with the same credit metering as REST.
