Tripadvisor

Get Tripadvisor place by URL

Get a Tripadvisor hotel, restaurant or attraction from its Tripadvisor URL, with ratings, ranking, address and contact details.

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

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

A Tripadvisor hotel, restaurant or attraction page, e.g. `https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html`.

min 1 chars · max 2048 chars

Response fields
60

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no place of this kind has this id.

one of: found, not_found

datalocationId
integer

The location id asked for.

A Tripadvisor place.

dataplacelocationId
integer

Tripadvisor location id.

dataplacetype
string

Kind of place: `hotel`, `restaurant` or `attraction`.

one of: hotel, restaurant, attraction

dataplacename
string

Name of the place.

dataplaceurl
string

The place's Tripadvisor page.

dataplacegeoId
integernullable

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

dataplacerating
numbernullable

Average traveller rating, 1 to 5, to one decimal.

dataplacereviewCount
integernullable

Reviews in every language.

How many reviews gave each rating, 1 to 5.

dataplaceratingCounts1
integernullable

Reviews rating it 1.

dataplaceratingCounts2
integernullable

Reviews rating it 2.

dataplaceratingCounts3
integernullable

Reviews rating it 3.

dataplaceratingCounts4
integernullable

Reviews rating it 4.

dataplaceratingCounts5
integernullable

Reviews rating it 5.

Reviewers' averages per aspect; empty when the site shows none.

dataplacesubratings[]name
string

What was rated, e.g. `Location`, `Cleanliness`, `Food`.

dataplacesubratings[]rating
numbernullable

Average rating, 1 to 5.

dataplaceranking
stringnullable

Rank in its city as the site words it, e.g. `#420 of 530 hotels in New York City`.

Where the place is.

dataplaceaddressline1
stringnullable

First address line, e.g. `109 East 42nd Street`.

dataplaceaddressline2
stringnullable

Second address line.

dataplaceaddresscity
stringnullable

City.

dataplaceaddressregion
stringnullable

State or region.

dataplaceaddresspostalCode
stringnullable

Postal code.

dataplaceaddresscountry
stringnullable

Country, as the site gives it: a name or a two-letter code.

dataplaceaddressformatted
stringnullable

The whole address on one line, as the site shows it.

Latitude and longitude.

dataplacecoordinateslatitude
number
dataplacecoordinateslongitude
number
dataplacephone
stringnullable

Phone number as the site shows it.

dataplacewebsite
stringnullable

The place's own website.

dataplacepriceRange
stringnullable

Price level as the site shows it, e.g. `$$ - $$$`.

dataplaceimage
stringnullable

Main photo URL. Link only; not hosted by Social Fetch.

dataplaceisClosed
booleannullable

Whether the site lists the place as closed.

dataplacedescription
stringnullable

The place's own description, when the site shows one.

Kinds of attraction the site files it under, e.g. `Observation Decks & Towers`; empty for other places.

dataplacecategories[]
stringoptional

Opening hours as the site gives them, one entry per span, e.g. `Monday 11:45-14:30`; null when it gives none.

dataplaceopeningHours[]
stringoptional

Cuisines a restaurant serves; empty for other places.

dataplacecuisines[]
stringoptional

Amenities a hotel lists; empty for other places.

dataplaceamenities[]name
string

Amenity, e.g. `Free High Speed Internet (WiFi)`.

dataplaceamenities[]value
boolean

Whether the place has it.

Room features a hotel lists, e.g. `Air conditioning`, `Desk`; empty for other places.

dataplaceroomFeatures[]
stringoptional

Languages a hotel's staff speak, e.g. `English`, `Spanish`; empty for other places.

dataplacelanguages[]
stringoptional

Hotel styles the site ranks it for, e.g. `Quiet`, `Family`.

dataplacestyles[]
stringoptional
dataplaceroomCount
integernullable

Rooms a hotel has; null for other places or when not given.

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/place?url=https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Tripadvisor hotel, restaurant or attraction.