# Cian Scraper — Russia Property Data & API (`sian.agency/cian-property-scraper`) Actor Cian scraper & real estate data API for Russia's #1 property portal. Sale & rent listings nationwide — flats, rooms, houses, commercial & new builds: price, price/m², rooms, area, floor, metro, GPS, building, seller — clean JSON/CSV. - **URL**: https://apify.com/sian.agency/cian-property-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 5 total users, 3 monthly users, 72.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.70 / 1,000 overview listings 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Cian Scraper — Russia Property Data & API 🏠 [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Idealista](https://img.shields.io/badge/Store-Idealista-E60023)](https://apify.com/sian.agency/smart-idealista-scraper?fpr=sian) [![Zoopla](https://img.shields.io/badge/Store-Zoopla-7B1FA2)](https://apify.com/sian.agency/zoopla-property-scraper?fpr=sian) [![Immobiliare](https://img.shields.io/badge/Store-Immobiliare-1A8917)](https://apify.com/sian.agency/immobiliare-property-scraper?fpr=sian) #### 🇷🇺 Turn Cian — Russia's #1 real-estate portal (~31M visits/month) — into clean, structured property data. ##### For investors, analysts, PropTech teams and lead-gen pros who need Moscow, St Petersburg & nationwide listings as JSON, CSV or Excel — no account, no API key. --- ### 📋 Overview **Cian (Циан) is the largest real-estate marketplace in Russia** — millions of for-sale and for-rent listings across flats, rooms, houses, land, commercial space and new-build complexes (ЖК). This scraper pulls them into a clean dataset you can analyze, enrich or feed straight into your own pipeline. **Why professionals choose this actor:** - ✅ **Nationwide coverage**: Moscow, St Petersburg and any Cian region — by ID, filters, or pasted search URL. - ⚡ **Fast & high-throughput**: pulls a full page of listings per request — thousands of properties per run. - 🎯 **Rich, structured fields**: price, price/m², rooms, area, floor, metro & walk time, GPS, building material/year, complex & developer, seller type — all normalized. - 💸 **Transparent pay-per-result**: a generous free tier, then pay only for the listings you keep. No charge until your input is validated. - 💎 **Two depths**: fast & cheap **Overview** (every core field from the search results) or full **Detail** (complete description, all photos, full building & seller data per listing). - 🛏️ **Native filters & sort**: deal type, property type, rooms, price & area ranges, new-builds only, and Cian's own sort orders — exactly the levers you'd use on the site. --- ### 🎯 Use Cases - **Investor & buyer lead-gen** — surface fresh listings by region, price band and rooms. - **Price-per-m² market analysis** — track ₽/m² across districts, metro lines and new-build complexes. - **Realtor & developer intelligence** — monitor who's listing what, by seller type (agency, developer, owner, realtor). - **New-build (ЖК) tracking** — follow developer inventory, completion deadlines and complex-level pricing. - **Rental-yield research** — pair sale and rent pulls in the same area to model gross yield. - **Portfolio & competitor monitoring** — watch a saved search and diff it run-over-run. --- ### 🚀 Quick Start 1. **Choose a mode** — start with **Overview** (fast & cheap). 2. **Pick your market** — set the **Deal type** (sale/rent), **Property type** (flat, room, house, land, commercial), and **Region ID** (1 = Moscow, 2 = St Petersburg). Or just paste a **Cian search URL**. 3. **Add filters** *(optional)* — rooms, price range, area range, new-builds only, sort order. 4. **Set Max results** and **Run**. #### Paste a search URL Build any search on Cian (set filters, sort, region), copy the URL from the address bar, and drop it into **Search URLs** — every on-page filter is preserved. ```` https://www.cian.ru/cat.php?deal\_type=sale\&engine\_version=2\&offer\_type=flat\®ion=1\&room2=1 ```` --- ### 📥 Input | Field | Description | |---|---| | **Scrape mode** | `overview` (fast, all core fields) or `detail` (full per-listing fields). | | **Search by** | Auto-detected: by search URL, or by listing URL (detail only). | | **Deal type** | `sale` or `rent`. | | **Property type** | flat · room · house · townhouse · land · commercial. | | **Region ID** | Cian region (1 = Moscow, 2 = St Petersburg, …). | | **New builds only** | Restrict to new-build (ЖК) offers. | | **Rooms** | One or more room counts (1–5; 5 = 5+). | | **Search URLs** | Paste Cian search-results URLs — all filters preserved. | | **Listing URLs** | Detail mode: specific listing URLs to fetch. | | **Price / Area range** | Min/max price (₽) and min/max area (m²). | | **Sort** | Price ↑ · Price/m² · Newest · Area · Walk time to metro. | | **Max results** | Run cap. Free tier: 25/run. Paid: unlimited. | --- ### 📤 Output Each listing is one clean record. Sample fields: | Field | Example | |---|---| | `id` | `317927888` | | `url` | `https://www.cian.ru/sale/flat/317927888/` | | `deal_type` / `offer_type` | `sale` / `flat` | | `price` / `currency` / `price_rub` | `44426100` / `rur` / `44426100` | | `price_per_sqm` | `955400` | | `rooms` / `area_total` / `floor` / `floors_total` | `1` / `46.5` / `12` / `18` | | `is_new_building` / `building_material` / `building_year` | `true` / `monolith` / `2025` | | `jk_name` / `developer_name` | `ЖК SHIFT` / … | | `city` / `district` / `address` | `Москва` / … | | `lat` / `lng` | `55.70` / `37.58` | | `metro` / `metro_minutes` / `metro_transport` | `Ленинский проспект` / `10` / `walk` | | `seller_type` / `seller_name` / `phone` | `developer` / … / `+7…` | | `photos` / `photo_count` / `description` | `[ … ]` / `12` / `…` | Export as **JSON, CSV or Excel** from the dataset, or pull via the Apify API. --- ### ❓ FAQ **Do I need a Cian account or API key?** No. Just configure the input and run. **Which regions are supported?** Any Cian region — pick the region ID off a Cian search URL (1 = Moscow, 2 = St Petersburg, and so on). **Overview vs Detail — which should I use?** Start with **Overview**: it already carries price, rooms, area, floor, metro, GPS, building and seller fields for most use cases. Switch to **Detail** only when you need the complete description, the full photo gallery and the richest per-listing data. **How is pricing calculated?** Pay-per-result: you're charged per listing extracted, with a free tier to try it out. Your input is validated **before** any charge. **Can I filter by price, rooms or new-builds?** Yes — all native Cian filters are exposed, or paste a search URL with the filters already applied. --- ### 🔗 More by SIÁN Agency - [Smart Idealista Scraper](https://apify.com/sian.agency/smart-idealista-scraper?fpr=sian) — Spain/Italy/Portugal property - [Zoopla Scraper](https://apify.com/sian.agency/zoopla-property-scraper?fpr=sian) — UK sale & rent - [Immobiliare.it Scraper](https://apify.com/sian.agency/immobiliare-property-scraper?fpr=sian) — Italy's #1 portal - [Browse all SIÁN actors →](https://apify.com/sian.agency?fpr=sian) ⭐ **Love this actor?** Leave a [5-star review](https://apify.com/sian.agency/cian-property-scraper/reviews) — it helps us build more features for you. --- _Independent tool, not affiliated with, endorsed by, or sponsored by Cian (Циан). All trademarks belong to their respective owners. Use responsibly and in line with applicable terms and laws._ # Actor input Schema ## `scrapeMode` (type: `string`): ⚡ **OVERVIEW** — fast, cheap, ungated. Pulls every core field straight from Cian's search results (price, price/m², rooms, area, floor, metro, GPS, building, seller). 🔍 **DETAIL** — full fields per listing, loaded from the listing page. Slower and priced higher per result. **TIP:** Start with Overview — upgrade to Detail only when you need the extra fields. ## `searchMode` (type: `string`): 🧭 How to tell the scraper what to fetch. **Usually leave this blank — it is auto-inferred** from which inputs you provide: - **By search URL** — paste one or more Cian search-results URLs (or build a search with the filters below). The default for Overview. - **By listing URL** — Detail mode only: paste specific listing URLs to fetch those exact properties. **NOTE:** *By listing URL* is valid only when Scrape mode = Detail. ## `deal` (type: `string`): 🤝 Whether to scrape properties **for sale** or **for rent**. ## `offerType` (type: `string`): 🏠 Which kind of property to search. ## `region` (type: `integer`): 🌍 Cian region ID to search. Common: **1** = Moscow · **2** = St Petersburg. Find any region's ID by opening a search on Cian and reading the `region=` value off the URL. ## `newBuild` (type: `boolean`): 🏗️ Restrict to new-build (ЖК) offers only. Leave off to include secondary-market listings. ## `rooms` (type: `array`): 🛏️ Optional. Room counts to filter by — add one or more (1–5). Use **5** for 5+ rooms. Example: `["1", "2"]` returns 1- and 2-room listings. ## `searchUrls` (type: `array`): 🔗 Cian search-results URLs to scrape. Used when **Search by = By search URL**. **TIP:** Build any search on Cian (set your filters, sort order, region), then copy the URL from the address bar — every on-page filter is honored. **BULK EDIT:** Click "Bulk edit" to paste many URLs, one per line. ## `listingUrls` (type: `array`): 🆔 **Detail mode only.** Specific Cian listing URLs to fetch as full property pages. **BULK EDIT:** Click "Bulk edit" to paste many URLs, one per line. ## `maxResults` (type: `integer`): 🔢 Maximum listings to extract this run. - **FREE tier:** capped at 25 listings per run. - **PAID tier:** unlimited — set as high as you need. ## `sort` (type: `string`): ↕️ How Cian orders the search results before they are scraped. ## `minPrice` (type: `integer`): 💸 Optional. Minimum price filter in roubles. ## `maxPrice` (type: `integer`): 💰 Optional. Maximum price filter in roubles. ## `minArea` (type: `integer`): 📐 Optional. Minimum total area in square metres. ## `maxArea` (type: `integer`): 📐 Optional. Maximum total area in square metres. ## Actor input object example ```json { "scrapeMode": "overview", "searchMode": "bySearchUrl", "deal": "sale", "offerType": "flat", "region": 1, "newBuild": false, "rooms": [ "1", "2" ], "searchUrls": [ "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat®ion=1" ], "listingUrls": [ "https://www.cian.ru/sale/flat/317927888/" ], "maxResults": 100 } ```` # Actor output Schema ## `results` (type: `string`): Scraped Cian listings (JSON/CSV/Excel). # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/cian-property-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 = {} # Run the Actor and wait for it to finish run = client.actor("sian.agency/cian-property-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call sian.agency/cian-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/cian-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cian Scraper — Russia Property Data & API", "description": "Cian scraper & real estate data API for Russia's #1 property portal. Sale & rent listings nationwide — flats, rooms, houses, commercial & new builds: price, price/m², rooms, area, floor, metro, GPS, building, seller — clean JSON/CSV.", "version": "1.0", "x-build-id": "Xl34v36QIdrYpeLZq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~cian-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-cian-property-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/sian.agency~cian-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-cian-property-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/sian.agency~cian-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-cian-property-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": { "scrapeMode": { "title": "⚡ Scrape mode", "enum": [ "overview", "detail" ], "type": "string", "description": "⚡ **OVERVIEW** — fast, cheap, ungated. Pulls every core field straight from Cian's search results (price, price/m², rooms, area, floor, metro, GPS, building, seller).\n\n🔍 **DETAIL** — full fields per listing, loaded from the listing page. Slower and priced higher per result.\n\n**TIP:** Start with Overview — upgrade to Detail only when you need the extra fields.", "default": "overview" }, "searchMode": { "title": "🧭 Search by (auto-detected)", "enum": [ "bySearchUrl", "byListingUrl" ], "type": "string", "description": "🧭 How to tell the scraper what to fetch. **Usually leave this blank — it is auto-inferred** from which inputs you provide:\n\n- **By search URL** — paste one or more Cian search-results URLs (or build a search with the filters below). The default for Overview.\n- **By listing URL** — Detail mode only: paste specific listing URLs to fetch those exact properties.\n\n**NOTE:** *By listing URL* is valid only when Scrape mode = Detail.", "default": "bySearchUrl" }, "deal": { "title": "🤝 Deal type", "enum": [ "sale", "rent" ], "type": "string", "description": "🤝 Whether to scrape properties **for sale** or **for rent**.", "default": "sale" }, "offerType": { "title": "🏠 Property type", "enum": [ "flat", "room", "house", "townhouse", "land", "commercial" ], "type": "string", "description": "🏠 Which kind of property to search.", "default": "flat" }, "region": { "title": "🌍 Region ID", "minimum": 1, "type": "integer", "description": "🌍 Cian region ID to search. Common: **1** = Moscow · **2** = St Petersburg. Find any region's ID by opening a search on Cian and reading the `region=` value off the URL.", "default": 1 }, "newBuild": { "title": "🏗️ New builds only", "type": "boolean", "description": "🏗️ Restrict to new-build (ЖК) offers only. Leave off to include secondary-market listings.", "default": false }, "rooms": { "title": "🛏️ Rooms", "type": "array", "description": "🛏️ Optional. Room counts to filter by — add one or more (1–5). Use **5** for 5+ rooms. Example: `[\"1\", \"2\"]` returns 1- and 2-room listings.", "items": { "type": "string" } }, "searchUrls": { "title": "🔗 Search URLs", "type": "array", "description": "🔗 Cian search-results URLs to scrape. Used when **Search by = By search URL**.\n\n**TIP:** Build any search on Cian (set your filters, sort order, region), then copy the URL from the address bar — every on-page filter is honored.\n\n**BULK EDIT:** Click \"Bulk edit\" to paste many URLs, one per line.", "items": { "type": "string" } }, "listingUrls": { "title": "🆔 Listing URLs", "type": "array", "description": "🆔 **Detail mode only.** Specific Cian listing URLs to fetch as full property pages.\n\n**BULK EDIT:** Click \"Bulk edit\" to paste many URLs, one per line.", "items": { "type": "string" } }, "maxResults": { "title": "🔢 Max results", "minimum": 1, "type": "integer", "description": "🔢 Maximum listings to extract this run.\n\n- **FREE tier:** capped at 25 listings per run.\n- **PAID tier:** unlimited — set as high as you need.", "default": 100 }, "sort": { "title": "↕️ Sort by", "enum": [ "price_object_order", "price_square_order", "creation_date_desc", "area_order", "walking_time" ], "type": "string", "description": "↕️ How Cian orders the search results before they are scraped." }, "minPrice": { "title": "💸 Min price (₽)", "minimum": 0, "type": "integer", "description": "💸 Optional. Minimum price filter in roubles." }, "maxPrice": { "title": "💰 Max price (₽)", "minimum": 0, "type": "integer", "description": "💰 Optional. Maximum price filter in roubles." }, "minArea": { "title": "📐 Min area (m²)", "minimum": 0, "type": "integer", "description": "📐 Optional. Minimum total area in square metres." }, "maxArea": { "title": "📐 Max area (m²)", "minimum": 0, "type": "integer", "description": "📐 Optional. Maximum total area in square metres." } } }, "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 } } } } } } } } } } ```