Search Tripadvisor
litescrape.tripadvisor.search.generalReturns Tripadvisor hotels, restaurants, attractions and places in `search_results`
- Price
- $0.00015/successAt provider cost
- Success rate
- —No success-rate data yetNo success-rate data yet
- Latency p50
- ——
- Last verified
- Sep 29, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.tripadvisor.search.general?q=hotels+in+Austin+TexasPreview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
q | string | Required | Search text, 1 to 500 characters. | coffee |
lat | number | Optional | Search center latitude from -90 through 90. Requires lon. | 30.2672 |
lon | number | Optional | Search center longitude from -180 through 180. Requires lat. | -97.7431 |
num | integer | Optional | Maximum number of search_results, 1 through 30, including any leading exact match. | |
start | integer | Optional | Result offset from 0 through 10,000. Offsets and positions count any leading exact match. | |
geo_id | integer | Optional | Tripadvisor geography ID to search within. | 30196 |
locale | string | Optional | Lowercase language code with an optional uppercase country, such as en or en-US. | |
timeout | number | Optional | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline. | |
place_type | string | Optional | Restrict results to one entity type. | |
tripadvisor_domain | string | Optional | Supported first-party localized Tripadvisor hostname, such as www.tripadvisor.co.uk. | www.tripadvisor.com |
- Query parameters
qstringRequiredSearch text, 1 to 500 characters.
Example:
coffeelatnumberOptionalSearch center latitude from -90 through 90. Requires lon.
Example:
30.2672lonnumberOptionalSearch center longitude from -180 through 180. Requires lat.
Example:
-97.7431numintegerOptionalMaximum number of search_results, 1 through 30, including any leading exact match.
startintegerOptionalResult offset from 0 through 10,000. Offsets and positions count any leading exact match.
geo_idintegerOptionalTripadvisor geography ID to search within.
Example:
30196localestringOptionalLowercase language code with an optional uppercase country, such as en or en-US.
timeoutnumberOptionalOptional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
place_typestringOptionalRestrict results to one entity type.
tripadvisor_domainstringOptionalSupported first-party localized Tripadvisor hostname, such as www.tripadvisor.co.uk.
Example:
www.tripadvisor.com
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.tripadvisor.search.general?q=hotels+in+Austin+Texas' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.tripadvisor.search.general?q=hotels+in+Austin+Texas",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.tripadvisor.search.general?q=hotels+in+Austin+Texas", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.00015/success, including the service fee.