{ "openapi": "3.0.1", "info": { "title": "Yandex Realty Scraper - Russia Property, Prices & Estimates", "description": "Scrape Yandex Realty: Russian apartments, rooms, houses, land, garages and commercial property for sale or rent. Price, Yandex estimate, area ratings, metro, schools, building and seller info, photos. Add full description, price history and other listings in the building. 40+ filters.", "version": "2.0", "x-build-id": "2DQGh9JCk4S4murL8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~yandex-realty-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-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/normdata~yandex-realty-scraper/runs": { "post": { "operationId": "runs-sync-normdata-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/normdata~yandex-realty-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-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", "properties": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many listings in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "locations": { "title": "Cities or regions", "type": "array", "description": "Where to search, in English, Russian or as in Yandex Realty links: \"Moscow\", \"Санкт-Петербург\", \"Kazan\", \"moskovskaya_oblast\", \"krasnodarskiy_kray\". Each one is searched separately.", "items": { "type": "string" } }, "dealType": { "title": "Deal", "enum": [ "buy", "rent", "dailyRent" ], "type": "string", "description": "Buy, long term rent or daily rent." }, "category": { "title": "Property type", "enum": [ "apartment", "room", "house", "land", "garage", "commercial" ], "type": "string", "description": "What kind of property." }, "includeDetails": { "title": "Listing details (full description, price history, views, other listings in the building)", "type": "boolean", "description": "Also open each listing for its full description, number of views, the dated history of its price changes, earlier listings in the same building (first and last price, days listed), and the developer's name, legal name, phone, address and website for new buildings. Charged per listing as an add-on." }, "rooms": { "title": "Rooms", "type": "array", "description": "Apartments and rooms: how many rooms the apartment has.", "items": { "type": "string", "enum": [ "STUDIO", "1", "2", "3", "PLUS_4" ], "enumTitles": [ "Studio", "1 room", "2 rooms", "3 rooms", "4 rooms or more" ] } }, "market": { "title": "Market", "enum": [ "any", "new", "resale" ], "type": "string", "description": "Apartments for sale: new buildings or resale. As on the site, resale flats in new buildings show in both." }, "sellerTypes": { "title": "Seller", "type": "array", "description": "Keep only listings from these sellers. \"Owner\" alone uses the site's own \"no agents\" filter.", "items": { "type": "string", "enum": [ "OWNER", "AGENCY", "AGENT", "PRIVATE_AGENT", "DEVELOPER" ], "enumTitles": [ "Owner", "Agency", "Agent", "Private agent", "Developer" ] } }, "priceMin": { "title": "Minimum price (RUB)", "minimum": 0, "type": "integer", "description": "Total price, or monthly / daily rent. Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "priceMax": { "title": "Maximum price (RUB)", "minimum": 0, "type": "integer", "description": "Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "areaMin": { "title": "Minimum area (m²)", "minimum": 0, "type": "number", "description": "Land too: 1 sotka is 100 m². Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "areaMax": { "title": "Maximum area (m²)", "minimum": 0, "type": "number", "description": "Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "kitchenAreaMin": { "title": "Minimum kitchen area (m²)", "minimum": 0, "type": "number", "description": "Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "floorMin": { "title": "Minimum floor", "minimum": 0, "type": "integer", "description": "Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "floorMax": { "title": "Maximum floor", "minimum": 0, "type": "integer", "description": "Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "notFirstFloor": { "title": "Not the first floor", "type": "boolean", "description": "Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "notLastFloor": { "title": "Not the top floor", "type": "boolean", "description": "Leave out listings on the top floor of their building." }, "builtYearMin": { "title": "Built from (year)", "minimum": 0, "type": "integer", "description": "Keep only buildings built in or after this year." }, "builtYearMax": { "title": "Built until (year)", "minimum": 0, "type": "integer", "description": "Keep only buildings built in or before this year." }, "ceilingHeightMin": { "title": "Minimum ceiling height (m)", "minimum": 0, "type": "number", "description": "Like 2.7 or 3." }, "renovation": { "title": "Renovation", "type": "array", "description": "Keep only these renovation states.", "items": { "type": "string", "enum": [ "NO_RENOVATION", "NEEDS_RENOVATION", "COSMETIC_DONE", "EURO", "DESIGNER_RENOVATION", "PRIME_RENOVATION", "RENOVATED", "GOOD" ], "enumTitles": [ "None", "Needs renovation", "Cosmetic", "Euro renovation", "Designer", "Prime", "Renovated", "Good" ] } }, "decoration": { "title": "Finish (new buildings)", "type": "array", "description": "Keep only these finishes, as developers describe them.", "items": { "type": "string", "enum": [ "ROUGH", "PRE_CLEAN", "WHITE_BOX", "CLEAN", "TURNKEY", "NO_DECORATION" ], "enumTitles": [ "Rough finish", "Pre-finish", "White box", "Finished", "Turnkey", "No finish" ] } }, "buildingMaterials": { "title": "Building material", "type": "array", "description": "Keep only buildings made of these. Checked on each listing, as Yandex asks robots not to filter by it on the site.", "items": { "type": "string", "enum": [ "BRICK", "MONOLIT", "MONOLIT_BRICK", "PANEL", "BLOCK", "WOOD", "FERROCONCRETE" ], "enumTitles": [ "Brick", "Monolithic", "Monolithic brick", "Panel", "Block", "Wood", "Reinforced concrete" ] } }, "buildingEras": { "title": "Building era", "type": "array", "description": "Soviet era buildings: Stalin, Khrushchev or Brezhnev.", "items": { "type": "string", "enum": [ "STALIN", "KHRUSHCHEV", "BREZHNEV" ], "enumTitles": [ "Stalin era", "Khrushchev era", "Brezhnev era" ] } }, "legalApartments": { "title": "Apartments (apartamenty)", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Apartamenty are flats with non-residential legal status. Keep only them, or leave them out." }, "maxMetroMinutes": { "title": "Metro within (minutes)", "minimum": 0, "type": "integer", "description": "Keep only listings with a metro station within this many minutes. Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "metroOnFoot": { "title": "Metro on foot", "type": "boolean", "description": "With \"Metro within\": count only stations reached on foot." }, "onlyMortgage": { "title": "Mortgage possible", "type": "boolean", "description": "Keep only listings that can be bought with a mortgage." }, "onlyBelowEstimate": { "title": "Below the Yandex estimate", "type": "boolean", "description": "Keep only listings priced under the lowest Yandex price estimate for them: possible bargains." }, "onlyPriceDropped": { "title": "Price dropped", "type": "boolean", "description": "Keep only listings whose last price change was a drop." }, "postedWithinDays": { "title": "Posted in the last days", "minimum": 0, "type": "integer", "description": "Keep only listings published in the last this many days. Checked on each listing, as Yandex asks robots not to filter by it on the site." }, "withPhotos": { "title": "With photos", "type": "boolean", "description": "Keep only listings with photos." }, "withVirtualTour": { "title": "With 3D tour", "type": "boolean", "description": "Keep only listings with a 3D or virtual tour." }, "withVideo": { "title": "With video", "type": "boolean", "description": "Keep only listings with a video." }, "onlineViewing": { "title": "Online viewing", "type": "boolean", "description": "Keep only listings the seller can show by video call." }, "nearPark": { "title": "Near a park", "type": "boolean", "description": "Keep only listings with a park nearby." }, "nearWater": { "title": "Near water", "type": "boolean", "description": "Keep only listings with a river, lake or pond nearby." }, "furnished": { "title": "Furnished (rent)", "type": "boolean", "description": "Rent: keep only furnished listings." }, "petsAllowed": { "title": "Pets allowed (rent)", "type": "boolean", "description": "Rent: keep only listings that allow pets." }, "childrenAllowed": { "title": "Children allowed (rent)", "type": "boolean", "description": "Rent: keep only listings that allow children." }, "noAgentFee": { "title": "No agent fee (rent)", "type": "boolean", "description": "Rent: keep only listings without an agent commission." }, "rentAmenities": { "title": "Appliances (rent)", "type": "array", "description": "Rent: keep only listings with all of these.", "items": { "type": "string", "enum": [ "hasRefrigerator", "hasWashingMachine", "hasDishwasher", "hasAircondition", "hasTelevision" ], "enumTitles": [ "Fridge", "Washing machine", "Dishwasher", "Air conditioning", "TV" ] } }, "houseTypes": { "title": "House type", "type": "array", "description": "Houses: keep only these.", "items": { "type": "string", "enum": [ "HOUSE", "PARTHOUSE", "TOWNHOUSE", "DUPLEX" ], "enumTitles": [ "House", "Part of a house", "Townhouse", "Duplex" ] } }, "lotTypes": { "title": "Land type", "type": "array", "description": "Land: keep only these.", "items": { "type": "string", "enum": [ "IGS", "GARDEN", "FARM" ], "enumTitles": [ "Individual housing (IZhS)", "Garden plot", "Farm land" ] } }, "garageTypes": { "title": "Garage type", "type": "array", "description": "Garages: keep only these.", "items": { "type": "string", "enum": [ "BOX", "GARAGE", "PARKING_PLACE" ], "enumTitles": [ "Box", "Garage", "Parking space" ] } }, "commercialTypes": { "title": "Commercial type", "type": "array", "description": "Commercial: keep only these uses.", "items": { "type": "string", "enum": [ "OFFICE", "RETAIL", "FREE_PURPOSE", "WAREHOUSE", "MANUFACTURING", "LAND", "PUBLIC_CATERING", "AUTO_REPAIR", "HOTEL", "BUSINESS", "LEGAL_ADDRESS" ], "enumTitles": [ "Office", "Retail", "Free purpose", "Warehouse", "Manufacturing", "Land", "Catering", "Car service", "Hotel", "Ready business", "Legal address" ] } }, "commercialBuildingTypes": { "title": "Commercial building", "type": "array", "description": "Commercial: keep only these kinds of building.", "items": { "type": "string", "enum": [ "BUSINESS_CENTER", "SHOPPING_CENTER", "WAREHOUSE", "DETACHED_BUILDING", "RESIDENTIAL_BUILDING" ], "enumTitles": [ "Business center", "Shopping center", "Warehouse complex", "Detached building", "Residential building" ] } }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Skip listings saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Listings (https://realty.yandex.ru/offer/5180127926973844447/) or searches copied from the site (https://realty.yandex.ru/moskva/kupit/kvartira/dvuhkomnatnaya/).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }