# Cian RU – Property Listings, Search Filters & URLs (`abotapi/cian-ru-scraper`) Actor Collect property listings from Cian.ru by search filters or direct URLs. Returns structured rows with listing URL, title, price, address, rooms, area, floors, photos, visible contact fields, coordinates when available, and optional detail-page enrichment. - **URL**: https://apify.com/abotapi/cian-ru-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 dataset items 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.ru Property Scraper Collect property listings from Cian by search filters or direct URLs. Every row comes fully populated in a single fast pass: listing URL, title, price, address, rooms, area, floors, photos, coordinates, and contact phones. ### Input - `mode`: choose `search` for filters or `url` for pasted Cian URLs. - `urls`: Cian search-result URLs, used in URL mode. The filters below are ignored in URL mode, so encode filters in the URL itself. The next group applies to **search mode only**: - `location` / `regionId`: search area. Moscow is region `1`, Saint Petersburg is region `2`. - `operationType`: `sale` or `rent`. - `category`: flats, rooms, houses, new buildings, and commercial categories. - `sort`: default, price low→high, price per m² (asc/desc), area, newest, or walking time. - `rooms`, `includeStudio`: room-count filters (studio supported). - `minPrice` / `maxPrice` (RUB), `minArea` / `maxArea`, `minFloor` / `maxFloor`, `minFloors` / `maxFloors`. - `advancedFilters`: JSON object of raw Cian query fields for power users, e.g. `{"repair":{"type":"terms","value":[2,3]}}`. Output and limits (both modes): - `maxItems`: maximum rows to save. Fewer can be returned when results or filters match fewer live records. - `maxPages`: leave `0` for no page limit. The run stops at Max items. - `proxy`: residential proxy is recommended for this site. - `mcpConnectors`: select authorized Apify MCP connectors to export saved rows to your apps. ### Output Each dataset row includes: - `id`, `url`, `sourceUrl`, `title`, `jkName` - `price`, `priceValue`, `pricePerMeter`, `currency` - `address`, `district`, `metro`, `metroTime` - `roomsCount`, `totalArea`, `livingArea`, `kitchenArea`, `floorNumber`, `floorsCount`, `buildYear`, `materialType` - `dealType`, `category`, `offerType`, `isFromDeveloper`, `isPremium` - `description`, `phoneNumbers` - `latitude`, `longitude` - `imageUrls`, `creationDate`, `scrapedAt` ### Notes Use broad filters first, then narrow by price, rooms, and area. Phones, coordinates, descriptions, and photos are included on every row, so there is no separate detail step. Residential proxy is recommended. # Actor input Schema ## `mode` (type: `string`): Choose search filters or direct listing/search URLs. ## `urls` (type: `array`): Cian listing URLs or search-result URLs. Used only in URL mode. Encode any filters directly in the URL, because the search filters below are ignored in URL mode. ## `location` (type: `string`): Search mode only. City, region, district, metro, or address. Known defaults include Moscow and Saint Petersburg. ## `regionId` (type: `integer`): Search mode only. Optional Cian region ID. Moscow is 1, Saint Petersburg is 2. Leave empty to resolve from Location when possible. ## `operationType` (type: `string`): Search mode only. Deal type for search mode. ## `category` (type: `string`): Search mode only. Listing category. Choose Any to let operation and property type decide. ## `sort` (type: `string`): Search mode only. Sort results when supported by the selected source. ## `rooms` (type: `array`): Search mode only. Room counts for flats and rooms. ## `includeStudio` (type: `boolean`): Search mode only. Include studio listings together with selected room counts. ## `minPrice` (type: `integer`): Search mode only. Minimum price in rubles. ## `maxPrice` (type: `integer`): Search mode only. Maximum price in rubles. ## `minArea` (type: `integer`): Search mode only. Minimum total area in square meters. ## `maxArea` (type: `integer`): Search mode only. Maximum total area in square meters. ## `minFloor` (type: `integer`): Search mode only. Minimum floor. ## `maxFloor` (type: `integer`): Search mode only. Maximum floor. ## `minFloors` (type: `integer`): Search mode only. Minimum floors in the building. ## `maxFloors` (type: `integer`): Search mode only. Maximum floors in the building. ## `advancedFilters` (type: `object`): Search mode only. Raw Cian query objects merged into the search, e.g. {"repair":{"type":"terms","value":[2,3]}}. For power users who know Cian's query field names. ## `maxItems` (type: `integer`): Maximum matching rows to save. Fewer rows can be returned when the selected source and filters match fewer live records. ## `maxPages` (type: `integer`): No page limit when set to 0. The run stops at Max items. ## `proxy` (type: `object`): Proxy configuration. The default works on every plan. Switch groups if you start seeing access checks. ## `mcpConnectors` (type: `array`): Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON. The complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Maximum saved records to export to selected MCP connectors. ## Actor input object example ```json { "mode": "search", "urls": [ "https://www.cian.ru/kupit-kvartiru/" ], "location": "Москва", "operationType": "sale", "category": "", "sort": "default", "includeStudio": false, "maxItems": 20, "maxPages": 0, "proxy": { "useApifyProxy": true }, "maxNotifyListings": 50 } ```` # 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 = { "urls": [ "https://www.cian.ru/kupit-kvartiru/" ], "location": "Москва" }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/cian-ru-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 = { "urls": ["https://www.cian.ru/kupit-kvartiru/"], "location": "Москва", } # Run the Actor and wait for it to finish run = client.actor("abotapi/cian-ru-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 '{ "urls": [ "https://www.cian.ru/kupit-kvartiru/" ], "location": "Москва" }' | apify call abotapi/cian-ru-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/cian-ru-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cian RU – Property Listings, Search Filters & URLs", "description": "Collect property listings from Cian.ru by search filters or direct URLs. Returns structured rows with listing URL, title, price, address, rooms, area, floors, photos, visible contact fields, coordinates when available, and optional detail-page enrichment.", "version": "0.1", "x-build-id": "A7wSAa7dM0yGscuxC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~cian-ru-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-cian-ru-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/abotapi~cian-ru-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-cian-ru-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/abotapi~cian-ru-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-cian-ru-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": [ "mode", "maxItems" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose search filters or direct listing/search URLs.", "default": "search" }, "urls": { "title": "URLs", "type": "array", "description": "Cian listing URLs or search-result URLs. Used only in URL mode. Encode any filters directly in the URL, because the search filters below are ignored in URL mode.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Search mode only. City, region, district, metro, or address. Known defaults include Moscow and Saint Petersburg." }, "regionId": { "title": "Region ID", "minimum": 0, "type": "integer", "description": "Search mode only. Optional Cian region ID. Moscow is 1, Saint Petersburg is 2. Leave empty to resolve from Location when possible." }, "operationType": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Search mode only. Deal type for search mode.", "default": "sale" }, "category": { "title": "Category", "enum": [ "", "flatSale", "flatRent", "roomSale", "roomRent", "newBuildingFlatSale", "houseSale", "houseRent", "commercialLandSale", "commercialLandRent", "freeAppointmentObjectSale", "freeAppointmentObjectRent", "officeSale", "officeRent", "shoppingAreaSale", "shoppingAreaRent", "warehouseSale", "warehouseRent", "garageSale", "garageRent" ], "type": "string", "description": "Search mode only. Listing category. Choose Any to let operation and property type decide.", "default": "" }, "sort": { "title": "Sort", "enum": [ "default", "priceAscending", "priceForMeter", "priceForMeterDesc", "area", "date", "walkingTime" ], "type": "string", "description": "Search mode only. Sort results when supported by the selected source.", "default": "default" }, "rooms": { "title": "Rooms", "type": "array", "description": "Search mode only. Room counts for flats and rooms.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "Studio", "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms", "6 rooms" ] } }, "includeStudio": { "title": "Include studio", "type": "boolean", "description": "Search mode only. Include studio listings together with selected room counts.", "default": false }, "minPrice": { "title": "Min price (RUB)", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum price in rubles." }, "maxPrice": { "title": "Max price (RUB)", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum price in rubles." }, "minArea": { "title": "Min area", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum total area in square meters." }, "maxArea": { "title": "Max area", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum total area in square meters." }, "minFloor": { "title": "Min floor", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum floor." }, "maxFloor": { "title": "Max floor", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum floor." }, "minFloors": { "title": "Min building floors", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum floors in the building." }, "maxFloors": { "title": "Max building floors", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum floors in the building." }, "advancedFilters": { "title": "Advanced Cian filters", "type": "object", "description": "Search mode only. Raw Cian query objects merged into the search, e.g. {\"repair\":{\"type\":\"terms\",\"value\":[2,3]}}. For power users who know Cian's query field names." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum matching rows to save. Fewer rows can be returned when the selected source and filters match fewer live records.", "default": 20 }, "maxPages": { "title": "Max pages", "minimum": 0, "type": "integer", "description": "No page limit when set to 0. The run stops at Max items.", "default": 0 }, "proxy": { "title": "Proxy", "type": "object", "description": "Proxy configuration. The default works on every plan. Switch groups if you start seeing access checks.", "default": { "useApifyProxy": true } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON. The complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max connector items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum saved records to export to selected MCP connectors.", "default": 50 } } }, "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 } } } } } } } } } } ```