{ "openapi": "3.0.1", "info": { "title": "GetYourGuide Reviews Scraper", "description": "[💰 $2.50 / 1K] Extract reviews from GetYourGuide activity pages — ratings, review text, author details, photos, owner responses, and activity metadata.", "version": "1.0", "x-build-id": "vGObbjhdDAFe1iAxW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~getyourguide-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-getyourguide-reviews", "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/solidcode~getyourguide-reviews/runs": { "post": { "operationId": "runs-sync-solidcode-getyourguide-reviews", "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/solidcode~getyourguide-reviews/run-sync": { "post": { "operationId": "run-sync-solidcode-getyourguide-reviews", "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": "Activity URLs", "type": "array", "description": "GetYourGuide activity page URLs. Paste one or more URLs like https://www.getyourguide.com/paris-l16/disneyland-paris-2-parks-ticket-1-2-3-4-5-day-t395320/", "items": { "type": "string" } }, "maxReviewsPerActivity": { "title": "Max Reviews per Activity", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to extract per activity. Set to 0 for all reviews. Note: GetYourGuide caps results at 310 reviews per activity when no rating filter is applied, and at 1,550 reviews per activity when reviews are gathered across all 5 star buckets — even on activities with tens of thousands of total reviews. The actor automatically uses the broader 1,550-review strategy when you ask for more than 310 reviews and have not set a minimum rating.", "default": 100 }, "sortBy": { "title": "Sort Reviews By", "enum": [ "highest_rating", "lowest_rating", "newest", "most_helpful" ], "type": "string", "description": "Order in which reviews are returned in the dataset. Sorting is applied after collection. Note: GetYourGuide's API does not expose a helpful-vote signal, so 'Most Helpful First' returns reviews in the same order as 'Newest First'.", "default": "highest_rating" }, "language": { "title": "Review Language", "enum": [ "all", "en", "de", "fr", "es", "it", "nl", "pt", "pl", "da", "sv", "no", "fi", "el", "cs", "hu", "tr", "ru", "ar", "he", "ja", "ko", "zh" ], "type": "string", "description": "Only return reviews written in this language. Choose 'All Languages' to include every language. The filter is applied after reviews are collected — when filtering by a less-common language on activities with mostly English reviews, fewer than your requested cap may be returned. To maximize matches, raise 'Max Reviews per Activity' (the actor automatically scans up to 5x your cap, capped at GetYourGuide's 1,550-review ceiling).", "default": "all" }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only collect reviews with at least this many stars (0–5). Set to 0 for no filter.", "default": 0 } } }, "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 } } } } } } } } } }