{ "openapi": "3.0.1", "info": { "title": "Tripadvisor Review & Hospitality Leads", "description": "Export Tripadvisor hotels, restaurants and attractions with address, rating, review count, rating breakdown and newest reviews, from listing URLs or a city search.", "version": "1.0", "x-build-id": "WPotD573hyZCvG9dl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~tripadvisor-review-hospitality-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-tripadvisor-review-hospitality-leads", "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/muhammadafzal~tripadvisor-review-hospitality-leads/runs": { "post": { "operationId": "runs-sync-muhammadafzal-tripadvisor-review-hospitality-leads", "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/muhammadafzal~tripadvisor-review-hospitality-leads/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-tripadvisor-review-hospitality-leads", "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", "properties": { "startUrls": { "title": "Tripadvisor listing or list URLs", "type": "array", "description": "Hotel, restaurant or attraction listing URLs from any Tripadvisor domain; each returns that listing. City list pages (Hotels-g..., Restaurants-g..., Attractions-g...) and Search pages run as a search for their place instead. Takes precedence over search queries. No login or cookies are needed.", "items": { "type": "object", "properties": { "url": { "title": "Tripadvisor URL", "description": "Tripadvisor listing, city list or search page URL.", "type": "string" } }, "required": [ "url" ] } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keyword searches such as 'boutique hotels in Lisbon' or 'seafood restaurants in San Diego'. The place after 'in' sets the search area; a query without one searches the location below. Ignored when startUrls is provided.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "location": { "title": "Search location", "minLength": 1, "maxLength": 120, "type": "string", "description": "City used for search queries that name no place, and for the default search when neither startUrls nor searchQueries is given. Add the region or country when the name is ambiguous, for example 'Austin, Texas', 'London, Ontario' or 'Bali, Indonesia'. Defaults to New York.", "default": "New York" }, "hospitalityType": { "title": "Listing type", "enum": [ "all", "hotel", "restaurant", "attraction" ], "type": "string", "description": "Keep only hotels, restaurants or attractions from searches and list pages. Listing URLs you give are always returned. With 'All' and no search query, the Actor searches hotels, restaurants and attractions in the location.", "default": "all" }, "maxResults": { "title": "Maximum listings", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum listing records returned and charged, from 1 to 100; default 20.", "default": 20 }, "maxPagesPerInput": { "title": "Search pages per search", "minimum": 1, "maximum": 10, "type": "integer", "description": "Search result pages of up to 30 listings each, per search; default 2. Pages are requested only while more listings are needed. A search stops at 210 results, so values above 7 act as 7.", "default": 2 }, "includeReviews": { "title": "Include newest reviews", "type": "boolean", "description": "Add the newest public reviews of each listing, with reviewer, date, rating, visit month and the owner's reply. Address, rating and rating breakdown are returned either way. Default true.", "default": true }, "maxReviewsPerListing": { "title": "Reviews per listing", "minimum": 0, "maximum": 10, "type": "integer", "description": "Newest reviews kept per listing, from 0 to 10; default 3. Set 0 for listing data only.", "default": 3 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }