GET/v1/results

Get Results

Retrieve scraped TripAdvisor reviews with ratings, user information, photos, subratings, and owner responses

Retrieve reviews scraped from TripAdvisor places. Each result contains comprehensive review data including ratings, review text, user profiles, travel dates, photos, subratings, owner responses, and place information.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Review Information Fields

review_id

string

Unique TripAdvisor review identifier

Example: 1047155136

url

string

Direct URL to the review on TripAdvisor

Example: https://www.tripadvisor.com/ShowUserReviews-g60763-d208453-r1042814279-...

title

string

Review title/headline

Example: Great front desk people at Hilton Times Square!

text

Full review text content

Example: Hotel was nice, very close to subways and attractions...

rating

integer

Overall rating given by the reviewer (1-5 stars)

Example: 5

travel_date

string

Month and year when the reviewer traveled (YYYY-MM format)

Example: 2025-12

published_date

datetime

Date when the review was published on TripAdvisor

Example: 2025-12-17

created_date

string

Date when the review was created

Example: 2025-12-31

trip_type

string

Type of trip (e.g., BUSINESS, LEISURE, FAMILY)

Example: BUSINESS

helpful_votes

integer

Number of helpful votes the review received

Example: 0

publish_platform

string

Platform where the review was published

Example: OTHER

room_tip

textnull

Optional room tip provided by the reviewer

Example: null

lang

string

Language code of the review

Example: en

original_language

string

Original language code before any translation

Example: en

status

string

Publication status of the review

Example: PUBLISHED

subratings

json

Detailed subratings for specific aspects (Value, Rooms, Location, Cleanliness, Service, Sleep Quality)

Example: {Value: 5, Rooms: 4, Location: 5, Cleanliness: 4, Service: 4, Sleep Quality: 5}

photos

json

Array of photo objects with URLs and dimensions

Example: [{id: 841562802, statuses: [PUBLISHED], photoSizes: [...]}]

likes_count

integer

Number of likes the review received

Example: 0

Reviewer Information Fields

user_id

string

Unique TripAdvisor user identifier

Example: E0A07C9AA5F4BF39F157B7BC057D5A8F

user_name

string

Display name of the reviewer

Example: Escape53349593856

username

string

Username of the reviewer

Example: Escape53349593856

is_user_verified

boolean

Whether the user account is verified

Example: false

user_location

stringnull

Location of the reviewer

Example: null

user_location_id

integernull

TripAdvisor location ID of the reviewer's location

Example: null

user_location_name

stringnull

Name of the reviewer's location

Example: null

user_total_contributions

integer

Total number of contributions by the user

Example: 1

user_total_likes

integer

Total likes received by the user

Example: 0

user_helpful_votes

integer

Total helpful votes received by the user

Example: 0

user_is_following

boolean

Whether the user is following the place

Example: false

user_avatar_id

string

ID of the user's avatar image

Example: 452391908

user_avatar_photo_sizes

json

Array of avatar image URLs in different sizes

Example: [{url: https://dynamic-media-cdn.tripadvisor.com/..., width: 0, height: 0}]

user_profile_link

string

URL to the reviewer's TripAdvisor profile

Example: https://www.tripadvisor.com/Profile/Escape53349593856

Owner Response Fields

owner_response_id

stringnull

Unique identifier for the owner's response

Example: 1042950858

owner_response_text

textnull

Text content of the owner's response

Example: We're so happy to know that you enjoyed everything...

owner_response_lang

stringnull

Language code of the owner's response

Example: en

owner_response_published_date

stringnull

Date when the owner's response was published

Example: 2025-12-18

responder

stringnull

Title/role of the person who responded

Example: General Manager

owner_connection_to_subject

stringnull

Relationship of the responder to the business

Example: General Manager

Place Information Fields

place_id

string

TripAdvisor place identifier

Example: 208453

place_name

string

Name of the place

Example: Hilton New York Times Square

place_type

string

Type of place (ACCOMMODATION, RESTAURANT, ATTRACTION)

Example: ACCOMMODATION

place_category

string

Specific category within the place type

Example: HOTEL

place_rating

float

Overall average rating of the place

Example: 4.3

place_total_reviews

integer

Total number of reviews for the place

Example: 8919

place_parent_geo_id

integer

Geographic location ID of the place

Example: 60763

place_city

string

City where the place is located

Example: New York City

place_state

string

State/region where the place is located

Example: New York

place_web_url

string

URL to the place's TripAdvisor page

Example: https://www.tripadvisor.com/Hotel_Review-g60763-d208453-Reviews-...

place_rating_count_1

integer

Number of 1-star reviews

Example: 270

place_rating_count_2

integer

Number of 2-star reviews

Example: 292

place_rating_count_3

integer

Number of 3-star reviews

Example: 705

place_rating_count_4

integer

Number of 4-star reviews

Example: 2570

place_rating_count_5

integer

Number of 5-star reviews

Example: 5082

review_counts_by_language

json

Breakdown of review counts by language

Example: {en: 7849, es: 170, pt: 219, de: 151, fr: 173}

is_local_provider

boolean

Whether the place is a local provider

Example: true

is_tools_provider

boolean

Whether the place uses TripAdvisor tools

Example: true

alert_status

boolean

Alert status for the place

Example: false

Metadata Fields

integer

Unique identifier for this result record

Example: 335315

object

string

Object type, always "result"

Example: result

squid

string

Hash ID of the squid that produced this result

Example: c7ea965333d54a949a9e74ba62029098

run

string

Hash ID of the run during which this result was scraped

Example: 31679d8916d946848c3ba442a381e130

scraping_time

datetime

ISO timestamp when the review was fetched

Example: 2025-12-17T20:14:05Z

native_id

integer

Native numeric ID matching the id field

Example: 335315

functions

objectnull

Reserved for function-specific metadata

Example: null

Parameters

squidstring

Required

The squid hash ID to get results from

runstring

Optional

Filter results by specific run hash ID

pageinteger

Optional

Page number for pagination (default: 1)

page_sizeinteger

Optional

Number of results per page (default: 100, max: 1000)

Pro Tip

Use the subratings field to analyze specific aspects of customer satisfaction (e.g., Location, Cleanliness, Service) beyond the overall rating.

Pro Tip

Check owner_response_text to see how businesses engage with their reviewers - valuable for competitive analysis and customer service insights.

Note

The photos array contains multiple size variants of each image. Use the largest size for high-quality display or smaller sizes for thumbnails.