# Yandex Realty Russia Property Listings Scraper (`jungle_synthesizer/yandex-realty-russia-property-listings-scraper`) Actor 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. - **URL**: https://apify.com/jungle\_synthesizer/yandex-realty-russia-property-listings-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Real estate, Business - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 1,000 record scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Yandex Realty Russia Property Listings Scraper Scrape structured property listings from [Yandex Realty](https://realty.yandex.ru), Russia's leading structured real estate portal. Returns apartments, rooms, houses, land plots, garages, and commercial property — for sale or for rent — with price, area breakdown, floor, address, coordinates, nearest metro, seller class, and new-construction detail (residential complex name, developer, building year, handover quarter) that classifieds-style sites don't expose. *** ### Yandex Realty Scraper Features - Covers all six Yandex Realty property categories — apartments, rooms, houses, land plots, garages, and commercial space — for sale or for rent - New-build depth: residential complex (ЖК) name, developer, building year and series, and handover quarter for off-plan offers - Full area breakdown — total, living, and kitchen square meters — plus floor, ceiling height, and renovation state - Location detail: full address, coordinates, region/locality/district, and nearest metro station with walk/transit time - Classifies each seller as owner, agency, agent, or developer, and flags mortgage-eligible offers - Covers every major Russian region by default — filter down to specific regions, deal types, or property types as needed - Full coverage of large, high-volume markets — Moscow and other major cities are captured completely rather than a shallow first slice *** ### Who Uses Yandex Realty Data? - **Valuation and pricing desks** — build a Russian property price index across regions, cities, and property types - **Proptech platforms** — feed structured Russian real estate inventory into search, alerting, or valuation products - **Developer-inventory trackers** — monitor new-construction supply by residential complex, developer, and handover quarter - **Market researchers** — track pricing trends and inventory levels by region and property type over time *** ### How Yandex Realty Scraper Works 1. Give it a `maxItems` limit and, optionally, which regions, deal types, and property types to cover. 2. The scraper walks each selected region/deal-type/property-type combination's listing pages, saving every unique offer it finds. 3. Each listing comes back as one structured record with pricing, layout, location, and seller details — no manual HTML cleanup. 4. The run stops once it hits your `maxItems` limit or runs out of listings, whichever comes first. Real estate inventory turns over constantly — for a large, ongoing collection, run this actor on a schedule and use `maxItems` to bound each run's cost. Use `resumeCursor` (from a previous run's output) to pick up a large national crawl where it left off instead of starting over. *** ### Input ```json { "maxItems": 100, "regions": ["moskva", "sankt-peterburg"], "dealTypes": ["kupit"], "propertyTypes": ["kvartira"] } ``` | Field | Type | Default | Description | |-----------------|----------------------|------------------------|-------------| | `maxItems` | integer | — (required) | Maximum number of property listings to scrape. | | `regions` | array (multi-select) | every supported region | Which Russian regions to crawl — cities and federal subjects (e.g. `moskva`, `sankt-peterburg`, `sverdlovskaya_oblast`). Leave empty to crawl every supported region, the national default. | | `dealTypes` | array (multi-select) | both | `kupit` (for sale) and/or `snyat` (for rent). Leave empty for both. | | `propertyTypes` | array (multi-select) | all categories | Property categories to include: `kvartira` (apartment), `komnata` (room), `dom` (house), `uchastok` (land plot), `kommercheskaya` (commercial), `garazh` (garage). Leave empty for all. | #### Example: Apartments for rent in Kazan ```json { "maxItems": 200, "regions": ["kazan"], "dealTypes": ["snyat"], "propertyTypes": ["kvartira"] } ``` *** ### Yandex Realty Scraper Output Fields ```json { "offer_id": "5227565616455380446", "offer_url": "https://realty.yandex.ru/offer/5227565616455380446/", "deal_type": "kupit", "property_type": "kvartira", "price_rub": 11466000, "price_per_sqm_rub": 490000, "price_period": "sale", "currency": "RUB", "rooms": 1, "area_total_sqm": 23.4, "area_living_sqm": 20.9, "area_kitchen_sqm": 6.5, "floor": 4, "floors_total": 9, "ceiling_height_m": 2.7, "renovation": "cosmetic", "is_new_building": false, "building_name": null, "developer_name": null, "building_year": 1909, "building_series": "индивидуальный проект", "address": "Россия, Москва, Большая Грузинская улица, 32с1", "region": "Москва", "locality": "Москва", "district": null, "metro_station": "Баррикадная", "metro_time_min": 9, "metro_transport": "ON_FOOT", "latitude": 55.767204, "longitude": 37.579258, "seller_type": "AGENCY", "agency_name": "ИП Ромашина Анастасия Валерьевна", "agency_url": null, "is_mortgage_available": false, "commissioning_quarter": null, "description": "Уютная квартира рядом с метро.", "image_urls": ["https://avatars.mds.yandex.net/get-realty-offers/..."], "images_count": 5, "published_at": "2026-07-24T13:04:13Z", "updated_at": "2026-09-20T14:00:00Z", "scraped_at": "2026-09-20T20:01:00.811Z" } ``` | Field | Description | |-----------------------------------------------------------|-------------| | `offer_id` | Yandex Realty's internal offer id | | `offer_url` | Canonical Yandex Realty permalink for the offer | | `deal_type` | `kupit` (sale) or `snyat` (rent) | | `property_type` | `kvartira`, `komnata`, `dom`, `uchastok`, `kommercheskaya`, or `garazh` | | `price_rub` | Price in rubles (sale price or rent amount) | | `price_per_sqm_rub` | Price per square meter, when disclosed | | `price_period` | `sale` or `month` | | `currency` | Always `RUB` | | `rooms` | Room count; studios are `0` | | `area_total_sqm` / `area_living_sqm` / `area_kitchen_sqm` | Area breakdown in square meters, when disclosed | | `floor` / `floors_total` | Floor and building height | | `ceiling_height_m` | Ceiling height in meters, when disclosed | | `renovation` | Renovation state (`euro`, `cosmetic`, `designer`, `none`, and a few finer-grained values the source itself distinguishes) | | `is_new_building` | `true` for new-construction (novostroyka) offers | | `building_name` / `developer_name` | Residential complex (ЖК) name and developer, for new-build offers | | `building_year` / `building_series` | Year built and building series, when disclosed | | `address` | Full address | | `region` / `locality` / `district` | Location breakdown, when the source resolves that level | | `metro_station` / `metro_time_min` / `metro_transport` | Nearest metro station, walk/transit time, and mode | | `latitude` / `longitude` | Coordinates | | `seller_type` | `OWNER`, `AGENCY`, `AGENT`, or `DEVELOPER` | | `agency_name` / `agency_url` | Seller/agency identity, when disclosed | | `is_mortgage_available` | `true` when the offer is flagged as mortgage-eligible | | `commissioning_quarter` | Off-plan handover quarter (e.g. `Q4 2026`), new-build offers only | | `description` | Full listing description | | `image_urls` / `images_count` | Photo URLs and count | | `published_at` / `updated_at` | ISO-8601 publish and last-update timestamps | | `scraped_at` | ISO-8601 timestamp this record was scraped | Some fields depend on what a given offer discloses — a bare room listing and a full-page developer listing don't expose the same detail, and fields the source doesn't provide come back `null` rather than a guess. *** ### Resuming a Large Crawl A national run covers a large corpus. Every run's output includes a `resumeCursor` — pass it back in as input on your next run to continue from where the previous run left off instead of re-scraping from scratch. *** ### FAQ #### How do I scrape Yandex Realty listings? Create a task from this Actor, set `maxItems` and any region/deal-type/property-type filters you want, and run it. Results land in the run's dataset in structured JSON, ready to export as CSV, Excel, or JSON. #### What property types are covered? Apartments, rooms, houses, land plots, garages, and commercial property — for sale or for rent. #### Can I limit the crawl to specific regions? Yes — set `regions` to the Yandex Realty region/city slugs you want (e.g. `moskva`, `kazan`, `sverdlovskaya_oblast`). Leave it unset to cover every supported region. #### Does this include new-construction (novostroyka) offers? Yes — `is_new_building`, `building_name`, `developer_name`, and `commissioning_quarter` are populated whenever the source discloses them. #### Does this include closed or expired listings? No — every run scrapes what's live on Yandex Realty at the time it runs. *** ### Need More Features? Message us with your use case — custom fields, additional regions, or a different output shape can usually be added quickly. # Actor input Schema ## `sp_intended_usage` (type: `string`): What will this data feed? E.g. lead lists, KYB checks, price tracking. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): We'll personally help with your use case. No spam. ## `resumeCursor` (type: `string`): 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` (type: `integer`): Maximum number of records to scrape. ## `regions` (type: `array`): Which Russian regions to crawl (cities and federal subjects). Leave empty to crawl every supported region — the national default. ## `dealTypes` (type: `array`): Sale and/or rental listings. Leave empty to crawl both. ## `propertyTypes` (type: `array`): Which property categories to include. Leave empty to crawl all. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/yandex-realty-russia-property-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/yandex-realty-russia-property-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10 }' | apify call jungle_synthesizer/yandex-realty-russia-property-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,jungle_synthesizer/yandex-realty-russia-property-listings-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/2ib4lah8ea1l9mQF6/builds/cuFqBo7Vg63NGE8qY/openapi.json