Skip to main content
POST /v1/data/tripadvisor/restaurants/run Pricing: $0.002 per restaurant ($2.00 per 1,000). Setting maxPhotosPerPlace above 0 adds $0.0005 per delivered photo.

Ways to call it

  • Search: set query (optional: maxResults, language, currency, includeTags, maxPhotosPerPlace, photosType)
  • URL: set startUrls (optional: language, currency, includeTags, maxPhotosPerPlace, photosType)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
A location name or keyword to search, e.g. ‘Paris’ or ‘Rome restaurants’. Use English place names for best coverage. (By Search mode.)
string
A TripAdvisor search or restaurant page URL to extract listings from. (By URL mode.)Format e.g. https://www.tripadvisor.com/hotels-g189158-lisbon_lisbon_district_central_portugal-hotels.html.
integer
Number of restaurants to return. Use 0 for all.
string
default:"en"
Language for the listing data.
string
default:"USD"
Currency for prices.
boolean
default:"true"
Pull review category tags (e.g. “Romantic”, “Special occasion”).
integer
default:"0"
Photos to fetch per restaurant. Use 0 for none. Billed as an add-on per delivered photo.
string
default:"fromEveryone"
Which photo source to pull from.Allowed values: fromEveryone (From Everyone), fromManagement (From Management), fromTravelers (From Travelers).

Example

Response fields

Each row in data is one restaurant, keyed by these fields.

Example response

Abridged: long text and lists are shortened.