TripAdvisor Details API

Q: 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.

POST

API health

24h health: Normal
24h average time: —

Healthy / normal
Available
Limited
Mostly down

Normal

Last 24 hours

Last 30 days

Get the TripAdvisor listing for one hotel, restaurant or attraction, with rating, review count, city rank, price tier, address, coordinates and contact details. Pass the place's own page, not a city directory; prices and availability for a given date are not covered.

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.

Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

AI prompt

Paste this into your AI assistant. It already holds this endpoint's parameters, response fields and an example request, so the assistant can ask what you need and then write the scraper.

Please help me write a data collection script with the EveryInfra TripAdvisor Details endpoint (tripadvisor/profile).

Endpoint contract:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to tripadvisor and action to profile, and put the parameters inside params.
- Required parameters:
  - url: Target TripAdvisor venue URL for profile and reviews actions, pointing directly to a hotel, restaurant, or attraction listing rather than a city directory.
- Optional parameters:
  - content_type: Filters location photos by source. Allowed values are from_everyone (all photos), from_management (owner uploads), and from_travelers (visitor uploads). (allowed: from_everyone / from_management / from_travelers)
  - currency: 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. (allowed: aed / afn / all / amd / ars / aud / azn / bam)
  - lang: Two-letter language code (such as en or zh) for search, profile, restaurants, and attractions. The reviews action does not take this parameter. (allowed: aa / ab / ae / af / ak / am / an / ar)
- Returns one object. Main fields: id, name, category, url, text, rating, rating_scale, review_count, price_level, ranking, address, city; 21 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=tripadvisor.
- Example request body:
{
  "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"
  }
}
- Price: $1.39 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

Name	In	Type	Required	Default	Description
`Authorization`	header	`string`	Yes	-	Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
`platform`	body	`string`	Yes	`tripadvisor`	Platform identifier, fixed value.
`action`	body	`string`	Yes	`profile`	Capability identifier, fixed value.
`url`	body.params	Not declared	Yes	-	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`	body.params	`enum`	No	-	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.Allowed values`from_everyonefrom_managementfrom_travelers`
`currency`	body.params	`enum`	No	-	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.Allowed values`aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl`
`lang`	body.params	`enum`	No	-	Two-letter language code (such as `en` or `zh`) for search, profile, restaurants, and attractions. The reviews action does not take this parameter.Allowed values`aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh`

Code samples

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"
  }
}'

[OpenAPI definition (JSON)]Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

Real response

Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response 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.

json

{
  "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": { … }
}

Response fields

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

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`	Keeps the platform's own meaning
`ranking`	Keeps the platform's own 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`	Keeps the platform's own meaning
`longitude`	Keeps the platform's own 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`	Keeps the platform's own meaning

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.

Errors and billing

401: Missing or invalid key. Authentication runs before parameter checks, so unauthenticated requests never see the parameter schema.
422: Wrong parameter name or value. The error lists the parameters and allowed values this capability accepts and the closest match; it happens before any charge.
402: Insufficient balance. Top up first.
429: The account's per-minute request limit was reached (all of its API keys count together; a key's own lower limit applies first). Wait for Retry-After and try again; a rate package in the console raises the limit.
503: Could not complete right now. Any charge for the call goes back to your balance automatically, and the billing receipt in the response states the actual outcome, including when it is not yet known. Do not resend blindly.
200 empty: The request completed without data and is not charged (billing.reason = empty_result_refunded).

Official references

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

Tripadvisor: Popularity Ranking and Ratings ↗
Tripadvisor ties its Popularity Ranking to review quality, recency, quantity, and sustained performance over time; ranking is influenced by the performance of other businesses in the same region and is not simply an alternative representation of average rating.
Checked 2026-09-04