Tripadvisor

List Tripadvisor hotel reviews

List the reviews of a Tripadvisor hotel, newest first, with ratings, aspect scores, trip details and owner replies.

GET/v1/tripadvisor/hotels/{locationId}/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
locationIdintegerrequiredpath

Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search.

≥ 1 · ≤ 2147483647

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page.

min 1 chars · max 1024 chars · pattern: ^[A-Za-z0-9_-]+$

Response fields
46

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.

datatotalCount
integernullable

Reviews in the list: those the US English site shows, written in English or translated into it.

Reviews on this page, newest first.

datareviews[]id
string

Review id.

datareviews[]url
stringnullable

The review's own Tripadvisor page.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

Review text.

datareviews[]rating
integernullable

The reviewer's rating, 1 to 5.

datareviews[]language
stringnullable

Language of `text`, e.g. `en`.

datareviews[]originalLanguage
stringnullable

Language the reviewer wrote in. Differs from `language` when the site translated the review.

datareviews[]translated
boolean

Whether `title` and `text` are the site's machine translation.

datareviews[]publishedAt
stringnullable

When it was posted, ISO 8601.

datareviews[]travelDate
stringnullable

When the reviewer stayed or visited, `YYYY-MM`.

datareviews[]tripType
stringnullable

Who they travelled with, in lower case: `couples`, `family`, `friends`, `solo` or `business`.

datareviews[]helpfulVotes
integernullable

Readers who found it helpful.

datareviews[]pinned
boolean

Whether the owner pinned it to the top of the place's reviews. A pinned review comes first on the first page only, whatever its date.

The reviewer's ratings per aspect, when given.

datareviews[]subratings[]name
string

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

datareviews[]subratings[]rating
numbernullable

Average rating, 1 to 5.

Photo URLs the reviewer added. Links only; not hosted by Social Fetch.

datareviews[]photos[]
stringoptional

Who wrote it.

datareviews[]authorname
stringnullable

Name the reviewer shows.

datareviews[]authorusername
stringnullable

The reviewer's Tripadvisor username.

datareviews[]authorprofileUrl
stringnullable

The reviewer's Tripadvisor profile page.

datareviews[]authoravatar
stringnullable

Avatar image URL. Link only; not hosted by Social Fetch.

datareviews[]authorhometown
stringnullable

Hometown the reviewer gives.

datareviews[]authorcontributions
integernullable

Reviews, photos and other posts the reviewer has made.

The place's public reply.

datareviews[]ownerResponsetext
string

The reply.

datareviews[]ownerResponsepublishedAt
stringnullable

When it was posted, ISO 8601.

datareviews[]ownerResponseauthorName
stringnullable

Name the responder shows, e.g. the general manager.

datareviews[]ownerResponserole
stringnullable

The responder's role as the site gives it, e.g. `Owner`.

datareviews[]ownerResponselanguage
stringnullable

Language of the reply.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Pass as `cursor` to get the next page; null on the last page.

datapageoffset
integer

Position of this page's first row in the full list.

≥ 0

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/hotels/93450/reviews" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Reviews of a Tripadvisor hotel.