API Reference

Search Nearby Locations Catalog

get
https://terra.tripadvisor.com/api/catalog/locations/nearby

Searches the Location catalog for points of interest within a geographic area, ordered by proximity or rating.

The search area is defined either by a center point and radius or by a bounding box, supplied via the search parameters. This endpoint is not limited by a partner's allowlist or geofencing, but each result returns only the lightweight catalog projection of a Location.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The ID of the Location to use as a reference for the radius-based search.

Required if `lat` or `lon` is not given.

number
-90 to 90

The latitude of the center point for the radius-based search.

Required if `location_id` not given.

number
-180 to 180

The longitude of the center point for the radius-based search.

Required if `location_id` not given.

double
> 0

The radius for the radius-based search.

Required if "Bounding Box" criteria is not given (`sw_lat`, `sw_lon`, `ne_lat`, `ne_lon`).

string
Defaults to MI

Unit of length for distance. If none specified defaults to miles.

string
-90 to 90

Bounding Box southwest latitude coordinate.

Required if `radius` is not given.

string
-180 to 180

Bounding Box southwest longitude coordinate.

Required if `radius` is not given.

string
-90 to 90

Bounding Box northeast latitude coordinate.

Required if `radius` is not given.

string
-180 to 180

Bounding Box northeast longitude coordinate.

Required if `radius` is not given.

string
enum

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

Allowed:
string
1 to 5

Filter by ratings with at least N bubbles (1.0-5.0).

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.

sort
array of strings
Defaults to rating,desc

Sorting criteria in the format: property,(asc|desc). Multiple sort criteria are supported. Available sorting: distance (for radius-based search only), rating

sort
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