Search and places
Tripadvisor Search API
Tripadvisor Search API for hotels, restaurants, and attractions. Search by query and location and get ratings and Tripadvisor IDs as structured JSON.
Make a request
Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.
curl 'https://api.prismcrawl.com/v1/tripadvisor/search' \
--request POST \
--header 'content-type: application/json' \
--header 'x-api-key: <PRISMCRAWL_API_KEY>' \
--data '{
"location": "Austin, TX",
"query": "restaurants"
}'Supported parameters
| Parameter | Usage |
|---|---|
queryRequired | Text to search for on the selected service. |
location | Location to search around, such as Austin, TX. |
language | Supported Tripadvisor language or regional language code. Defaults to the selected domain language; reviews are translated when available and retain their original language. |
next_page_token | Copy the opaque next_page_token from the previous response using the same account, search parameters, device, and result limit. Tokens expire after one hour; restart pagination if rejected or expired. |
limit | Maximum number of items to return. The provider may return fewer. |
device | Device presentation for the source request. desktop, mobile, tablet |
html | Return the encoded original response rather than parsed JSON. |
zero_trace | Do not archive source or parsed response artifacts. |
coordinates | Latitude and longitude for location targeting. |
ssrc | Search scope: a all places, r restaurants, A attractions and activities, h hotels, g destinations, f forum topics. a, r, A, h, g, f |
offset | Number of results to skip, up to 1000. Use this or next_page_token. |
tripadvisor_domain | Tripadvisor locale domain. Defaults to www.tripadvisor.com, or the domain of a supplied place URL. ar.tripadvisor.com, cn.tripadvisor.com, en.tripadvisor.com.hk, fr.tripadvisor.be, fr.tripadvisor.ca, fr.tripadvisor.ch, it.tripadvisor.ch, no.tripadvisor.com, th.tripadvisor.com, tripadvisor.at, tripadvisor.be, tripadvisor.ca, tripadvisor.ch, tripadvisor.cl, tripadvisor.co, tripadvisor.co.id, tripadvisor.co.il, tripadvisor.co.kr, tripadvisor.co.nz, tripadvisor.co.uk, tripadvisor.co.za, tripadvisor.com, tripadvisor.com.ar, tripadvisor.com.au, tripadvisor.com.br, tripadvisor.com.eg, tripadvisor.com.gr, tripadvisor.com.hk, tripadvisor.com.mx, tripadvisor.com.my, tripadvisor.com.pe, tripadvisor.com.ph, tripadvisor.com.sg, tripadvisor.com.tr, tripadvisor.com.tw, tripadvisor.com.ve, tripadvisor.com.vn, tripadvisor.de, tripadvisor.dk, tripadvisor.es, tripadvisor.fr, tripadvisor.ie, tripadvisor.in, tripadvisor.it, tripadvisor.jp, tripadvisor.nl, tripadvisor.pt, tripadvisor.ru, tripadvisor.se, www.tripadvisor.at, www.tripadvisor.be, www.tripadvisor.ca, www.tripadvisor.ch, www.tripadvisor.cl, www.tripadvisor.co, www.tripadvisor.co.id, www.tripadvisor.co.il, www.tripadvisor.co.kr, www.tripadvisor.co.nz, www.tripadvisor.co.uk, www.tripadvisor.co.za, www.tripadvisor.com, www.tripadvisor.com.ar, www.tripadvisor.com.au, www.tripadvisor.com.br, www.tripadvisor.com.eg, www.tripadvisor.com.gr, www.tripadvisor.com.hk, www.tripadvisor.com.mx, www.tripadvisor.com.my, www.tripadvisor.com.pe, www.tripadvisor.com.ph, www.tripadvisor.com.sg, www.tripadvisor.com.tr, www.tripadvisor.com.tw, www.tripadvisor.com.ve, www.tripadvisor.com.vn, www.tripadvisor.de, www.tripadvisor.dk, www.tripadvisor.es, www.tripadvisor.fr, www.tripadvisor.ie, www.tripadvisor.in, www.tripadvisor.it, www.tripadvisor.jp, www.tripadvisor.nl, www.tripadvisor.pt, www.tripadvisor.ru, www.tripadvisor.se |
Structured results
Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.
addressauthorauthor_thumbnailauthor_urlcategorycoordinatesdescriptionengineidimagelatitudelongitudenamephoneplace_idpositionpublished_atrankratingrating_maxrating_sourcereview_countsnippetthumbnailtitletopic_idtypeurlwebsiteContinue with data.content.next_page_token when has_next_page is true. Omit page when using a token and keep the other request parameters unchanged, including the query or ID, country, language, device, result limit, and sort order. Stop when no token is returned. Tokens belong to the same account and expire after one hour. Restart pagination if a token is expired or rejected, including tokens issued before authenticated tokens were introduced. If the source inventory changes after a valid continuation is fetched, a completed HTTP 200 response costs one credit and marks pagination_limited: true with pagination_reason: stale_cursor. Keep any returned results and restart pagination; no continuation token is returned.
SDKs and guides
The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.
- Python SDK:
pip install prismcrawl - Node.js SDK:
npm install prismcrawl - Tutorial: Scrape Google Maps, Yelp, and Tripadvisor reviews with Python
Frequently asked questions
Do I need a Tripadvisor API key?
No. You authenticate with your PrismCrawl API key in the x-api-key header. You do not need a Tripadvisor developer account or Tripadvisor API key.
How much does the Tripadvisor API cost?
Each completed Tripadvisor request uses one credit. Credits cost $0.30–$0.15 per 1,000 depending on the package, with no subscription, and new accounts receive 100 free credits. Validation and operational errors are not charged.