# TripAdvisor Reviews API (https://www.socialcrawl.dev/platforms/tripadvisor/reviews)

> Returns a unified ReviewList of traveler reviews for a TripAdvisor place, keyed by its `url_path` (`entity_id` on every review). Each review carries the star rating, full text, title, reviewer profile, attached photos, owner/management `responses[]`, the original + translated language (TripAdvisor auto-translates — a `translated` flag marks it), and publish date. Get the `url_path` from /v1/tripadvisor/search. Filter by traveler rating, traveler type, or a keyword. The synchronous endpoint caps `depth` at 30 (deeper history is a future async surface); a place with no matching reviews returns 404 (auto-refunded). Sourced from DataForSEO's task-based Business Data API (first calls ~15-45s, then cached).

TL;DR: `GET /v1/tripadvisor/reviews` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url_path` | yes | The TripAdvisor `url_path` of the place (from a search result), e.g. 'Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html'. |
| `depth` | no | Number of reviews to retrieve (multiples of 10, default 10, max 30 on this synchronous endpoint). |
| `sort_by` | no | Review ordering: `most_recent` or `detailed_reviews`. (most_recent \| detailed_reviews) |
| `rating` | no | Filter by traveler rating bucket: excellent \| very_good \| average \| poor \| terrible. (excellent \| very_good \| average \| poor \| terrible) |
| `visit_type` | no | Filter by traveler type: families \| couples \| solo \| business \| friends. (families \| couples \| solo \| business \| friends) |
| `search_reviews_keyword` | no | Only return reviews containing this keyword. |
| `translate` | no | Translate reviews to the place's domain language (default true). The `translated` flag + `original_language` are always returned. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tripadvisor/reviews?url_path=Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I use the TripAdvisor Reviews API?

Send a GET request to /v1/tripadvisor/reviews with the place's url_path — the identifier returned by /v1/tripadvisor/search. SocialCrawl returns a unified ReviewList where every review carries the star rating, title, full text, reviewer profile, photos, owner responses, and publish date.

### What fields does each TripAdvisor review include?

Each review includes the star rating, title, full review text, reviewer profile, attached photos, any owner or management responses, the publish date, and translation info — a translated flag plus the original_language field, since TripAdvisor auto-translates reviews.

### Can I filter TripAdvisor reviews by rating or traveler type?

Yes. Filter by rating bucket (excellent, very_good, average, poor, terrible), by visit_type (families, couples, solo, business, friends), or by a search_reviews_keyword that only returns reviews containing that keyword. Sorting supports most_recent and detailed_reviews.

### How many TripAdvisor reviews can I pull per request?

The depth parameter works in multiples of 10 — the default is 10 and the synchronous endpoint caps at 30 reviews per request. Each request costs 1 credit on the standard tier, and new accounts start with 100 free credits.

### Does the API translate TripAdvisor reviews?

Yes, by default. The translate parameter (default true) returns reviews translated to the place's domain language, and every review keeps a translated flag plus its original_language so you always know what was translated and from which language.

### What happens if a place has no matching reviews?

The endpoint returns a 404 and your credit is automatically refunded. That covers both places with zero reviews and filter combinations — like a rating bucket or keyword — that match nothing.

See the full TripAdvisor API: https://www.socialcrawl.dev/platforms/tripadvisor

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get TripAdvisor reviews with an API
- What fields does the SocialCrawl TripAdvisor Reviews API return?