{ "openapi": "3.0.1", "info": { "title": "Tripadvisor Reviews, Places & Photos Scraper", "description": "Scrape Tripadvisor reviews and place data from search keywords or direct URLs. Extract ratings, review text, dates, owner replies, addresses, phones, websites, coordinates, images, and search metadata for hotels, restaurants, attractions, and tours.", "version": "0.1", "x-build-id": "KdLniSKq4QPFf9PE3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trakk~tripadvisor-reviews-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trakk-tripadvisor-reviews-places-scraper", "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/trakk~tripadvisor-reviews-places-scraper/runs": { "post": { "operationId": "runs-sync-trakk-tripadvisor-reviews-places-scraper", "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/trakk~tripadvisor-reviews-places-scraper/run-sync": { "post": { "operationId": "run-sync-trakk-tripadvisor-reviews-places-scraper", "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": { "searchQueries": { "title": "๐Ÿ” Search queries", "type": "array", "description": "Find Tripadvisor places by keyword. Good examples: New York City hotels, Paris restaurants, London attractions, Eiffel Tower.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ”— Direct Tripadvisor URLs", "type": "array", "description": "Paste direct Tripadvisor hotel, restaurant, attraction, activity, or cruise review URLs. Leave empty if you want to use search queries only.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "๐Ÿท๏ธ Place type", "enum": [ "all", "hotels", "restaurants", "attractions" ], "type": "string", "description": "Limit search results to a specific type. Choose Auto / all to let the Actor infer hotels, restaurants, or attractions from your query when possible.", "default": "all" }, "maxPlacesPerQuery": { "title": "๐Ÿ“ Max places per search query", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many places to take from each search query. Start small for testing, then increase when the output looks right.", "default": 20 }, "includeReviews": { "title": "โญ Scrape reviews", "type": "boolean", "description": "When enabled, the Actor fetches review pages for every discovered place.", "default": true }, "maxReviewsPerPlace": { "title": "๐Ÿงพ Max reviews per place", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of reviews to scrape from each place. Set 0 to collect place details only.", "default": 50 }, "reviewRatings": { "title": "๐ŸŒŸ Review rating filter", "type": "array", "description": "Return only selected star ratings. Leave empty to collect all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "โญ 1 star", "โญโญ 2 stars", "โญโญโญ 3 stars", "โญโญโญโญ 4 stars", "โญโญโญโญโญ 5 stars" ] }, "default": [] }, "recentDays": { "title": "๐Ÿ•’ Only recent reviews", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Return only reviews published in the last N days when Tripadvisor provides an exact date. Set 0 to disable this filter.", "default": 0 }, "outputMode": { "title": "๐Ÿ“ฆ Default dataset content", "enum": [ "reviews", "places", "both" ], "type": "string", "description": "Reviews only is best for monitoring. Places only is best for lead enrichment. Places and reviews is best for audits and QA.", "default": "reviews" }, "locale": { "title": "๐ŸŒ Locale", "enum": [ "en-US", "en-GB", "fr-FR", "de-DE", "es-ES", "it-IT", "pt-BR", "nl-NL", "ja-JP" ], "type": "string", "description": "Tripadvisor locale used for search and page requests.", "default": "en-US" }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy configuration", "type": "object", "description": "Residential proxies are recommended for larger Tripadvisor runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "โšก Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many Tripadvisor place pages can be fetched in parallel. Increase carefully for larger runs; lower it if the site starts blocking requests.", "default": 3 }, "requestDelayMs": { "title": "โฑ๏ธ Request delay", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between requests in milliseconds. Increase this for larger or more sensitive runs.", "default": 350 }, "maxRetries": { "title": "๐Ÿ” Max retries", "minimum": 0, "maximum": 12, "type": "integer", "description": "Retry budget for blocked, timed out, or temporarily failed requests.", "default": 4 } } }, "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 } } } } } } } } } }