Skip to content
Examples

Get Results

Retrieve scraped data from TripAdvisor Restaurants Search Export

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 Restaurants Search Export 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:

urlstring

Direct URL to the restaurant listing on TripAdvisor. Example: https://www.tripadvisor.fr/Restaurant_Review-g187147-d12182791-Reviews-Restaurant_La_Pie_Noir-Paris_Ile_de_France.html

internal_idstring

Unique internal identifier for the restaurant on TripAdvisor. Example: d12182791

namestring

Name of the restaurant as listed on TripAdvisor. Example: Restaurant La Pie Noir

scorefloat

Average TripAdvisor rating out of 5. Example: 4.7

ratingsint

Total number of customer reviews on TripAdvisor. Example: 665

pricestring

Price range indicator (e.g. $, $$, $$$). Example: €€-€€€

featuresstring

Cuisine types and dining features listed on TripAdvisor. Example: Française, Européenne

full_addressstring

Full formatted address of the restaurant. Example: 5 Rue de la Montagne Sainte Genevieve, Paris, Île-de-France, 75005, FR

latfloat

Latitude coordinate of the restaurant. Example: 48.849335

lngfloat

Longitude coordinate of the restaurant. Example: 2.34875

phonestring

Contact phone number of the restaurant. Example: +33 1 43 54 08 99

websitestring

Official website URL of the restaurant

menutext

URL to the restaurant's menu on TripAdvisor or its website

mailstring

Email address of the restaurant. Example: restaurant.lapienoir.bzh@gmail.com

image_urlstring

URL of the restaurant's main cover image on TripAdvisor. Example: https://dynamic-media-cdn.tripadvisor.com/media/photo-o/19/7a/08/cf/side-view-from-the-street.jpg

is_claimedboolean

Whether the restaurant has claimed its TripAdvisor listing. Example: false

is_michelinboolean

Whether the restaurant is in the MICHELIN Guide, stars and Bib Gourmand included. Example: false

michelin_awardstring

The restaurant's MICHELIN Guide distinction, as TripAdvisor names it: MICHELIN 3 Stars, MICHELIN 2 Stars, MICHELIN 1 Star, MICHELIN Bib Gourmand, or MICHELIN Guide for a selected restaurant without a star. null when the restaurant is not in the guide. Example: MICHELIN 1 Star

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 30880,
      "object": "result",
      "squid": "ca2852c60196302c6e4c1e18001a204b",
      "run": "93284ed660634fd6d188365ce304cf35",
      "url": "https://www.tripadvisor.fr/Restaurant_Review-g187147-d12182791-Reviews-Restaurant_La_Pie_Noir-Paris_Ile_de_France.html",
      "internal_id": "d12182791",
      "name": "Restaurant La Pie Noir",
      "score": 4.7,
      "ratings": 665,
      "price": "€€-€€€",
      "features": "Française, Européenne",
      "full_address": "5 Rue de la Montagne Sainte Genevieve, Paris, Île-de-France, 75005, FR",
      "lat": 48.849335,
      "lng": 2.34875,
      "phone": "+33 1 43 54 08 99",
      "website": null,
      "menu": null,
      "mail": "restaurant.lapienoir.bzh@gmail.com",
      "image_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/19/7a/08/cf/side-view-from-the-street.jpg",
      "is_claimed": false,
      "is_michelin": false,
      "michelin_award": null,
      "functions": null,
      "native_id": 30880
    }
  ],
  "next": null,
  "previous": null
}