# TripAdvisor Details API (tripadvisor.profile)

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

TripAdvisor Details reads one place on TripAdvisor, a hotel, restaurant or attraction, given the link to its page, and returns the listing: name, category, description, rating and review count, its rank among similar places in the city, price tier, address and coordinates, and the phone, email and website the business publishes. Travel platforms, tourism boards and hospitality teams use it to enrich venue databases, benchmark a place against its neighbors and keep contact details current.

Details here means the place itself, not a traveler's profile. `lang` sets the display language with two-letter codes such as `en` or `zh`, `currency` the currency for any prices shown, and `content_type` whose photos come back: everyone's, the business's own or travelers'. `phone` is passed through without reformatting, so normalize numbers before you match them against your own records, and keep `rating` with `rating_scale` when you compare places across sites.

## Health

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

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

## 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": "profile",
  "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": "profile",
        "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

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "tripadvisor",
  "action": "profile",
  "results": {
    "id": "26810431",
    "name": "Hong Kong: 7-Course Hong Kong Street & Restaurant Food Tour",
    "category": "activity",
    "url": "https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_7_Course_Hong_Kong_Street_Restaurant_Food_Tour-Hong_Kong.html",
    "text": "With this guided food tour, you can discover a variety of great eateries in Hong Kong’s historic Chinese quarter. Instead of spending hours scrolling through reviews, a guide does all the planning for you and takes you to places to get delicious street food, including barbecue po…",
    "rating": 4.9,
    "review_count": 388,
    "address": "Hong Kong China",
    "city": "Hong Kong",
    "country": "China",
    "location": "Hong Kong",
    "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/33/81/6d/45/caption.jpg",
    "platform": "tripadvisor",
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Which TripAdvisor link works as `url`?

The page of one specific 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 for a Hong Kong food tour. City pages and directory lists do not work. The same place link also works with TripAdvisor Reviews, which returns the individual reviews behind `rating` and `review_count`.

### How should I read `ranking` and `price_level`?

`ranking` is the place's position among places of the same kind in its city, as TripAdvisor shows it, for example third among a city's restaurants, so compare ranks only within one city and category. `price_level` is a tier written as one to four dollar signs: a relative signal of cost, not a price you can convert or add up.

### Can I call this from PHP?

Yes. Each capability is called with a plain HTTPS request authenticated with your API key, and the response is JSON, so PHP's cURL functions or any HTTP client library can make the call. Name the platform and action, pass the place link as `url` in `params`, then decode the response with json_decode and read fields such as `name`, `rating` and `ranking`.

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