# TripAdvisor Reviews Scraper

> TripAdvisor Reviews Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured review data from TripAdvisor hotel, restaurant, and attraction pages with filtering by rating, date, and language.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/tripadvisor-reviews?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tripadvisor-reviews-scraper-4aaef4d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s-_2hh7SFurpd-CUNyDrw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tripadvisor-reviews-scraper-4aaef4d2 -d '<json body>'
```

Example prompt: Pull up to 100 TripAdvisor reviews for the Marriott Times Square at https://www.tripadvisor.com/Hotel_Review-g60763-d93150 — only English reviews from 2024 onwards, and include reviewer profile info.

## When to prefer this

Use this endpoint when you need structured, filterable TripAdvisor review data at scale without building your own scraper. It is ideal when you need to filter by star rating, date range, or language — and when pay-per-successful-call pricing matters (failed/empty runs are not charged). Prefer this over general web scraping endpoints when TripAdvisor-specific output structure (rating, language, machine-translation flag, reviewer info) is required.

## Known failure modes

- Invalid or non-TripAdvisor URL returns empty results or error
- TripAdvisor anti-bot measures may block scraping intermittently
- Date format not in YYYY-MM-DD causes parameter rejection
- No reviews matching filters returns count 0 with empty items array (no charge)
- Rate limits or IP blocks from TripAdvisor may cause partial results
- Invalid language code may return no filtered results silently

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of reviews retrieved and an array of review items, each containing the review ID, URL, language, text, title, star rating, original language, and machine-translation flag. Reviewer name, profile link, location, and contribution count are included when the includeReviewerInfo option is enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum reviews to save across all places. Zero means no total limit."
  },
  "startUrls": {
   "type": "array",
   "description": "Public Tripadvisor hotel, restaurant, or attraction review pages."
  },
  "reviewRatings": {
   "type": "array",
   "items": {
    "enum": [
     "1",
     "2",
     "3",
     "4",
     "5"
    ],
    "type": "string",
    "enumTitles": [
     "1 star",
     "2 stars",
     "3 stars",
     "4 stars",
     "5 stars"
    ]
   },
   "default": [],
   "description": "Save only selected star ratings. Leave empty for all ratings."
  },
  "lastReviewDate": {
   "type": "string",
   "description": "Save reviews published on or after this date, in YYYY-MM-DD format."
  },
  "reviewsLanguage": {
   "type": "string",
   "default": "",
   "description": "ISO language code to keep, such as en or fr. Leave blank for all languages."
  },
  "maxReviewsPerPlace": {
   "type": "integer",
   "default": 50,
   "minimum": 0,
   "description": "Maximum reviews to save for each place. Zero means no per-place limit."
  },
  "includeReviewerInfo": {
   "type": "boolean",
   "default": true,
   "description": "Include public reviewer name, profile link, location, and contribution count when available."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "lang": null,
    "text": null,
    "title": null,
    "rating": null,
    "originalLanguage": null,
    "isMachineTranslated": null
   }
  ],
  "product": "tripadvisor-reviews"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tripadvisor-reviews-scraper-4aaef4d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)