Tripadvisor
Search Tripadvisor places and pull traveler reviews behind the unified schema
Search Tripadvisor for businesses and places (restaurants, hotels, attractions) and pull their traveler reviews. Search returns the canonical Place object and reviews the shared Review object, so your code reads Tripadvisor exactly like it reads Amazon, Google Shopping or Trustpilot.
Base URL: /v1/tripadvisor/...
It is a two-step flow, and the joining key is url_path. Call search to find a place, read url_path off the result, then pass it to reviews verbatim, without a leading slash.
search defaults to the United States when you omit location, so a
query for a place in Tokyo without location=Tokyo,Japan quietly returns
American results. Always pass location unless you mean the US.
Quickstart
Find the place
Note that the query parameter is q, not query.
curl "https://www.socialcrawl.dev/v1/tripadvisor/search?q=pizza%20restaurant&location=New%20York,New%20York,United%20States&depth=30" \
-H "x-api-key: YOUR_API_KEY"Pull its traveler reviews
Pass the url_path from step 1 exactly as returned.
curl "https://www.socialcrawl.dev/v1/tripadvisor/reviews?url_path=Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html&depth=30&sort_by=most_recent" \
-H "x-api-key: YOUR_API_KEY"Places
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/tripadvisor/search | 1 | Places with name, category, star rating, total review count, and the url_path that identifies them | q (required), location, language, depth |
depth is the result count in multiples of 30: default 30, max 60 on this synchronous endpoint. The place id and absolute url are both derived from url_path.
Reviews
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/tripadvisor/reviews | 1 | Star rating, title, full text, reviewer, attached photos, management replies, language, publish date | url_path (required), depth, sort_by, rating, visit_type, search_reviews_keyword, translate |
depth is in multiples of 10: default 10, max 30. sort_by takes most_recent or detailed_reviews. rating filters by traveler bucket (excellent, very_good, average, poor, terrible) rather than a star number, and visit_type by traveler type (families, couples, solo, business, friends).
All endpoints
16 endpoints available.
| Endpoint | Path | Credit Tier |
|---|---|---|
| Get a TripAdvisor attraction | /v1/tripadvisor/attraction | standard (1cr) |
| Get TripAdvisor reviews for an attraction | /v1/tripadvisor/attraction/reviews | standard (1cr) |
| Search TripAdvisor attractions and things to do | /v1/tripadvisor/attractions | standard (1cr) |
| Autocomplete TripAdvisor places | /v1/tripadvisor/autocomplete | standard (1cr) |
| Get a TripAdvisor cruise ship | /v1/tripadvisor/cruise | standard (1cr) |
| Get TripAdvisor reviews for a cruise ship | /v1/tripadvisor/cruise/reviews | standard (1cr) |
| Search TripAdvisor cruises | /v1/tripadvisor/cruises | standard (1cr) |
| List TripAdvisor experience types for a destination | /v1/tripadvisor/experience-types | standard (1cr) |
| Get a TripAdvisor hotel | /v1/tripadvisor/hotel | standard (1cr) |
| Search TripAdvisor hotels | /v1/tripadvisor/hotels | standard (1cr) |
| Get a TripAdvisor place by URL | /v1/tripadvisor/place | standard (1cr) |
| Get a TripAdvisor restaurant | /v1/tripadvisor/restaurant | standard (1cr) |
| Get TripAdvisor reviews for a restaurant | /v1/tripadvisor/restaurant/reviews | standard (1cr) |
| Search TripAdvisor restaurants | /v1/tripadvisor/restaurants | standard (1cr) |
| Get TripAdvisor reviews for a place | /v1/tripadvisor/reviews | standard (1cr) |
| Search TripAdvisor businesses & places | /v1/tripadvisor/search | standard (1cr) |
Platform notes
Neither endpoint paginates. depth is the only size control on both, and the synchronous endpoints cap it at 60 results on search and 30 reviews on reviews. Deeper review history is a future async surface.
Reviews are auto-translated by Tripadvisor. translate defaults to true, and every review carries a translated flag plus its original_language so you can tell what was rewritten. Set translate=false if you want the text as written.
First calls are slow, then cached. A cold call takes roughly 15 to 45 seconds because the upstream settles a task before answering; repeats serve from cache. Set client timeouts accordingly. Search caches for 2 minutes and reviews for 5, a cache hit costs 0 credits, and Cache-Control: no-cache requests a billed refresh.
A place with no matching reviews returns 404. It is refunded automatically and never billed. Note that filters narrow the match, so a tight rating plus search_reviews_keyword combination can produce a not-found on a place that does have reviews.
Next steps
Credits
What each tier costs, and which failures are refunded.
Caching
Freshness windows, and how cache hits keep your bill down.
API reference
Every Tripadvisor parameter and response field.
Trustpilot
Company reviews in the same canonical review shape.
Prism
Cross-source reputation and product reviews in one call.