Skip to content
Examples

Get Results

Retrieve scraped data from TripAdvisor Restaurant Details 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 Restaurant Details Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY.

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

pageintegerquery

Page number (default: 1).

Result Fields

Export Details

urlstring

TripAdvisor URL of the restaurant. When the same restaurant is submitted on several TripAdvisor domains, the first URL collected is kept. Example: https://www.tripadvisor.com/Restaurant_Review-g187175-d806529-Reviews-Michel_Sarran-Toulouse_Haute_Garonne_Occitanie.html

place_idinteger

TripAdvisor internal identifier of the restaurant, identical on every TripAdvisor domain. One row per place_id. Example: 806529

namestring

Name of the restaurant as listed on TripAdvisor. Example: Michel Sarran

is_closedboolean

Whether TripAdvisor flags the restaurant as permanently closed. Example: false

ranking_rankinteger

Position of the restaurant in its city ranking. Empty when the listing is closed or delisted. Example: 13

ranking_denominatorinteger

Total number of restaurants the city ranking is computed against. Example: 1996

ranking_citystring

City the ranking refers to. Example: Toulouse

ranking_textstring

Raw ranking sentence as displayed by TripAdvisor. Empty when the listing is closed or delisted. Example: #13 of 1,996 Restaurants in Toulouse

overall_ratingfloat

Average TripAdvisor rating out of 5. Example: 4.7

review_countinteger

Total number of reviews on TripAdvisor. Example: 1636

rating_count_1integer

Number of 1-star reviews. Example: 4

rating_count_2integer

Number of 2-star reviews. Example: 19

rating_count_3integer

Number of 3-star reviews. Example: 90

rating_count_4integer

Number of 4-star reviews. Example: 196

rating_count_5integer

Number of 5-star reviews. Example: 1327

subrating_foodfloat

Aggregate food sub-rating out of 5. 0 means the dimension has never been rated. Example: 4.75

subrating_servicefloat

Aggregate service sub-rating out of 5. 0 means the dimension has never been rated. Example: 4.72

subrating_valuefloat

Aggregate value-for-money sub-rating out of 5. 0 means the dimension has never been rated. Example: 4.35

subrating_atmospherefloat

Aggregate atmosphere sub-rating out of 5. 0 means the dimension has never been rated. Example: 4.37

travelers_choice_award_typestring

TripAdvisor Travelers' Choice award code for the active year (e.g. COE, BOTB). Empty when the restaurant has no award. Example: COE

travelers_choice_yearinteger

Year of the Travelers' Choice award. Empty when the restaurant has no award. Example: 2026

is_michelinboolean

Whether the restaurant carries a MICHELIN Guide award on its TripAdvisor page. Example: true

michelin_starsinteger

Number of MICHELIN stars. Empty for a MICHELIN distinction that is not a star (e.g. Bib Gourmand). Example: 1

michelin_yearinteger

Year of the MICHELIN award. Example: 2026

cuisinesjson

Cuisine types listed on TripAdvisor. Example: ["French", "European", "Healthy"]

price_rangestring

Price range indicator. Example: $$$$

addressstring

Full formatted address of the restaurant. Example: 21 Boulevard Armand Duportal, 31000, Toulouse France

phonestring

Contact phone number of the restaurant. Example: +33 5 61 12 32 32

emailstring

Contact email address published by the restaurant on TripAdvisor. Empty when the restaurant has not published one. Example: contact@michel-sarran.com

websitestring

Official website URL of the restaurant. Example: http://www.michel-sarran.com

latfloat

Latitude coordinate of the restaurant. Example: 43.607277

lngfloat

Longitude coordinate of the restaurant. Example: 1.434596

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=YOUR_SQUID_HASH" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"url": "https://www.tripadvisor.com/Restaurant_Review-g187175-d806529-Reviews-Michel_Sarran-Toulouse_Haute_Garonne_Occitanie.html", "place_id": 806529, "name": "Michel Sarran", "is_closed": false, "ranking_rank": 13, "ranking_denominator": 1996, "ranking_city": "Toulouse", "ranking_text": "#13 of 1,996 Restaurants in Toulouse", "overall_rating": 4.7, "review_count": 1636, "rating_count_1": 4, "rating_count_2": 19, "rating_count_3": 90, "rating_count_4": 196, "rating_count_5": 1327, "subrating_food": 4.75, "subrating_service": 4.72, "subrating_value": 4.35, "subrating_atmosphere": 4.37, "travelers_choice_award_type": "COE", "travelers_choice_year": 2026, "is_michelin": true, "michelin_stars": 1, "michelin_year": 2026, "cuisines": ["French", "European", "Healthy"], "price_range": "$$$$", "address": "21 Boulevard Armand Duportal, 31000, Toulouse France", "phone": "+33 5 61 12 32 32", "email": "contact@michel-sarran.com", "website": "http://www.michel-sarran.com", "lat": 43.607277, "lng": 1.434596}]}