Tripadvisor

Search Tripadvisor places

Search Tripadvisor for cities, hotels, restaurants and attractions by name, with location ids, coordinates and page links.

GET/v1/tripadvisor/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

What to look for: a place, hotel, restaurant or attraction name, e.g. `eiffel tower` or `savoy london`.

min 1 chars · max 100 chars

typestringoptionalquery

Only matches of this kind: `geo` (cities and regions), `hotel`, `restaurant` or `attraction`. Omit for every kind.

one of: geo, hotel, restaurant, attraction

Response fields
17

Endpoint-specific response payload.

dataquery
string

The query searched for.

Matches, best first; empty when nothing matches.

dataresults[]locationId
integer

Location id: pass it to the hotel, restaurant or attraction endpoints, or as `geoId` for a `geo` match.

dataresults[]type
string

Kind of match: `geo`, `hotel`, `restaurant`, `attraction`, or another kind the site names, in lower case.

dataresults[]name
string

Name with its location, as the site shows it, e.g. `The Savoy, London, England, United Kingdom`.

dataresults[]url
stringnullable

The match's Tripadvisor page.

dataresults[]geoId
integernullable

Geo id of the city or region the match is in.

Latitude and longitude.

dataresults[]coordinateslatitude
number
dataresults[]coordinateslongitude
number

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/tripadvisor/search?query=eiffel%20tower" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Tripadvisor places, hotels, restaurants and attractions.