API Reference

Search Locations

get
https://terra.tripadvisor.com/api/locations/search

Finds Locations by free-text name or address.

Use this endpoint to resolve a textual query (for example a business name or street address) into matching Tripadvisor Locations. Results are restricted to Locations you are licensed to access and return the full Location representation.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 1 and 500

Text search query.

string
Defaults to NAME

Searching type.

string

Alpha-2 country code.

string

City, Town, or Country Geo Name.

string

Postal/zip code to further narrow results.

If both `geo_name` and `postal_code` are given, the `postal_code` takes precedence in case they do not resolve.

string
enum

Filter based on Tripadvisor’s top-level categories (eat & drink, accommodations, attractions).

Allowed:
locale
array of strings

preferred locales for localized fields (e.g. names, descriptions), in priority order; falls back to the default locale when omitted

locale
integer
≥ 1

Page index (1-based).

integer
≤ 20
Defaults to 20

Page size.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 2 months ago