{ "openapi": "3.0.1", "info": { "title": "Yandex Realty Russia Property Listings Scraper", "description": "Structured property listings from Yandex Realty across Russia: sale and rental offers for apartments, houses, land, commercial, and garages. Records include price, area, floor, address, metro, seller type, plus new-build detail (complex, developer, quarter). Covers every major region by default.", "version": "0.1", "x-build-id": "cuFqBo7Vg63NGE8qY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~yandex-realty-russia-property-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-yandex-realty-russia-property-listings-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/jungle_synthesizer~yandex-realty-russia-property-listings-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-yandex-realty-russia-property-listings-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/jungle_synthesizer~yandex-realty-russia-property-listings-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-yandex-realty-russia-property-listings-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": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "resumeCursor": { "title": "Resume cursor (continue a previous run)", "type": "string", "description": "Leave empty for a fresh crawl. To CONTINUE a previous run where it stopped — without paying again for records you already received — paste the `resumeCursor` value from that run's Output (the run's OUTPUT key). Resume promptly: the previous run's data expires with your account's retention window (free tier: your ~10 most recent runs)." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to scrape." }, "regions": { "title": "Regions", "type": "array", "description": "Which Russian regions to crawl (cities and federal subjects). Leave empty to crawl every supported region — the national default.", "items": { "type": "string", "enum": [ "moskva", "sankt-peterburg", "novosibirsk", "ekaterinburg", "kazan", "nizhniy_novgorod", "krasnoyarsk", "chelyabinsk", "samara", "ufa", "rostov-na-donu", "krasnodar", "omsk", "voronezh", "perm", "volgograd", "scherbinka", "zelenograd", "moskovskiy", "troitsk", "ivanteevka", "himki", "pushkino", "sverdlovskaya_oblast", "novosibirskaya_oblast", "krasnodarskiy_kray", "leningradskaya_oblast", "rostovskaya_oblast", "sevastopol", "primorskiy_kray", "habarovskiy_kray", "bashkortostan", "stavropolskiy_kray", "altayskiy_kray", "permskiy_kray", "irkutskaya_oblast", "kemerovskaya_oblast_kuzbass", "tulskaya_oblast", "belgorodskaya_oblast", "voronezhskaya_oblast", "samarskaya_oblast", "saratovskaya_oblast", "tyumenskaya_oblast", "omskaya_oblast", "chelyabinskaya_oblast", "tatarstan", "dagestan", "severnaya_osetiya", "mariy_el", "mordoviya", "komi", "buryatiya", "tyva", "hakasiya", "altay", "ingushetiya", "chechenskaya_respublika", "kalmykiya", "krym", "kabardino-balkariya", "kareliya", "vladimirskaya_oblast", "yaroslavskaya_oblast", "ryazanskaya_oblast", "lipetskaya_oblast", "tambovskaya_oblast", "kurskaya_oblast", "bryanskaya_oblast", "smolenskaya_oblast", "tverskaya_oblast", "pskovskaya_oblast", "novgorodskaya_oblast", "vologodskaya_oblast", "arhangelskaya_oblast", "murmanskaya_oblast", "kaliningradskaya_oblast", "orlovskaya_oblast", "penzenskaya_oblast", "ulyanovskaya_oblast", "kirovskaya_oblast", "kostromskaya_oblast", "ivanovskaya_oblast", "astrahanskaya_oblast", "volgogradskaya_oblast", "orenburgskaya_oblast", "kurganskaya_oblast", "tomskaya_oblast", "zabaykalskiy_kray", "amurskaya_oblast", "sahalinskaya_oblast", "kamchatskiy_kray", "magadanskaya_oblast", "adygeya" ], "enumTitles": [ "Москва", "Санкт-Петербург", "Новосибирск", "Екатеринбург", "Казань", "Нижний Новгород", "Красноярск", "Челябинск", "Самара", "Уфа", "Ростов-на-Дону", "Краснодар", "Омск", "Воронеж", "Пермь", "Волгоград", "Щербинка", "Зеленоград", "Московский", "Троицк", "Ивантеевка", "Химки", "Пушкино", "Свердловская область", "Новосибирская область", "Краснодарский край", "Ленинградская область", "Ростовская область", "Севастополь", "Приморский край", "Хабаровский край", "Башкортостан", "Ставропольский край", "Алтайский край", "Пермский край", "Иркутская область", "Кемеровская область (Кузбасс)", "Тульская область", "Белгородская область", "Воронежская область", "Самарская область", "Саратовская область", "Тюменская область", "Омская область", "Челябинская область", "Татарстан", "Дагестан", "Северная Осетия", "Марий Эл", "Мордовия", "Коми", "Бурятия", "Тыва", "Хакасия", "Алтай", "Ингушетия", "Чеченская Республика", "Калмыкия", "Крым", "Кабардино-Балкария", "Карелия", "Владимирская область", "Ярославская область", "Рязанская область", "Липецкая область", "Тамбовская область", "Курская область", "Брянская область", "Смоленская область", "Тверская область", "Псковская область", "Новгородская область", "Вологодская область", "Архангельская область", "Мурманская область", "Калининградская область", "Орловская область", "Пензенская область", "Ульяновская область", "Кировская область", "Костромская область", "Ивановская область", "Астраханская область", "Волгоградская область", "Оренбургская область", "Курганская область", "Томская область", "Забайкальский край", "Амурская область", "Сахалинская область", "Камчатский край", "Магаданская область", "Адыгея" ] } }, "dealTypes": { "title": "Deal Types", "type": "array", "description": "Sale and/or rental listings. Leave empty to crawl both.", "items": { "type": "string", "enum": [ "kupit", "snyat" ], "enumTitles": [ "For sale", "For rent" ] } }, "propertyTypes": { "title": "Property Types", "type": "array", "description": "Which property categories to include. Leave empty to crawl all.", "items": { "type": "string", "enum": [ "kvartira", "komnata", "dom", "uchastok", "kommercheskaya", "garazh" ], "enumTitles": [ "Apartment", "Room", "House", "Land plot", "Commercial", "Garage" ] } } } }, "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 } } } } } } } } } }