Skip to main content
GET
/
v1
/
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": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

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
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