{ "openapi": "3.0.1", "info": { "title": "Getyourguide Reviews Scraper", "description": "Scrapes reviews from any GetYourGuide activity — rating, author, country, ISO date, text, traveler type, original language, verified-booking flag and review photos. Talks to GetYourGuide's own API, so no browser and no proxy are required.", "version": "0.0", "x-build-id": "7F31VmUtsKlz2Xpjb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reviewly~getyourguide-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reviewly-getyourguide-reviews-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/reviewly~getyourguide-reviews-scraper/runs": { "post": { "operationId": "runs-sync-reviewly-getyourguide-reviews-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/reviewly~getyourguide-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-reviewly-getyourguide-reviews-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Activity URLs", "type": "array", "description": "GetYourGuide activity URLs (the activity id is read from the '-t' part of the slug). A bare numeric activity id also works.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviews": { "title": "Max reviews (total)", "minimum": 0, "type": "integer", "description": "Stop after this many reviews across all URLs. 0 means no limit. Note: GetYourGuide returns reviews in a non-deterministic order, so the actor always completes the walk and then keeps the newest N.", "default": 0 }, "targetDate": { "title": "Only reviews newer than", "type": "string", "description": "Drop reviews older than this date (ISO 8601, e.g. 2025-01-01). Because GetYourGuide's review order is non-deterministic, this filters after the full walk rather than stopping early — so it does not make a run faster." }, "language": { "title": "Review language", "enum": [ "en-US", "fr-FR", "de-DE", "es-ES", "it-IT", "nl-NL", "pt-PT" ], "type": "string", "description": "Participant language sent to the API. GetYourGuide serves some reviews machine-translated into this language and others in their original language — each review records which happened via its 'language', 'originalLanguage' and 'isTranslated' fields. It does not change how many reviews you get.", "default": "en-US" }, "currency": { "title": "Currency", "enum": [ "EUR", "USD", "GBP", "CHF", "MAD" ], "type": "string", "description": "Sent as the required 'accept-currency' header. Does not affect review content, but the API rejects the request without it.", "default": "EUR" }, "visitorIdAttempts": { "title": "Completeness passes", "minimum": 1, "maximum": 5, "type": "integer", "description": "GetYourGuide A/B-buckets its review list by visitor id: one bucket can return fewer reviews than another (e.g. 98 vs 110 for the same activity), and the bucket is sticky per id. The actor runs this many passes with fresh visitor ids and merges the results. 2 covered the full set in every test; 1 is faster but may under-collect; 3 adds redundancy.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The API answers direct requests too, but a proxy keeps long runs off a single IP. Note a proxy will NOT help with a 403 — that means the required header set changed." } } }, "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 } } } } } } } } } }