Get Results

curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'

{
  "review_id": "<string>",
  "url": "<string>",
  "title": "<string>",
  "rating": 123,
  "travel_date": "<string>",
  "published_date": {},
  "created_date": "<string>",
  "text": "<string>",
  "trip_type": "<string>",
  "helpful_votes": 123,
  "publish_platform": "<string>",
  "room_tip": "<string>",
  "lang": "<string>",
  "original_language": "<string>",
  "status": "<string>",
  "subratings": "<any>",
  "photos": "<any>",
  "photo_ids": "<any>",
  "translation_type": "<string>",
  "mt_provider_id": 123,
  "product_name": "<string>",
  "user_id": "<string>",
  "user_name": "<string>",
  "username": "<string>",
  "is_user_verified": true,
  "user_location": "<string>",
  "user_location_id": 123,
  "user_location_name": "<string>",
  "user_total_contributions": 123,
  "user_helpful_votes": 123,
  "user_avatar_id": "<string>",
  "user_avatar_photo_sizes": "<any>",
  "user_profile_link": "<string>",
  "owner_response_id": "<string>",
  "owner_response_text": "<string>",
  "owner_response_lang": "<string>",
  "owner_response_published_date": "<string>",
  "responder": "<string>",
  "owner_connection_to_subject": "<string>",
  "place_id": "<string>",
  "place_name": "<string>",
  "place_type": "<string>",
  "place_category": "<string>",
  "place_total_reviews": 123,
  "place_web_url": "<string>",
  "alert_status": true,
  "scraping_time": {}
}

GET

results

Get Results

curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'

{
  "review_id": "<string>",
  "url": "<string>",
  "title": "<string>",
  "rating": 123,
  "travel_date": "<string>",
  "published_date": {},
  "created_date": "<string>",
  "text": "<string>",
  "trip_type": "<string>",
  "helpful_votes": 123,
  "publish_platform": "<string>",
  "room_tip": "<string>",
  "lang": "<string>",
  "original_language": "<string>",
  "status": "<string>",
  "subratings": "<any>",
  "photos": "<any>",
  "photo_ids": "<any>",
  "translation_type": "<string>",
  "mt_provider_id": 123,
  "product_name": "<string>",
  "user_id": "<string>",
  "user_name": "<string>",
  "username": "<string>",
  "is_user_verified": true,
  "user_location": "<string>",
  "user_location_id": 123,
  "user_location_name": "<string>",
  "user_total_contributions": 123,
  "user_helpful_votes": 123,
  "user_avatar_id": "<string>",
  "user_avatar_photo_sizes": "<any>",
  "user_profile_link": "<string>",
  "owner_response_id": "<string>",
  "owner_response_text": "<string>",
  "owner_response_lang": "<string>",
  "owner_response_published_date": "<string>",
  "responder": "<string>",
  "owner_connection_to_subject": "<string>",
  "place_id": "<string>",
  "place_name": "<string>",
  "place_type": "<string>",
  "place_category": "<string>",
  "place_total_reviews": 123,
  "place_web_url": "<string>",
  "alert_status": true,
  "scraping_time": {}
}

Retrieve scraped data from your TripAdvisor Reviews Scraper runs.

Headers

Authorization

string

required

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squid

string

required

Hash of the squid to get results from

run

string

Hash of a specific run (optional)

page

integer

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

review_id

string

Review identifier. Example: 1052053091

url

string

Direct URL to the review on TripAdvisor. Example:

https://www.tripadvisor.com/ShowUserReviews-g60763-d208453-r1052053091-Hilton_New_York_Times_Square-New_York_City_New_York.html

title

string

Title or headline of the review. Example: Excellent hotel

rating

integer

Rating score. Example: 5

travel_date

string

Travel or visit date. Example: 2026-02

published_date

datatime

Publication date. Example: 2026-03-05

created_date

string

Creation date. Example: 2026-03-05

text

