Start building

Tripadvisor Search API docs

Open Playground →

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/tripadvisor/search
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/tripadvisor/search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "q": "hotels in Austin Texas",
  "num": 30,
  "start": 0,
  "locale": "en-US",
  "place_type": "all"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

qstringrequired

Search text, 1 to 500 characters.

tripadvisor_domainstring

Supported first-party localized Tripadvisor hostname, such as www.tripadvisor.co.uk.

localestring

Lowercase language code with an optional uppercase country, such as en or en-US.

Default: "en-US"

geo_idinteger

Tripadvisor geography ID to search within.

latnumber

Search center latitude from -90 through 90. Requires lon.

lonnumber

Search center longitude from -180 through 180. Requires lat.

place_typestring

Restrict results to one entity type.

Default: "all"

Possible values: all, accommodation, attraction, attraction_product, eatery, geo

startinteger

Result offset from 0 through 10,000. Offsets and positions count any leading exact match.

Default: 0

numinteger

Maximum number of search_results, 1 through 30, including any leading exact match.

Default: 30

timeoutnumber

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 an

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.