---
title: "Scrape a TripAdvisor list (restaurants / hotels / attractions)"
method: POST
path: "/travel/tripadvisor"
tags: ["Plugins"]
---

# Scrape a TripAdvisor list (restaurants / hotels / attractions)

`POST /travel/tripadvisor`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/travel/tripadvisor`
- Auth: API key in header `x-scrapeunblocker-key`

Given a TripAdvisor list `url` (Restaurants, Hotels or Attractions for a city/area), returns the places as JSON: `name`, `url`, `image`, `rating`, `reviewCount`, `priceRange`, `cuisine`, `phone`, `address`, `country` and `coordinates`. Paginates through TripAdvisor's `-oaN-` pages up to `max_results`. Data is read from TripAdvisor's schema.org ld+json, which is more stable than its HTML.

## Query parameters

- `url` string, required: TripAdvisor list URL (Restaurants / Hotels / Attractions), e.g. https://www.tripadvisor.com/Restaurants-g60763-New_York_City_New_York.html
- `max_results` integer: How many places to collect across pages (~30 per page, max 1020). TripAdvisor renders slowly, so large values take a while.
- `page` integer: 1-based results page to start from.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Leave blank to let the API pick.

## Response `200`

JSON with a `places` array plus totals.

- unknown

## Other responses

- `400`: Invalid parameters / not a TripAdvisor list URL.
- `422`: Validation Error
- `502`: Blocked by TripAdvisor, no list found on the page, or the call did not finish in time (TripAdvisor renders slowly).

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)