The tripadvisor API from AnyAPI — 2 operation(s) for tripadvisor.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/anyapi-tripadvisor-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
email: support@getanyapi.com
description: 'Any API, one wallet, USD, no subscriptions. Each API is a single discovered operation: send the normalized input, get a normalized result. Prices and payment outcomes are reported in USD; each operation documents the settlement policy for its enabled payment rails.'
title: Any Tripadvisor API
version: 1.0.0
x-guidance: 'Use each operation''s published method and path with its normalized JSON input (see the operation requestBody). Before setting a client or tool timeout, GET /v1/apis/{sku} and inspect its trailing-30-day latency p50/p95/p99 and sample; p99 is an observation, not a maximum. To pay: send your AnyAPI key (Authorization: Bearer, billed from your USD wallet). For operations that advertise an inline rail, pay per call inline with x402 - call with no key, receive HTTP 402 with a PAYMENT-REQUIRED header, then retry with the PAYMENT-SIGNATURE header (base, no account needed); or pay per call inline with MPP (Machine Payments Protocol) - call with no key, receive HTTP 402 with a WWW-Authenticate: Payment challenge, then retry with the Authorization: Payment header (tempo, no account needed). x402 settles after execution; execution failure is reported as released; mpp settles before execution; execution failure is reported as charged_undelivered.'
servers:
- url: https://api.getanyapi.com
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: tripadvisor
x-group: Tripadvisor
paths:
/v1/run/tripadvisor.reviews:
post:
description: 'Fetch the latest reviews for any Tripadvisor hotel, restaurant, or attraction by its page URL: rating, text, date, and trip details as normalized JSON.
**Price:** \$3.00 per 1,000 requests (flat per request - same cost regardless of results returned).
**Routing:** 2 independent lanes are available in execution order. A failed attempt uses the next lane only when the request''s payment authorizes that lane''s price; the normalized schema stays the same.
**Catalog:** Tripadvisor Reviews pricing and uptime - live USD price, lane routing, and measured 30-day uptime. Every Tripadvisor endpoint.'
operationId: tripadvisor_reviews
parameters:
- description: Optional. Comma-separated keys (dotted paths like `author.name` descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the `data`/`items` envelope is unwrapped, not against the top-level response envelope, so use `jq` to reshape the whole envelope. Shrinks the response without changing cost.
in: query
name: fields
required: false
schema:
type: string
- description: Optional. Cap the number of result rows returned; a `_truncated` note reports how many were withheld so you can page via the API's own `limit`. Does not change cost.
in: query
name: max_items
required: false
schema:
minimum: 0
type: integer
- description: Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.
in: query
name: summary
required: false
schema:
type: boolean
- description: 'Optional. A jq expression applied to the result envelope; its output replaces `output` (multiple outputs collect into an array). Reshape freely, e.g. `jq=.data | {title, description, md: .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a `jqError`. Does not change cost.'
in: query
name: jq
required: false
schema:
type: string
- description: Optional. The most you are willing to pay for this one request, in US dollars (for example 0.05). Any route that would charge more than this is not used, so a request only ever runs on something you can afford. If nothing is available at or below your amount, the request is refused before it runs, nothing is charged, and the message tells you the cheapest price per request so you can raise it. Leave it out to accept the normal price.
in: query
name: max_cost_usd
required: false
schema:
type: string
- description: Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.
in: header
name: Idempotency-Key
required: false
schema:
maxLength: 255
minLength: 1
type: string
requestBody:
content:
application/json:
example:
limit: 3
url: https://www.tripadvisor.com/Hotel_Review-g60763-d93450-Reviews-The_Plaza-New_York_City_New_York.html
schema:
additionalProperties: false
example:
limit: 3
url: https://www.tripadvisor.com/Hotel_Review-g60763-d93450-Reviews-The_Plaza-New_York_City_New_York.html
properties:
languages:
description: Only return reviews in these ISO 639-1 languages (e.g. ["en", "es"]); omit for all languages.
items:
type: string
type: array
limit:
description: Maximum number of results to return (1-20, default 20).
maximum: 20
minimum: 1
type: integer
preferLatencyUnderMs:
description: 'Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint''s lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted.'
minimum: 1
type: integer
ratings:
description: Only return reviews whose bubble rating is in this set (e.g. ["5", "4"] for 4 and 5 star reviews); omit for all ratings.
items:
enum:
- '1'
- '2'
- '3'
- '4'
- '5'
type: string
type: array
since:
description: Only return reviews newer than this date, YYYY-MM-DD or a relative window like '3 months' (e.g. 2026-01-01).
type: string
url:
description: Tripadvisor page URL of the hotel, restaurant, or attraction.
type: string
required:
- url
title: Tripadvisor reviews input
type: object
required: true
responses:
'200':
content:
application/json:
schema:
properties:
costUsd:
description: USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.
type: number
hint:
description: 'Optional one-line nudge, absent when there is nothing to say. `large_result:` suggests the fields/max_items/summary/jq controls for a big response. `paging_unavailable:` means this result came from a source that cannot return a `nextCursor`, so it may be INCOMPLETE and cannot be continued - re-run with `requireCursor: true` to be served only by a source that can page, which may cost more per request.'
type: string
items:
description: Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.
type: integer
jqError:
description: Present only when a `jq` expression failed; `output` then carries the full unshaped result and this explains why the reshape did not apply.
type: string
output:
anyOf:
- additionalProperties: false
properties:
data:
description: Result payload, or null when nothing was found.
oneOf:
- type: 'null'
- additionalProperties: false
properties:
items:
description: 'Review records for the place: rating, title, review text, publish date, trip type, and reviewer details. Populated whenever the provider has data for the entity.'
items:
properties:
createdUtc:
description: UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
type: number
x-anyapi-must-populate: true
rating:
description: Star rating (typically 1-5).
type: number
text:
description: Review body text. Populated whenever the provider has data for the entity.
type: string
x-anyapi-must-populate: true
title:
description: Review title or headline. Populated whenever the provider has data for the entity.
type: string
x-anyapi-must-populate: true
url:
description: Canonical review URL. Populated whenever the provider has data for the entity.
type: string
x-anyapi-must-populate: true
required:
- rating
- text
type: object
type: array
x-anyapi-must-populate: true
required:
- items
type: object
found:
description: Whether any reviews were found for the place.
type: boolean
required:
- found
- data
title: Tripadvisor reviews output
type: object
- type: 'null'
description: Normalized output, or null when the replay payload was not retained.
provider:
description: Always "AnyAPI".
type: string
replayed:
description: True when this response replays the durable result of an earlier run without billing or upstream execution.
type: boolean
resultId:
description: Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache.
type: string
required:
- output
- provider
- costUsd
- items
- replayed
type: object
description: Normalized result.
headers:
Idempotency-Replayed:
description: Present only when the request carried an Idempotency-Key this gateway honored. "false" means the key was claimed and the run executed freshly; "true" means it replayed a prior identical run and was NOT charged again. Absent means either no key was sent or this gateway does not honor keys, so a retry could be charged twice.
schema:
enum:
- 'false'
- 'true'
type: string
PAYMENT-RESPONSE:
description: Inline x402 payment receipt.
schema:
type: string
Payment-Receipt:
description: Inline mpp payment receipt.
schema:
type: string
X-PAYMENT-RESPONSE:
description: Inline x402 payment receipt.
schema:
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Input did not match the schema, or the upstream rejected the request.
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Missing or invalid API key.
'402':
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/PaymentRequiredError'
- $ref: '#/components/schemas/TrialCapReached'
application/problem+json:
schema:
properties:
challengeId:
minLength: 1
type: string
status:
const: 402
type: integer
required:
- status
- challengeId
type: object
description: Insufficient wallet balance or spend cap, or an inline-payment challenge. Agent trials receive a trial_cap_reached continuation with a live RFC 8628 device authorization.
headers:
PAYMENT-REQUIRED:
description: Inline x402 payment challenge.
schema:
type: string
WWW-Authenticate:
description: Inline mpp payment challenge.
schema:
type: string
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Unknown SKU, or the upstream had no matching resource.
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: 'Idempotency collision. Codes: idempotency_in_progress means retry after the Retry-After delay; idempotency_conflict means use a new key for different request semantics; idempotency_needs_review means stop retrying and contact AnyAPI support with X-Anyapi-Request-Id.'
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: The request was well formed but this API cannot serve the requested target site; the body's `alternatives` array lists the AnyAPI APIs that can.
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: The upstream was rate limited; inspect `payment` when present before deciding whether to retry.
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: An internal error prevented completion. Inspect payment when present before retrying.
'502':
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Every provider failed with a server/transport error, or inline payment settlement could not be confirmed; inspect `payment` when present before retrying.
security:
- bearerAuth: []
- apiKeyAuth: []
- {}
summary: Tripadvisor Reviews
tags:
- tripadvisor
x-mint:
href: /api-reference/tripadvisor/reviews
x-payment-info:
price:
currency: USD
max: '0.011000'
min: '0.003000'
mode: dynamic
protocols:
- x402:
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
network: eip155:8453
payTo: '0x754BD2A6799e766B1E2b9f1Ae7fBdC0CeD96ef13'
scheme: exact
- mpp:
asset: '0x20c000000000000000000000b9537d11c60e8b50'
currency: USD
intent: charge
method: tempo
network: tempo
payTo: '0x754BD2A6799e766B1E2b9f1Ae7fBdC0CeD96ef13'
rail: tempo
scheme: exact
rails:
- headers:
challenge:
- PAYMENT-REQUIRED
credential:
- PAYMENT-SIGNATURE
- X-PAYMENT
receipt:
- PAYMENT-RESPONSE
- X-PAYMENT-RESPONSE
pricing:
currency: USD
max: '0.011000'
min: '0.003000'
minimumUsd: '0.001000'
mode: dynamic
quoteBasis: floor
protocol:
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
network: eip155:8453
payTo: '0x754BD2A6799e766B1E2b9f1Ae7fBdC0CeD96ef13'
scheme: exact
rail: x402
settlement:
onExecutionFailure: released
onUnknownFinalization: indeterminate
timing: after_execution
- headers:
challenge:
- WWW-Authenticate
credential:
- Authorization
receipt:
- Payment-Receipt
pricing:
currency: USD
max: '0.011000'
min: '0.003000'
minimumUsd: null
mode: dynamic
quoteBasis: funded_ceiling
protocol:
asset: '0x20c000000000000000000000b9537d11c60e8b50'
currency: USD
intent: charge
method: tempo
network: tempo
payTo: '0x754BD2A6799e766B1E2b9f1Ae7fBdC0CeD96ef13'
rail: tempo
scheme: exact
rail: mpp
settlement:
onExecutionFailure: charged_undelivered
onVerificationError: indeterminate
timing: before_execution
/v1/run/tripadvisor.search:
post:
description: 'Search Tripadvisor for hotels, restaurants, and attractions in any destination and get rich place records (ratings, review counts, contact details, pricing) as normalized JSON.
**Price:** \$3.00 per 1,000 requests (flat per request - same cost regardless of results returned).
**Routing:** 2 independent lanes are available in execution order. A failed attempt uses the next lane only when the request''s payment authorizes that lane''s price; the normalized schema stays the same.
**Catalog:** Tripadvisor Search pricing and uptime - live USD price, lane routing, and measured 30-day uptime. Every Tripadvisor endpoint.'
operationId: tripadvisor_search
parameters:
- description: Optional. Comma-separated keys (dotted paths like `author.name` descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the `data`/`items` envelope is unwrapped, not against the top-level response envelope, so use `jq` to reshape the whole envelope. Shrinks the response without changing cost.
in: query
name: fields
required: false
schema:
type: string
- description: Optional. Cap the number of result rows returned; a `_truncated` note reports how many were withheld so you can page via the API's own `limit`. Does not change cost.
in: query
name: max_items
required: false
schema:
minimum: 0
type: integer
- description: Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.
in: query
name: summary
required: false
schema:
type: boolean
- description: 'Optional. A jq expression applied to the result envelope; its output replaces `output` (multiple outputs collect into an array). Reshape freely, e.g. `jq=.data | {title, description, md: .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a `jqError`. Does not change cost.'
in: query
name: jq
required: false
schema:
type: string
- description: Optional. The most you are willing to pay for this one request, in US dollars (for example 0.05). Any route that would charge more than this is not used, so a request only ever runs on something you can afford. If nothing is available at or below your amount, the request is refused before it runs, nothing is charged, and the message tells you the cheapest price per request so you can raise it. Leave it out to accept the normal price.
in: query
name: max_cost_usd
required: false
schema:
type: string
- description: Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.
in: header
name: Idempotency-Key
required: false
schema:
maxLength: 255
minLength: 1
type: string
requestBody:
content:
application/json:
example:
limit: 3
query: Paris
schema:
additionalProperties: false
example:
limit: 3
query: Paris
properties:
currency:
default: USD
description: ISO currency code for prices (e.g. USD, EUR).
type: string
includeAttractions:
default: true
description: Include attractions and things to do in the results; set false to exclude them (e.g. false). Defaults to true.
type: boolean
includeHotels:
default: true
description: Include hotels in the results; set false to exclude them (e.g. false). Defaults to true.
type: boolean
includeRestaurants:
default: true
description: Include restaurants in the results; set false to exclude them (e.g. false). Defaults to true.
type: boolean
limit:
description: Maximum number of results to return (1-20, default 20).
maximum: 20
minimum: 1
type: integer
preferLatencyUnderMs:
description: 'Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint''s lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted.'
minimum: 1
type: integer
query:
description: Destination or keyword to search for (e.g. Barcelona).
type: string
required:
- query
title: Tripadvisor search input
type: object
required: true
responses:
'200':
content:
application/json:
schema:
properties:
costUsd:
description: USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.
type: number
hint:
description: 'Optional one-line nudge, absent when there is nothing to say. `large_result:` suggests the fields/max_items/summary/jq controls for a big response. `paging_unavailable:` means this result came from a source that cannot return a `nextCursor`, so it may be INCOMPLETE and cannot be continued - re-run with `requireCursor: true` to be served only by a source that can page, which may cost more per request.'
type: string
items:
description: Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.
type: integer
jqError:
description: Present only when a `jq` expression failed; `output` then carries the full unshaped result and this explains why the reshape did not apply.
type: string
output:
anyOf:
- additionalProperties: false
properties:
data:
description: The result wrapper, or null when nothing matched.
oneOf:
- type: 'null'
- additionalProperties: false
properties:
items:
description: Matching Tripadvisor place records (hotels, restaurants, attractions). Populated whenever the provider has data for the entity.
items:
properties:
address:
description: Full formatted street address.
type: string
category:
description: High-level category (e.g. hotel, restaurant, attraction).
type: string
city:
description: City the place is in.
type: string
country:
description: Country the place is in.
type: string
email:
description: Business contact email, when listed.
type: string
hotelClass:
description: Star rating / hotel class, when applicable.
type: string
id:
description: Tripadvisor location id (stable identifier for the place).
type: string
image:
description: Primary place photo URL.
type: string
latitude:
description: Latitude of the place in decimal degrees.
type: number
longitude:
description: Longitude of the place in decimal degrees.
type: number
phone:
description: Business phone number, when listed.
type: string
postalCode:
description: Postal code of the place.
type: string
priceLevel:
description: Relative price level indicator (e.g. $$, $$$$).
type: string
priceRange:
description: Nightly or per-visit price range in the requested currency.
type: string
ranking:
description: Ranking string within its location (e.g. "#2 of 1,885 hotels in Paris").
type: string
rating:
description: Average traveler rating out of 5. Populated whenever the provider has data for the entity.
type: number
x-anyapi-must-populate: true
reviewCount:
description: Total number of traveler reviews.
type: number
title:
description: Place name. Populated whenever the provider has data for the entity.
type: string
x-anyapi-must-populate: true
type:
description: Tripadvisor place type (e.g. HOTEL, RESTAURANT, ATTRACTION).
type: string
url:
description: Canonical Tripadvisor listing page URL. Populated whenever the provider has data for the entity.
type: string
x-anyapi-must-populate: true
website:
description: The place's own website URL, when listed.
type: string
required:
- title
- url
- rating
type: object
type: array
x-anyapi-must-populate: true
required:
- items
type: object
# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/anyapi/refs/heads/main/openapi/anyapi-tripadvisor-api-openapi.yml