{ "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": "Qu21Qs4D3RwKe2KvF" }, "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. This counts reviews that carry written text, so unless you switch on 'Include Rating-Only Reviews' below, the actor keeps reading further to fill your number with reviews you can actually read. 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." }, "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'." }, "language": { "title": "Review Language", "enum": [ "all", "en", "de", "fr", "es", "it", "nl", "pt", "da", "sv", "no", "fi", "pl", "cs", "sk", "hu", "ro", "bg", "hr", "bs", "sl", "lt", "lv", "el", "uk", "ru", "tr", "az", "ar", "he", "ja", "ko", "zh", "vi", "tl", "sw", "af", "yo", "ig", "tn", "so" ], "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). If you call this actor through the API you can also pass any other two-letter language code: it is used as the filter exactly as given, and the run tells you it wasn't one of the listed languages." }, "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." }, "includeRatingOnlyReviews": { "title": "Include Rating-Only Reviews", "type": "boolean", "description": "GetYourGuide lets a traveler submit a star rating without writing anything. Those entries make up roughly half of what the star-rating feeds return, and they arrive with no review text, no language, no traveler type and no photo — just a star, a date and a country. They are left out by default so you only pay for reviews you can actually read. Turn this on if you want them, for example to study the full star distribution rather than the written feedback." } } }, "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 } } } } } } } } } }