{"uid":"cap_1xiPamQWQ8x-e9ZtfTso_","slug":"agents-litescrape-com-search-tripadvisor-a402373a","name":"Search Tripadvisor","description":"Searches Tripadvisor by text and returns search_results (name, place type, rating, review count, location, and the place_id for the place and reviews endpoints). Narrow by place_type (accommodation, attraction, attraction_product, eatery, or geo), a geo_id, or lat and lon, choose the language with locale and a localized tripadvisor_domain, and page with start and num (up to 30 per call). One call is one request.","url":"https://agents.litescrape.com/api/tripadvisor/search","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":500,"description":"Search text."},"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Search-center latitude. Requires lon."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Search-center longitude. Requires lat."},"num":{"type":"integer","default":30,"maximum":30,"minimum":1,"description":"Number of results."},"start":{"type":"integer","default":0,"maximum":10000,"minimum":0,"description":"Result offset."},"geo_id":{"type":"string","description":"Positive Tripadvisor geography ID to search within."},"locale":{"type":"string","default":"en-US","description":"Language or language-COUNTRY code."},"place_type":{"enum":["all","accommodation","attraction","attraction_product","eatery","geo"],"type":"string","default":"all","description":"Result entity type."},"tripadvisor_domain":{"type":"string","default":"www.tripadvisor.com","description":"Localized Tripadvisor hostname."}}},"responseSchema":{"type":"object","properties":{"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"search_results":{"type":"array","items":{"type":"object"},"description":"Places: name, place type, rating, review count, location, place_id."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_437NzMreg5jlVdxaTeEmq","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Searches Tripadvisor by text and returns structured place results including name, type, rating, review count, location, and place_id.","exampleAgentPrompt":"Search Tripadvisor for the top-rated Italian restaurants in Florence, Italy — show me up to 20 results including their ratings and review counts.","exampleUseCases":[{"title":"Hotel search for city trip","prompt":"Search Tripadvisor for hotels in Amsterdam — I want accommodation options with ratings and review counts so I can compare them before booking."},{"title":"Tourist attractions near coordinates","prompt":"Find tourist attractions on Tripadvisor near latitude 48.8566, longitude 2.3522 — that's central Paris — and give me up to 30 results with their ratings."},{"title":"Restaurant discovery in foreign language","prompt":"Search Tripadvisor for eateries in Tokyo using the Japanese locale ja-JP and the tripadvisor.jp domain — I want local restaurant listings with ratings and place IDs."}],"resultDescription":"Returns an array of search_results where each item includes the place name, place type (accommodation/attraction/eatery/geo), star rating, review count, location details, and a place_id usable with Tripadvisor place-detail and reviews endpoints. Also includes search_metadata (request ID, status, time taken), search_parameters (normalized inputs), and a pagination object with a next-page URL when more results exist.","failureModes":["Missing required 'q' parameter returns a 400 error with error_code and error message","lat provided without lon (or vice versa) causes a parameter validation error","Invalid place_type enum value returns an error response","geo_id not recognized by Tripadvisor returns empty search_results","Pagination offset (start) beyond available results returns empty search_results","Rate limiting or upstream Tripadvisor service unavailability returns a retryable error with retryable:true"],"whenToPreferThis":"Use this endpoint when you need to search Tripadvisor specifically for travel-related places — hotels, restaurants, attractions, or geographic areas — and require structured data (ratings, review counts, place IDs) for downstream processing such as fetching detailed reviews. Prefer this over generic web search when you need Tripadvisor-native place_ids for chaining with place-detail or reviews endpoints, or when filtering by place type, geography, or locale matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:19.838Z","isFirstParty":false}