{"uid":"cap_1xiPamQWQ8x-e9ZtfTso_","slug":"agents-litescrape-com-search-tripadvisor-a402373a","name":"Search Tripadvisor","description":"Search Tripadvisor hotels, restaurants and attractions.\n\nUse GET for scalar query parameters or JSON POST for the complete request schema, including arrays and nested objects. See the schema for field limits and conditional rules. Failures are not billed.\n\nOptional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback.","url":"https://agents.litescrape.com/api/tripadvisor/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","title":"Q","description":"Required search text, up to 500 characters.","x-litescrape":{"group":0,"label":"Query","summary":"Required search text, up to 500 characters.","formGroup":0,"placeholder":"coffee"}},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat","default":null,"description":"Optional search-center latitude; requires lon.","x-litescrape":{"group":0,"label":"Latitude","summary":"Optional search-center latitude; requires lon.","formGroup":0,"conditional":true,"placeholder":"30.27"}},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon","default":null,"description":"Optional search-center longitude; requires lat.","x-litescrape":{"group":0,"label":"Longitude","summary":"Optional search-center longitude; requires lat.","formGroup":0,"conditional":true,"placeholder":"-97.74"}},"num":{"type":"integer","title":"Num","default":30,"description":"Result count from 1 through 30.","x-litescrape":{"kind":"number","group":0,"label":"Result count","summary":"Result count from 1 through 30.","formGroup":0,"placeholder":"5"}},"start":{"type":"integer","title":"Start","default":0,"description":"Result offset from 0 through 10,000.","x-litescrape":{"kind":"number","group":0,"label":"Start offset","summary":"Result offset from 0 through 10,000.","formGroup":0,"placeholder":"0"}},"geo_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Geo Id","default":null,"description":"Optional positive Tripadvisor geography identifier.","x-litescrape":{"group":0,"label":"Geography ID","summary":"Optional positive Tripadvisor geography identifier.","formGroup":0,"placeholder":"30196"}},"locale":{"type":"string","title":"Locale","default":"en-US","description":"Language or language-COUNTRY code.","x-litescrape":{"group":0,"label":"Locale","summary":"Language or language-COUNTRY code.","formGroup":0,"placeholder":"en-US"}},"timeout":{"type":"number","maximum":90,"description":"Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.","exclusiveMinimum":0},"place_type":{"enum":["all","accommodation","attraction","attraction_product","eatery","geo"],"type":"string","title":"Place Type","default":"all","description":"Result entity type.","x-litescrape":{"kind":"select","group":0,"label":"Place type","options":[{"label":"all","value":"all"},{"label":"accommodation","value":"accommodation"},{"label":"attraction","value":"attraction"},{"label":"attraction_product","value":"attraction_product"},{"label":"eatery","value":"eatery"},{"label":"geo","value":"geo"}],"summary":"Result entity type.","formGroup":0}},"tripadvisor_domain":{"type":"string","title":"Tripadvisor Domain","default":"www.tripadvisor.com","description":"Supported localized Tripadvisor hostname.","x-litescrape":{"group":0,"label":"Tripadvisor domain","summary":"Supported localized Tripadvisor hostname.","formGroup":0,"placeholder":"www.tripadvisor.com"}}}},"responseSchema":{"type":"object","title":"Response","properties":{"pagination":{"anyOf":[{"type":"object","title":"Responsepagination","properties":{"next":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"map_previews":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsemappreviewitem","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"tags":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsemappreviewitemtagitem","properties":{"tagId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tagid","default":null},"categoryId":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Categoryid","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_1d005ef92bf55aae_ref1"}}},{"type":"null"}],"title":"Tags","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","default":null},"gps_coordinates":{"anyOf":[{"type":"object","title":"Responsemappreviewitemgpscoordinates","properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","default":null},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_1d005ef92bf55aae_ref1"}},{"type":"null"}],"default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Map Previews","default":null},"search_results":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsesearchresultitem","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null},"image":{"anyOf":[{"type":"object","title":"Responsesearchresultitemimage","properties":{"max_width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Width","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null},"max_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Height","default":null},"url_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Template","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_1d005ef92bf55aae_ref1"}},{"type":"null"}],"default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","default":null},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null},"max_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Rating","default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null},"detail_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail Type","default":null},"mention_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mention Count","default":null},"place_api_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Api Link","default":null},"position_in_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position In Page","default":null},"reviews_api_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviews Api Link","default":null},"highlighted_spans":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsesearchresultitemhighlightedspanitem","properties":{"length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Length","default":null},"offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Offset","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_1d005ef92bf55aae_ref1"}}},{"type":"null"}],"title":"Highlighted Spans","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Search Results","default":null},"search_metadata":{"anyOf":[{"type":"object","title":"Responsesearchmetadata","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":null},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","default":null},"processed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processed At","default":null},"json_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Json Endpoint","default":null},"total_time_taken":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Time Taken","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_parameters":{"anyOf":[{"type":"object","title":"Responsesearchparameters","properties":{"q":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q","default":null},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat","default":null},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon","default":null},"num":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num","default":null},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start","default":null},"geo_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Geo Id","default":null},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale","default":null},"place_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Type","default":null},"tripadvisor_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tripadvisor Domain","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_information":{"anyOf":[{"type":"object","title":"Responsesearchinformation","properties":{"total_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Results","default":null},"results_on_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Results On Page","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"submit_feedback_for_this_response_here":{"type":"string","format":"uri","readOnly":true,"description":"Optional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback."}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":["search","scraping","travel"],"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-x402","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-11-03T18:41:03.062Z","isFirstParty":false,"canonicalSlug":"agents-litescrape-com-search-tripadvisor-a402373a"}