{ "openapi": "3.0.1", "info": { "title": "Tripadvisor API | Hotel, Restaurant and Attraction Reviews", "description": "Tripadvisor API for hotels, restaurants and attractions. Search places by keyword to get ratings, review counts and locations, then pull full review text with author details. Pay per result, MCP ready for AI agents.", "version": "0.0", "x-build-id": "GavQUSgPaizsHmrmf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~tripadvisor-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-tripadvisor-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/johnvc~tripadvisor-api/runs": { "post": { "operationId": "runs-sync-johnvc-tripadvisor-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/johnvc~tripadvisor-api/run-sync": { "post": { "operationId": "run-sync-johnvc-tripadvisor-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "search_mode" ], "properties": { "search_mode": { "title": "Search mode", "enum": [ "search", "reviews" ], "type": "string", "description": "What to fetch. Use 'search' to find places by keyword and get their ratings, review counts and placeId values. Use 'reviews' to pull the full review text for one place, which needs a placeId taken from a search run.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Required when search mode is 'search'. The keyword to search for, such as 'hotels in paris', 'seafood restaurants boston' or 'museums in rome'. Ignored in reviews mode." }, "place_id": { "title": "Place ID", "type": "string", "description": "Required when search mode is 'reviews'. The numeric placeId of the place whose reviews you want. Run this Actor in 'search' mode first and copy the placeId from any result row. Ignored in search mode." }, "place_types": { "title": "Filter by place type", "type": "array", "description": "Optional. Keep only these place types in search mode. Leave empty to return every type. ACCOMMODATION covers hotels and rentals, EATERY covers restaurants and bars, ATTRACTION covers things to do.", "items": { "type": "string", "enum": [ "ACCOMMODATION", "EATERY", "ATTRACTION" ], "enumTitles": [ "Hotels and accommodation", "Restaurants and bars", "Attractions and things to do" ] }, "default": [] }, "max_results": { "title": "Maximum results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many rows to return before stopping. Search returns 30 places per upstream call and reviews returns 10 per call, so the Actor pages automatically until it reaches this number or the source runs out.", "default": 100 }, "tripadvisor_domain": { "title": "Regional domain", "enum": [ "www.tripadvisor.com", "www.tripadvisor.co.uk", "www.tripadvisor.ca", "www.tripadvisor.com.au", "www.tripadvisor.in", "www.tripadvisor.de", "www.tripadvisor.fr", "www.tripadvisor.es", "www.tripadvisor.it", "www.tripadvisor.com.br" ], "type": "string", "description": "Optional. The regional Tripadvisor domain to query, which controls the language and currency of the results. Defaults to the United States site.", "default": "www.tripadvisor.com" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }