# TripAdvisor Reviews API (tripadvisor.reviews)

- Canonical page: [https://everyinfra.com/en/tripadvisor-api/reviews](https://everyinfra.com/en/tripadvisor-api/reviews?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "tripadvisor", "action": "reviews", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

TripAdvisor Reviews reads traveler reviews of one hotel, restaurant or attraction on TripAdvisor, given the place's page link as `url`. A row holds the title and body of a review, its rating and publish date, when the trip took place and what kind of trip it was, the reviewer's name, handle, home location and number of contributions, and how many likes the review received. Hotels, restaurants and tour operators use it to monitor what visitors say, and analysts use it to compare places or to hand clean review text to a language model for summaries.

Judge freshness by `trip_date`, the time of the visit, rather than `posted_at`. Reviews from people with a high `author_contributions` count are the more credible ones, and `trip_type` lets you keep the travelers who resemble your own customers. A null `like_count` means likes are not shown, not that nobody liked the review. The link must point to a single place, not a city page or a list.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=tripadvisor&action=reviews

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Target TripAdvisor venue URL for `profile` and `reviews` actions, pointing directly to a hotel, restaurant, or attraction listing rather than a city directory. In `profile`, it fetches venue details rather than user profile data. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| author_name | Author's display name. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_location | platform-native meaning |
| author_contributions | platform-native meaning |
| trip_type | platform-native meaning |
| trip_date | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| language | Content language code (for example zh, en) as judged by the platform; it can be wrong. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| owner_response | The business's public reply to this review: text, author_name and posted_at; absent when there is no reply. |
| image_urls | Array of image links in the platform's display order; absent when there are no images. |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "tripadvisor",
  "action": "reviews",
  "params": {
    "url": "https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_Street_Food_Tour_with_Locals_Dim_Sum_Wonton_more-Hong_Kong.html"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "tripadvisor",
        "action": "reviews",
        "params": {
            "url": "https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_Street_Food_Tour_with_Locals_Dim_Sum_Wonton_more-Hong_Kong.html",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "tripadvisor",
  "action": "reviews",
  "results": [
    {
      "id": …,
      "url": …,
      "title": …,
      "text": …,
      "rating": …,
      "rating_scale": …,
      "like_count": …,
      "author_name": …,
      "author_username": …,
      "author_location": …,
      "author_contributions": …,
      "trip_type": …,
      "trip_date": …,
      "posted_at": …,
      "language": …,
      "platform": …,
      "owner_response": …,
      "image_urls": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I feed TripAdvisor reviews to an AI assistant?

Call this capability from any script, workflow tool or assistant that can send HTTPS requests with your API key, then pass the rows to the model. Each row is structured JSON with `title`, `text`, `rating`, `rating_scale` and `trip_date`, and `text` already has HTML removed, so the model can summarize themes, compare periods or draft replies without cleanup.

### Which TripAdvisor page should `url` point to?

The page of one hotel, restaurant or attraction, such as https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_Street_Food_Tour_with_Locals_Dim_Sum_Wonton_more-Hong_Kong.html. City pages and lists of places do not work. To find a place's link from its name, use TripAdvisor Search, Restaurants or Attractions and take the link from a result.

### Can I filter reviews by language or sort them?

Not in the request: this capability takes only `url`, with no language or sort setting. Each row carries `language`, the code TripAdvisor assigns, which can be wrong, so filter on it or on your own detection after you fetch the rows, and sort by `posted_at` or `like_count` yourself when order matters.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=tripadvisor
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
