GET/v1/results

Get Results

Retrieve scraped TripAdvisor restaurant listings with ratings, reviews, and contact information

Retrieve restaurant listings scraped from TripAdvisor search results. Each result contains comprehensive restaurant data including ratings, review counts, price ranges, contact information, location coordinates, menu links, and Michelin status indicators.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Result Fields

integer

Unique identifier for this result record

Example: 335315

object

string

Object type, always "result"

Example: result

squid

string

Hash ID of the squid that produced this result

Example: c7ea965333d54a949a9e74ba62029098

run

string

Hash ID of the run during which this result was scraped

Example: 31679d8916d946848c3ba442a381e130

name

string

Name of the restaurant

Example: Les Cedres Du Liban Paris

full_address

string

Complete address as listed on TripAdvisor

Example: 123 Rue Example, 75001 Paris

lat

number

Latitude coordinate of the restaurant

Example: 48.84455

lng

number

Longitude coordinate of the restaurant

Example: 2.32037

phone

stringnull

Contact phone number if listed

Example: +33 1 42 22 35 18

mail

stringnull

Contact email address if scraped

Example: lescedresduliban@me.com

website

stringnull

Official website URL of the restaurant

Example: https://www.facebook.com/LesCedresDuLiban/

url

string

Full URL to the restaurant's TripAdvisor page

Example: https://www.tripadvisor.fr/Restaurant_Review-g187147-d1109794-Reviews-...

score

number

Average rating score (1.0-5.0)

Example: 5

ratings

integer

Total number of reviews the restaurant has received

Example: 1114

price

string

Price range indicator

Example: \u20ac\u20ac-\u20ac\u20ac\u20ac

image_url

stringnull

URL of the restaurant's main image or thumbnail

Example: https://media-cdn.tripadvisor.com/...

stringnull

URL to the restaurant's menu on TripAdvisor

Example: ""

is_claimed

boolean

True if the business profile is claimed by the owner

Example: false

is_michelin

boolean

True if the restaurant has a Michelin distinction

Example: false

internal_id

string

TripAdvisor's internal identifier for the restaurant

Example: d1109794

scraping_time

string

ISO timestamp when the listing was fetched

Example: 2025-07-31T07:20:13.928Z

native_id

integer

Native numeric ID matching the id field

Example: 335315

functions

objectnull

Reserved for function-specific metadata

Example: null

Parameters

squidstring

Required

The squid hash ID to get results from

runstring

Optional

Filter results by specific run hash ID

pageinteger

Optional

Page number for pagination (default: 1)

page_sizeinteger

Optional

Number of results per page (default: 100, max: 1000)

Pro Tip

Use the is_michelin field to filter for Michelin-starred or Michelin-recognized restaurants for premium dining data.

Note

The price field uses currency symbols to indicate price ranges. Single symbol (e.g., €) indicates budget-friendly, while multiple symbols (€€-€€€) indicate higher price points.