{ "openapi": "3.0.1", "info": { "title": "Tripadvisor Attractions Scraper", "description": "Scrape the things to do Tripadvisor lists for a city or around a point. Just add a city and get name, rating, review count, type, neighbourhood, description, coordinates, awards, ticket prices and opening status. Filter by type, rating, award and neighbourhood.", "version": "1.0", "x-build-id": "80DhVDIjfkSy9b4aj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boncross~tripadvisor-attractions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boncross-tripadvisor-attractions-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/boncross~tripadvisor-attractions-scraper/runs": { "post": { "operationId": "runs-sync-boncross-tripadvisor-attractions-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/boncross~tripadvisor-attractions-scraper/run-sync": { "post": { "operationId": "run-sync-boncross-tripadvisor-attractions-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": { "locations": { "title": "Cities", "type": "array", "description": "The cities to list attractions for. Paste a Tripadvisor link for the city (any page of it, for example its Things to Do page), its id (g187147), or its name (Paris, 東京, New York City). Regions and countries are not lists: give a city.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (bulk upload)", "type": "array", "description": "Tripadvisor city links, with the option to load them in bulk from a file, a Google Sheet or a remote list. Combined with anything in the list above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItemsPerLocation": { "title": "Maximum attractions per city", "minimum": 0, "type": "integer", "description": "How many attractions to return for each city, in the order of the sort you pick. Zero means every one the site lists.", "default": 100 }, "maxItems": { "title": "Maximum attractions for the whole run", "minimum": 0, "type": "integer", "description": "A run-wide ceiling on attractions, across every city. Zero means no limit.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "travelerFavorites", "travelerRanked" ], "type": "string", "description": "The two orders Tripadvisor offers on a city's Things to Do list.", "default": "travelerFavorites" }, "categories": { "title": "Types of attractions", "type": "array", "description": "For example Museums, Sights & Landmarks, Nature & Parks, Nightlife, Spas & Wellness, Fun & Games, Classes & Workshops. Several types are each listed in turn, without duplicates.", "items": { "type": "string" } }, "minRating": { "title": "Minimum traveler rating", "enum": [ "3", "4", "5" ], "type": "string", "description": "Only attractions rated at least this, out of 5." }, "awards": { "title": "Awards", "type": "array", "description": "Only award winners.", "items": { "type": "string", "enum": [ "travelersChoice", "bestOfTheBest" ], "enumTitles": [ "Travelers' Choice", "Travelers' Choice Best of the Best" ] } }, "goodFor": { "title": "Good for", "type": "array", "description": "For example Good for a Rainy Day, Budget-friendly, Free Entry, Good for Couples, Good for Kids, Hidden Gems.", "items": { "type": "string" } }, "neighborhoods": { "title": "Neighborhoods", "type": "array", "description": "Neighbourhood names as the city's Things to Do page lists them, for example Le Marais.", "items": { "type": "string" } }, "lat": { "title": "Latitude", "type": "string", "description": "Decimal degrees, for example 48.8584. Set with longitude to search near a point." }, "lng": { "title": "Longitude", "type": "string", "description": "Decimal degrees, for example 2.2945." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 50, "type": "integer", "description": "How far from the point, in kilometres. Rows further away are left out.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter code, for example USD or EUR. Used for the ticket prices some attractions show.", "default": "USD" } } }, "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 } } } } } } } } } }