{ "openapi": "3.0.1", "info": { "title": "Ostrovok Reviews Scraper: Отзывы Островок", "description": "Scrape hotel guest reviews from Ostrovok (Островок) with the full review text, star rating, category scores, traveller type, guest photos, and the hotel's reply. Filter by rating or traveller type and export to JSON, CSV, or Excel.", "version": "0.1", "x-build-id": "DcuDz096fpWBDTuEE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ostrovok-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ostrovok-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/getascraper~ostrovok-reviews-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-ostrovok-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/getascraper~ostrovok-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-ostrovok-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", "properties": { "hotels": { "title": "Hotels", "type": "array", "description": "Hotel IDs to scrape reviews for, e.g. 'radisson_blu_olympiyskiy_hotel'. You can find these in the Ostrovok Hotels Scraper output, or just paste hotel page URLs below instead.", "default": [ "radisson_blu_olympiyskiy_hotel" ], "items": { "type": "string" } }, "urls": { "title": "Ostrovok hotel URLs", "type": "array", "description": "Paste full Ostrovok hotel page URLs. The hotel is read from the URL, so no dates or guest parameters are needed.", "default": [], "items": { "type": "string" } }, "language": { "title": "Language", "enum": [ "ru", "en" ], "type": "string", "description": "Language for reviews and room names. Most Ostrovok reviews are written in Russian.", "default": "ru" }, "sortBy": { "title": "Sort reviews by", "enum": [ "relevance_desc", "date_desc", "rate_desc", "rate_asc" ], "type": "string", "description": "Order in which reviews are returned.", "default": "relevance_desc" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only return reviews rated at or above this score. Ostrovok rates out of 10." }, "maxRating": { "title": "Maximum rating", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only return reviews rated at or below this score. Set this to 6 to pull complaints only." }, "withTextOnly": { "title": "Only reviews with written text", "type": "boolean", "description": "Skip ratings-only reviews where the guest left no comment.", "default": false }, "travellerTypes": { "title": "Traveller types", "type": "array", "description": "Only return reviews from these traveller types, e.g. ['family', 'couple', 'solo', 'business']. Leave empty for all.", "default": [] }, "maxItemsPerHotel": { "title": "Max reviews per hotel", "minimum": 1, "type": "integer", "description": "Maximum number of reviews to return for each hotel.", "default": 100 }, "includeRawData": { "title": "Include raw API data", "type": "boolean", "description": "Attach Ostrovok's original unprocessed review object under a 'raw' field.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Datacenter proxies (the default) work reliably here and cost far less. Switch to Residential only if a very large run hits rate limits.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }