# TripAdvisor Attractions API (tripadvisor.attractions)

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

TripAdvisor Attractions finds things to see and do on TripAdvisor by `keyword`, a city, an area or a named sight, and returns attractions only. Each row gives the attraction's name, its category and description, the visitor rating with the number of reviews behind it, its rank among attractions in the same city, address and coordinates, and any phone, email or website it publishes. Tour operators, destination marketers and travel app builders use it to list a city's leading sights, compare how they are rated and build itineraries.

Add the city to a sight's name, such as Louvre Paris, to keep places with similar names apart; `keyword` is not a search of review text. `category` uses TripAdvisor's own taxonomy, not normalized across sites, and `lang` and `currency` set the display language and the currency of any prices shown. To read what visitors say about one result, pass its `url` to TripAdvisor Reviews.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Search query string for location lookup. The `search` action queries across hotels, restaurants, and attractions, while `restaurants` and `attractions` restrict search to their respective domain. Appending a city name helps disambiguate venues with identical names. This parameter does not perform full-text review searches. |
| content_type | enum: from_everyone / from_management / from_travelers | no | not declared | Filters location photos by source. Allowed values are `from_everyone` (all photos), `from_management` (owner uploads), and `from_travelers` (visitor uploads). It does not filter location categories like hotels, restaurants, or attractions; choose the corresponding action to target specific location types. |
| currency | enum: aed / afn / all / amd / ars / aud / azn / bam / bdt / bgn / bhd / bif / bnd / bob / brl / bwp / byn / bzd / cad / cdf / chf / clp / cny / cop / crc / cve / czk / djf / dkk / dop / dzd / eek / egp / ern / etb / eur / gbp / gel / ghs / gnf / gtq / hkd / hnl / hrk / huf / idr / ils / inr / iqd / irr / isk / jmd / jod / jpy / kes / khr / kmf / krw / kwd / kzt / lbp / lkr / ltl / lvl / lyd / mad / mdl / mga / mkd / mmk / mop / mur / mxn / myr / mzn / nad / ngn / nio / nok / npr / nzd / omr / pab / pen / php / pkr / pln / pyg / qar / ron / rsd / rub / rwf / sar / sdg / sek / sgd / sos / syp / thb / tnd / top / try / ttd / twd / tzs / uah / ugx / usd / uyu / uzs / vef / vnd / xaf / xof / yer / zar / zmk / zwl | no | not declared | Currency code for displayed location prices, defaulting to `usd` (common options include `eur`, `gbp`, and `cny`). The full schema enumeration is preserved, but supported historical codes may not yield active real-time prices. This parameter does not alter API billing currency. |
| lang | enum: aa / ab / ae / af / ak / am / an / ar / as / av / ay / az / ba / be / bg / bh / bi / bm / bn / bo / br / bs / ca / ce / ch / co / cr / cs / cu / cv / cy / da / de / dv / ee / el / en / eo / es / et / eu / fa / ff / fi / fj / fo / fr / fy / ga / gd / gl / gn / gu / gv / ha / he / hi / ho / hr / ht / hu / hy / hz / ia / id / ie / ig / ii / ik / io / is / it / iu / iw / ja / jv / ka / kg / ki / kj / kk / kl / km / kn / ko / kr / ks / ku / kv / kw / ky / la / lb / lg / li / ln / lo / lt / lu / lv / mg / mh / mi / mk / ml / mn / mr / ms / mt / my / na / nb / nd / ne / ng / nl / nn / no / nr / nv / ny / oc / oj / om / or / os / pa / pi / pl / ps / pt / qu / rm / rn / ro / ru / rw / sa / sc / sd / se / sg / si / sk / sl / sm / sn / so / sq / sr / ss / st / su / sv / sw / ta / te / tg / th / ti / tk / tl / tn / to / tr / ts / tt / tw / ty / ug / uk / ur / uz / ve / vi / vo / wa / wo / xh / yi / yo / za / zh | no | not declared | Two-letter language code (such as `en` or `zh`) for search, profile, restaurants, and attractions. The reviews action does not take this parameter. |
| limit | integer (1–30) | no | 10 | The most rows to return in this call, an integer from 1 to 30. 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. |
| name | Name of the object itself, for account, product and business capabilities. |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| url | Link to the record on the platform. |
| 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. |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| price_level | platform-native meaning |
| ranking | platform-native meaning |
| address | Full address, passed through as is. |
| city | City name in the platform's language, not normalized. |
| country | Country or region: a full name or an ISO code depending on the platform, not normalized. |
| location | Location description passed through as is; the format varies by platform. |
| phone | Contact phone number, passed through without format normalization. |
| email | Contact email address, passed through as is. |
| website | External website entered by the account or business. |
| latitude | platform-native meaning |
| longitude | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| cuisines | platform-native meaning |

## 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": "attractions",
  "params": {
    "keyword": "Tokyo"
  }
}'
```

```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": "attractions",
        "params": {
            "keyword": "Tokyo",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "tripadvisor",
  "action": "attractions",
  "results": [
    {
      "id": "321129",
      "name": "Asakusa",
      "category": "attraction",
      "url": "https://www.tripadvisor.com/Attraction_Review-g14134311-d321129-Reviews-Asakusa-Asakusa_Taito_Tokyo_Tokyo_Prefecture_Kanto.html",
      "rating": 4.4,
      "review_count": 6220,
      "address": " , Asakusa, Tokyo Prefecture",
      "city": "Asakusa",
      "country": "JP",
      "location": "Asakusa, Taito",
      "website": "https://asakusa-kankou.com/en/index.html",
      "latitude": 35.712807,
      "longitude": 139.79655,
      "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/13/7f/b3/b7/asakusa.jpg",
      "platform": "tripadvisor",
      "rating_scale": 5
    },
    {
      "id": "4403399",
      "name": "Shibuya Crossing",
      "category": "attraction",
      "url": "https://www.tripadvisor.com/Attraction_Review-g1066456-d4403399-Reviews-Shibuya_Crossing-Shibuya_Tokyo_Tokyo_Prefecture_Kanto.html",
      "rating": 4.2,
      "review_count": 7933,
      "address": "2 Chome-2-1 Dogenzaka, Shibuya, Tokyo Prefecture 150-0043",
      "city": "Shibuya",
      "country": "JP",
      "location": "Shibuya, Tokyo",
      "latitude": 35.65945,
      "longitude": 139.70049,
      "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1c/7c/eb/cb/photo0jpg.jpg",
      "platform": "tripadvisor",
      "rating_scale": 5
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How is this different from TripAdvisor Search?

TripAdvisor Search mixes hotels, restaurants and attractions in one list, while Attractions returns attractions only and TripAdvisor Restaurants returns restaurants only. Use Attractions when you are building a list of sights or activities and do not want to strip hotels and restaurants out of the results afterward.

### How should I compare attractions in different cities?

Not by `ranking`, which places an attraction only among others in its own city, so a top-ten rank in a small town and one in a capital are not comparable. Compare `rating`, read with `rating_scale`, and weigh it by `review_count`, which shows how many visitors the score rests on.

### What does `content_type` change?

Whose photos come with each attraction: `from_everyone` for all photos, `from_management` for those the attraction's own team uploaded, or `from_travelers` for visitor photos. It does not choose the kind of place; this capability returns attractions only, and hotels or restaurants need TripAdvisor Search or Restaurants.

## 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
