Skip to content
Examples

Get Results

Retrieve scraped data from TripAdvisor Reviews Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your TripAdvisor Reviews Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

review_idstring

Review identifier. Example: 1052053091

urlstring

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

titlestring

Title or headline of the review. Example: Excellent hotel

ratinginteger

Rating score. Example: 5

travel_datestring

Travel or visit date. Example: 2026-02

published_datedatatime

Publication date. Example: 2026-03-05

created_datestring

Creation date. Example: 2026-03-05

texttext

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_typestring

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

helpful_votesinteger

Number of helpful votes. Example: 0

publish_platformstring

Platform where content was published. Example: MOBILE

room_tiptext

Reviewer's tip about the room

langstring

Language code. Example: en

original_languagestring

Original language. Example: it

statusstring

Current status of the review on TripAdvisor. Example: PUBLISHED

subratingsjson

Detailed sub-category ratings

photosjson

List of photo URLs

photo_idsjson

List of photo IDs attached to the review

translation_typestring

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

mt_provider_idinteger

Machine translation provider identifier. Example: 10

product_namestring

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

user_idstring

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

user_namestring

Full name of the reviewer. Example: Giovanni

usernamestring

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

is_user_verifiedboolean

Whether user is verified. Example: false

user_locationstring

User's stated location. Example: Sicily, Italy

user_location_idinteger

User location identifier. Example: 187886

user_location_namestring

User location name. Example: Sicily

user_total_contributionsinteger

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

user_helpful_votesinteger

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

user_avatar_idstring

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

user_avatar_photo_sizesjson

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_linkstring

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

owner_response_idstring

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

owner_response_texttext

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_langstring

Language of owner's response. Example: en

owner_response_published_datestring

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

responderstring

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

owner_connection_to_subjectstring

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

place_idstring

Place identifier. Example: 208453

place_namestring

Place name. Example: Hilton New York Times Square

place_typestring

Type of place. Example: ACCOMMODATION

place_categorystring

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

place_total_reviewsinteger

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

place_web_urlstring

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_statusboolean

Alert or notification status. Example: false

scraping_timedatetime

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

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 82832,
      "object": "result",
      "squid": "8022c63552775d4b1f2e07e05e3387e4",
      "run": "f027c59d81e7a2954f7a6bd9b1c7c0b3",
      "review_id": "1052053091",
      "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d208453-r1052053091-Hilton_New_York_Times_Square-New_York_City_New_York.html",
      "title": "Excellent hotel",
      "rating": 5,
      "travel_date": "2026-02",
      "published_date": "2026-03-05",
      "created_date": "2026-03-05",
      "text": "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.\n\nThe breakfast is rich and of great quality, with a wide choice of both continental products and English breakfast, all nice and well presented.\n\nSpecial 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.\n\nThank you very much to Ciro and Francisco!",
      "trip_type": "FRIENDS",
      "helpful_votes": 0,
      "publish_platform": "MOBILE",
      "room_tip": null,
      "lang": "en",
      "original_language": "it",
      "status": "PUBLISHED",
      "subratings": null,
      "photos": null,
      "photo_ids": null,
      "translation_type": "MACHINE",
      "mt_provider_id": 10,
      "product_name": "Hilton New York Times Square",
      "user_id": "49137FAFD99CA18EC8122D6D5E16D5B1",
      "user_name": "Giovanni",
      "username": "GiovanniMaro",
      "is_user_verified": false,
      "user_location": "Sicily, Italy",
      "user_location_id": 187886,
      "user_location_name": "Sicily",
      "user_total_contributions": 4,
      "user_helpful_votes": 0,
      "user_avatar_id": "452386603",
      "user_avatar_photo_sizes": [
        {
          "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": "https://www.tripadvisor.com/Profile/GiovanniMaro",
      "owner_response_id": "1052223597",
      "owner_response_text": "Dear Giovanni,\nIt 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": "en",
      "owner_response_published_date": "2026-03-07",
      "responder": "Front Desk",
      "owner_connection_to_subject": "General Manager",
      "place_id": "208453",
      "place_name": "Hilton New York Times Square",
      "place_type": "ACCOMMODATION",
      "place_category": "HOTEL",
      "place_total_reviews": 8935,
      "place_web_url": "https://www.tripadvisor.com/Hotel_Review-g60763-d208453-Reviews-Hilton_New_York_Times_Square-New_York_City_New_York.html",
      "alert_status": false,
      "scraping_time": "2026-03-21T20:39:38Z",
      "functions": null,
      "native_id": 82832
    }
  ],
  "next": null,
  "previous": null
}