{ "openapi": "3.0.1", "info": { "title": "Ostrovok Hotels Scraper: Отели Островок", "description": "Scrape hotel prices, ratings, and availability from Ostrovok (Островок) by city and dates. Search by city name, filter by price, stars, rating, and free cancellation, then export normalized hotel data with per-night rates in RUB, USD, and EUR.", "version": "0.1", "x-build-id": "BbPojmZcbTXpI2hAM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ostrovok-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ostrovok-hotels-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-hotels-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-ostrovok-hotels-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-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-ostrovok-hotels-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": { "city": { "title": "City or region", "type": "string", "description": "City to search, e.g. 'moscow', 'sochi', 'saint-petersburg'. You can also paste a catalog slug like 'russia/moscow'. Leave blank if you supply a region ID or search URLs instead.", "default": "moscow" }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Leave blank to use tomorrow.", "default": "" }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Leave blank for a 2-night stay.", "default": "" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 6, "type": "integer", "description": "Number of adult guests per room.", "default": 2 }, "childrenAges": { "title": "Children ages", "type": "array", "description": "Ages of children staying, for example [5, 12]. Leave empty for adults only.", "default": [] }, "currency": { "title": "Currency", "enum": [ "RUB", "USD", "EUR", "KZT", "GBP" ], "type": "string", "description": "Currency for the returned prices.", "default": "RUB" }, "language": { "title": "Language", "enum": [ "ru", "en" ], "type": "string", "description": "Language for hotel names and room descriptions.", "default": "ru" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only return hotels at or above this total stay price, in the selected currency." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only return hotels at or below this total stay price, in the selected currency." }, "minRating": { "title": "Minimum guest rating", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only return hotels rated at or above this score. Ostrovok rates out of 10." }, "stars": { "title": "Star ratings", "type": "array", "description": "Only return hotels with these star ratings, for example [4, 5]. Leave empty for any.", "default": [] }, "freeCancellation": { "title": "Free cancellation only", "type": "boolean", "description": "Only return hotels offering at least one free-cancellation rate.", "default": false }, "maxItems": { "title": "Max hotels", "minimum": 1, "type": "integer", "description": "Maximum number of hotels to return.", "default": 100 }, "includeRawData": { "title": "Include raw API data", "type": "boolean", "description": "Attach Ostrovok's original unprocessed hotel and rate objects under a 'raw' field. Useful if you need a value this Actor does not map yet.", "default": false }, "regionId": { "title": "Region ID (advanced)", "type": "integer", "description": "Ostrovok's internal region ID, for example 2395 for Moscow. Skips the city lookup when set." }, "urls": { "title": "Ostrovok search URLs (optional)", "type": "array", "description": "Paste Ostrovok search URLs instead of a city name. The region is read from the URL.", "default": [], "items": { "type": "string" } }, "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 } } } } } } } } } }