{
"openapi": "3.0.1",
"info": {
"title": "Yandex Realty Scraper - Парсер Яндекс Недвижимости",
"description": "Парсер Яндекс Недвижимости (realty.yandex.ru). Квартиры, дома, комнаты, коммерция, участки — 80+ городов России. Цены, фото, телефоны, история цен. Extract Russian real estate listings with prices, photos, contacts, and price history. JSON, CSV, Excel. No auth required.",
"version": "0.0",
"x-build-id": "fBPfdo8dYDNUuCDMi"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~yandex-realty-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-yandex-realty-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/zen-studio~yandex-realty-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-yandex-realty-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/zen-studio~yandex-realty-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-yandex-realty-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": [
"dealType",
"category"
],
"properties": {
"region": {
"title": "Region (Регион)",
"enum": [
"",
"abakan",
"altayskiy-kray",
"amurskaya-oblast",
"anadyr",
"armavir",
"arhangelsk",
"arhangelskaya-oblast",
"astrahanskaya-oblast",
"astrahan",
"balashiha",
"barnaul",
"belgorod",
"belgorodskaya-oblast",
"birobidzhan",
"amurskaya-oblast-blagoveschensk",
"bryansk",
"bryanskaya-oblast",
"velikiy-novgorod",
"vladivostok",
"vladikavkaz",
"vladimir",
"vladimirskaya-oblast",
"volgograd",
"volgogradskaya-oblast",
"volzhskiy",
"vologda",
"vologodskaya-oblast",
"voronezh",
"voronezhskaya-oblast",
"gorno-altaysk",
"groznyy",
"evreyskaya-ao",
"ekaterinburg",
"zabaykalskiy-kray",
"ivanovo",
"ivanovskaya-oblast",
"izhevsk",
"irkutsk",
"irkutskaya-oblast",
"yoshkar-ola",
"kabardino-balkariya",
"kazan",
"kaliningrad",
"kaliningradskaya-oblast",
"kaluga",
"kaluzhskaya-oblast",
"kamchatskiy-kray",
"karachaevo-cherkesiya",
"kemerovo",
"kemerovskaya-oblast",
"kirovskaya-oblast-kirov",
"kirovskaya-oblast",
"komsomolsk-na-amure",
"kostroma",
"kostromskaya-oblast",
"krasnogorsk",
"krasnodar",
"krasnodarskiy-kray",
"krasnoyarsk",
"kurgan",
"kurganskaya-oblast",
"kursk",
"kurskaya-oblast",
"kyzyl",
"leningradskaya-oblast",
"lipetsk",
"lipetskaya-oblast",
"lyubertsy",
"magadan",
"magadanskaya-oblast",
"magas",
"magnitogorsk",
"maykop",
"mahachkala",
"moskva",
"moskva-i-moskovskaya-oblast",
"moskovskaya-oblast",
"murmansk",
"murmanskaya-oblast",
"mytischi",
"naberezhnye-chelny",
"nalchik",
"naryan-mar",
"nenetskiy-ao",
"nizhegorodskaya-oblast",
"nizhnevartovsk",
"nizhnekamsk",
"nizhniy-novgorod",
"nizhniy-tagil",
"novgorodskaya-oblast",
"novozybkov",
"novokuznetsk",
"novorossiysk",
"novosibirsk",
"novosibirskaya-oblast",
"omsk",
"omskaya-oblast",
"orenburg",
"orenburgskaya-oblast",
"orlovskaya-oblast",
"orel",
"penza",
"penzenskaya-oblast",
"permskiy-kray",
"perm",
"petrozavodsk",
"petropavlovsk-kamchatskiy",
"podolsk",
"primorskiy-kray",
"pskov",
"pskovskaya-oblast",
"bashkortostan",
"buryatiya",
"dagestan",
"kareliya",
"komi",
"mariy-el",
"mordoviya",
"saha-yakutiya",
"severnaya-osetiya",
"tatarstan",
"rostov-na-donu",
"rostovskaya-oblast",
"ryazanskaya-oblast",
"ryazan",
"salehard",
"samara",
"samarskaya-oblast",
"sankt-peterburg",
"sankt-peterburg-i-leningradskaya-oblast",
"saransk",
"saratov",
"saratovskaya-oblast",
"sahalinskaya-oblast",
"sverdlovskaya-oblast",
"sevastopol",
"simferopol",
"smolensk",
"smolenskaya-oblast",
"sochi",
"stavropol",
"stavropolskiy-kray",
"staryy-oskol",
"sterlitamak",
"surgut",
"syktyvkar",
"taganrog",
"tambov",
"tambovskaya-oblast",
"tverskaya-oblast",
"tver",
"tolyatti",
"tomsk",
"tomskaya-oblast",
"tula",
"tulskaya-oblast",
"tyumenskaya-oblast",
"tyumen",
"udmurtiya",
"ulan-ude",
"ulyanovsk",
"ulyanovskaya-oblast",
"ufa",
"habarovsk",
"habarovskiy-kray",
"hanty-mansiysk",
"hanty-mansiyskiy-ao",
"himki",
"cheboksary",
"chelyabinsk",
"chelyabinskaya-oblast",
"cherepovets",
"cherkessk",
"chechenskaya-respublika",
"chita",
"chuvashskiya",
"chukotskiy-ao",
"elista",
"yuzhno-sahalinsk",
"yakutsk",
"yamalo-nenetskiy-ao",
"yaroslavl",
"yaroslavskaya-oblast"
],
"type": "string",
"description": "Pick a region, oblast, krai, republic, or city. The label shows the Cyrillic display name and the slug used internally.
Takes precedence over City. To search by City instead, choose — Not listed? Use City below — here.
Covers 183 regions and major cities. For anywhere else — smaller towns, suburbs, or a single city district — use City."
},
"location": {
"title": "City (Город)",
"type": "string",
"description": "Free-text city, town, suburb, or city district. Used only when Region is left unset.
Examples: Реутов, Химки, Новокосино, Krasnoyarsk, Питер. Cyrillic, Latin transliteration, English exonyms and common abbreviations all work.
Resolves to the exact place named, so a district returns just that district."
},
"dealType": {
"title": "Deal Type",
"enum": [
"SELL",
"RENT"
],
"type": "string",
"description": "Buy or rent.",
"default": "SELL"
},
"category": {
"title": "Property Type",
"enum": [
"APARTMENT",
"ROOMS",
"HOUSE",
"LOT",
"COMMERCIAL",
"GARAGE"
],
"type": "string",
"description": "Category of properties to search.",
"default": "APARTMENT"
},
"maxItems": {
"title": "Max Listings",
"minimum": 0,
"type": "integer",
"description": "Maximum number of listings to collect.
Set 0 to scrape all available listings in the city.
Start small (10–50) for your first run to check the output.",
"default": 100
},
"priceMin": {
"title": "Price From, ₽",
"type": "integer",
"description": "Minimum price in rubles.
For sales — total price. For rentals — monthly rent."
},
"priceMax": {
"title": "Price To, ₽",
"type": "integer",
"description": "Maximum price in rubles."
},
"roomsTotal": {
"title": "Rooms",
"type": "array",
"description": "Filter by room count. Multi-select.",
"items": {
"type": "string",
"enum": [
"STUDIO",
"1",
"2",
"3",
"PLUS_4"
],
"enumTitles": [
"Studio",
"1 Room",
"2 Rooms",
"3 Rooms",
"4+"
]
}
},
"areaMin": {
"title": "Area From, m²",
"type": "number",
"description": "Minimum total area in square meters."
},
"areaMax": {
"title": "Area To, m²",
"type": "number",
"description": "Maximum total area in square meters."
},
"floorMin": {
"title": "Floor From",
"type": "integer",
"description": "Minimum floor."
},
"floorMax": {
"title": "Floor To",
"type": "integer",
"description": "Maximum floor."
},
"agents": {
"title": "Exclude Agents",
"enum": [
"NO"
],
"type": "string",
"description": "Show only listings from owners (no agencies or intermediaries)."
},
"sort": {
"title": "Sort",
"enum": [
"RELEVANCE",
"DATE_DESC",
"PRICE",
"PRICE_DESC",
"AREA",
"AREA_DESC",
"COMMISSIONING_DATE"
],
"type": "string",
"description": "Sort order for results.",
"default": "RELEVANCE"
},
"includePhones": {
"title": "Phone Numbers",
"type": "boolean",
"description": "Collect seller phone numbers for each listing.
Enabled by default — most users need phones to contact sellers.
Disable to save costs if you only need property data.",
"default": true
},
"includePriceHistory": {
"title": "Price History",
"type": "boolean",
"description": "Include price change history.
Shows how the listing price changed over time — useful for market analysis and negotiation.",
"default": false
},
"includeComplexData": {
"title": "New Development Details",
"type": "boolean",
"description": "Include full details of the residential complex a new-build listing belongs to.
Adds the developer and their track record, building class and features, delivery dates, documents, 3D tours and panoramas, sales office contacts, price and availability statistics, floor plans, and a quarter-by-quarter construction photo timeline.
Only applies to listings in a residential complex; resale listings are unaffected. Each complex is fetched and charged once per run no matter how many listings share it. Switch off if you only need the listings themselves and want smaller records.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Proxy settings. Residential proxies recommended for stable operation."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}