Text content. Example: `Hotel with excellent location, perfectly connected by metro and therefore ideal for getting around the city easily. The rooms are clean, tidy and very comfortable, with a really breathtaking view.The breakfast is rich and of great quality, with a wide choice of both continental products and English breakfast, all nice and well presented.Special thanks go to the breakfast staff, Ciro and Francisco, who stood out for their professionalism, kindness and friendliness. They made the experience even more enjoyable, showing great attention to me and my friends.Thank you very much to Ciro and Francisco!`

trip_type

string

Type of trip (solo, family, business, couple). Example: FRIENDS

helpful_votes

integer

Number of helpful votes. Example: 0

publish_platform

string

Platform where content was published. Example: MOBILE

room_tip

text

Reviewer’s tip about the room

lang

string

Language code. Example: en

original_language

string

Original language. Example: it

status

string

Current status of the review on TripAdvisor. Example: PUBLISHED

subratings

json

Detailed sub-category ratings

photos

json

List of photo URLs

photo_ids

json

List of photo IDs attached to the review

translation_type

string

Type of translation applied to the review content. Example: MACHINE

mt_provider_id

integer

Machine translation provider identifier. Example: 10

product_name

string

Name of the product or experience being reviewed. Example: Hilton New York Times Square

user_id

string

Unique identifier of the reviewer on TripAdvisor. Example: 49137FAFD99CA18EC8122D6D5E16D5B1

user_name

string

Full name of the reviewer. Example: Giovanni

username

string

Username/handle of the reviewer on TripAdvisor. Example: GiovanniMaro

is_user_verified

boolean

Whether user is verified. Example: false

user_location

string

User’s stated location. Example: Sicily, Italy

user_location_id

integer

User location identifier. Example: 187886

user_location_name

string

User location name. Example: Sicily

user_total_contributions

integer

Total number of contributions (reviews, photos) by the reviewer. Example: 4

user_helpful_votes

integer

Number of helpful votes received by the reviewer. Example: 0

user_avatar_id

string

Identifier of the reviewer’s avatar image. Example: 452386603

user_avatar_photo_sizes

json

Available sizes for the reviewer’s avatar photo. Example:

[{'url': 'https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/df/2b/default-avatar-2020-39.jpg', 'width': 1200, 'height': 1200}]

user_profile_link

string

URL to the reviewer’s TripAdvisor profile. Example: https://www.tripadvisor.com/Profile/GiovanniMaro

owner_response_id

string

Unique identifier of the business owner’s response. Example: 1052223597

owner_response_text

text

Text of the business owner’s reply to the review. Example:

Dear Giovanni,   It was a pleasure having you stay with us, and we're delighted to hear that your visit left such a positive impression. Our location in the heart of the area makes exploring the city easy, and it's wonderful to know our accommodations provided the comfort, cleanliness, and memorable views that helped make your stay special. We're also glad you enjoyed starting your day with our breakfast, and your kind recognition of Ciro and Francisco will mean so much to them. Their professionalism, warmth, and attentive service reflect the hospitality we strive to provide every day. Thank you for choosing to stay with us and for taking a moment to share your experience. We would love the opportunity to welcome you back to Hilton Times Square whenever your travels bring you this way again.

owner_response_lang

string

Language of owner’s response. Example: en

owner_response_published_date

string

Date the business owner’s response was published. Example: 2026-03-07

responder

string

Name or identifier of the person who responded on behalf of the business. Example: Front Desk

owner_connection_to_subject

string

Owner’s connection type to the listing. Example: General Manager

place_id

string

Place identifier. Example: 208453

place_name

string

Place name. Example: Hilton New York Times Square

place_type

string

Type of place. Example: ACCOMMODATION

place_category

string

Category of the reviewed place (e.g. restaurant, hotel). Example: HOTEL

place_total_reviews

integer

Total number of reviews for the reviewed place. Example: 8935

place_web_url

string

TripAdvisor URL of the reviewed place. Example: https://www.tripadvisor.com/Hotel_Review-g60763-d208453-Reviews-Hilton_New_York_Times_Square-New_York_City_New_York.html

alert_status

boolean

Alert or notification status. Example: false

scraping_time

datetime

Timestamp when the review was scraped. Example: 2026-03-21T20:39:38Z

Update Settings Add Tasks

​Headers

​Query Parameters

​Result Fields

Headers

Query Parameters

Result Fields