# Tripadvisor (/docs/tripadvisor)



Tripadvisor [#tripadvisor]

Search Tripadvisor for businesses and places — restaurants, hotels, attractions — and pull their traveler reviews behind the unified SocialCrawl schema.

Base URL: `/v1/tripadvisor/...`

Getting Started [#getting-started]

It's a two-step flow. Call `search` to find a place and get its `url_path`, then pass that `url_path` to `reviews` to pull that place's traveler reviews. Both endpoints are powered by DataForSEO: search returns the first-class canonical `Place` object, reviews returns the shared `Review` object (the same shape as any other reviews source), so your code reads Tripadvisor exactly like it reads Amazon, Google Shopping, or Trustpilot. Repeated searches may use the 2-minute endpoint cache and repeated review requests the 5-minute cache. Cache hits cost 0 credits; `Cache-Control: no-cache` requests a billed refresh.

Endpoints [#endpoints]

<PlatformEndpoints platform="tripadvisor" />

Notes [#notes]

* All endpoints use `GET` method with query parameters
* Authentication via `x-api-key` header
* Responses follow the unified SocialCrawl schema (`PlaceList` for search, `ReviewList` for reviews)
* **Two-step flow:** `search` returns each place's `url_path` (the chaining key); pass it to `reviews`. The place `id` and absolute `url` are derived from that `url_path`.
* `search` is location-bound — pass `location` (e.g. `New York,New York,United States`); it defaults to the United States
* Reviews carry the star rating, full text, reviewer profile, attached photos, owner/management `responses[]`, and — because Tripadvisor auto-translates — a `translated` flag plus the `original_language`
* Filter reviews by traveler `rating`, `visit_type`, or a keyword; sort by `most_recent` or `detailed_reviews`. The synchronous endpoint caps `depth` at 30 (deeper history is a future async surface)
