# Cian Property Search Scraper (`stealth_mode/cian-property-search-scraper`) Actor

Scrape residential and commercial properties from CIAN.ru, Russia's largest real estate marketplace. Collect 97+ data fields including prices, locations, specifications, photos, and seller details — perfect for property aggregators, market analysis, and investment research.

- **URL**: https://apify.com/stealth\_mode/cian-property-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

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: Extract Russian Real Estate Listings at Scale

---

### What Is CIAN.ru?

CIAN.ru is Russia's leading online real estate marketplace, hosting hundreds of thousands of active property listings across residential, commercial, and land categories. It serves buyers, sellers, investors, and real estate professionals seeking properties in Moscow, St. Petersburg, and regions across the Russian Federation. Manually gathering property data from search results is inefficient — the **CIAN Property Search Scraper** automates extraction of detailed listings into structured, analyzable datasets.

---

### Overview

The **CIAN Property Scraper** extracts property listings from CIAN.ru search results pages, capturing 97+ fields per listing including price, specifications, location, media, and seller information. It is designed for:

- **Real estate aggregators** building multi-source property databases
- **Investment analysts** tracking market trends and pricing patterns
- **Market researchers** studying housing demand and supply dynamics
- **CRM systems** automating lead generation and property data syncing
- **Property developers** monitoring competitor listings and market positioning

The scraper handles pagination, seller anonymization flags, premium listing markers, and graceful failure recovery — ideal for large-scale extraction campaigns.

---

### Input Configuration

The scraper accepts a JSON configuration object with three primary parameters:

```json
{
  "urls": [
    "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=1&region=1"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

#### Input Parameters Explained

| Parameter | Type | Description | Example |
|---|---|---|---|
| `urls` | Array | CIAN.ru search result or category pages to scrape | `["https://www.cian.ru/cat.php?deal_type=sale&offer_type=flat&p=1&region=1"]` |
| `ignore_url_failures` | Boolean | If `true`, scraper continues if individual URLs fail; if `false`, stops on first error | `true` |
| `max_items_per_url` | Integer | Maximum property listings extracted per URL (1–200) | `200` |

#### URL Structure Tips

CIAN.ru search URLs typically follow this pattern:

```
https://www.cian.ru/cat.php?deal_type=DEAL_TYPE&offer_type=OFFER_TYPE&p=PAGE&region=REGION
```

- `deal_type=sale` → Buy listings; `deal_type=rent` → Rental listings
- `offer_type=flat` → Apartments; `offer_type=house` → Houses; `offer_type=land` → Land
- `region=1` → Moscow (region ID); vary for other cities/regions
- `p=1` → Page number (pagination)

You can paste multiple search URLs to scrape across different categories, price ranges, or neighborhoods in a single run.

***

### Output Format

**Sample output**

```json
{
  "similar": null,
  "is_new": false,
  "kitchen_area": "12.2",
  "layout": null,
  "is_by_commercial_owner": null,
  "living_area": "14.1",
  "published_user_id": 47108007,
  "access_type": null,
  "rooms_count": 1,
  "jk_url": "https://zhk-aleksandriya-kaliningrad-i.cian.ru/",
  "description": "Уютная однокомнатная квартира 42,6 м² — ваш идеальный выбор!\n\nПредлагается к продаже светлая и просторная однокомнатная квартира на втором этаже современного дома.\n\n Основные характеристики:\n\n- Площадь: 42,6 м²\n\n- Жилая: 14,1 м²\n\n- Кухня: 12,2 м²\n\n- Этаж: 2/9\n\n- Отопление: автономное (вы сами контролируете комфорт и расходы).\n\n- Окна: панорамные — много света.\n\n Расположение и инфраструктура:\n\nНа первом этаже дома — магазины и сервисные точки. В шаговой доступности находятся школа, детский сад и остановка общественного транспорта. Всё, что нужно для комфортной жизни, уже рядом!\n\n Для кого эта квартира?\n\n- Для молодой семьи — рядом всё необходимое для детей.\n\n- Для тех, кто ценит удобство и транспортную доступность.\n\n- Как инвестиция — ликвидный вариант с высоким спросом.\n\nВоспользуйтесь возможностью приобрести квартиру в районе с развитой инфраструктурой! Звоните, чтобы договориться о просмотре.",
  "is_booked_from_developer": null,
  "rooms_for_sale_count": null,
  "category": "flatSale",
  "office_type": null,
  "formatted_full_price": "7 500 000 ₽",
  "min_area": null,
  "bedrooms_count": null,
  "decoration": null,
  "work_time_info": null,
  "phones": [
    {
      "country_code": "7",
      "number": "9814624063"
    },
    {
      "country_code": "7",
      "number": "9114811361"
    }
  ],
  "videos": [
    {
      "duration": 116,
      "id": "865909f7-53c1-4b9e-8bd7-784425e17de8",
      "url": "https://kinescope.io/embed/hAddTrkVmXaTdu6hvm85Ho",
      "upload_date": null,
      "preview_url": "https://kinescopecdn.net/f9f281e3-5528-474a-b760-2c5cecf2ce98/posters/ead81449-df5b-4baf-9078-e144d031df7c/md/019df44e-32ae-7ac5-b171-788bd0d0a2ea.jpg",
      "type": "kinescope"
    }
  ],
  "humanized_timedelta": "2 недели назад",
  "is_rent_by_parts": false,
  "added_timestamp": 1779358581,
  "builders_ids": [
    11005
  ],
  "demolished_in_moscow_programm": false,
  "rosreestr_check": null,
  "land": null,
  "creation_date": "2026-04-21T13:16:08.64",
  "village_mortgage_allowed": false,
  "full_url": "https://kaliningrad.cian.ru/sale/flat/329223230/?context=4.wilXvGl_VIE.Mx8e87-Vea02Ze5JaI4yY2DZzGCY1L8y8xPF3wFU-pG7gxal-ugktw3XwQ3nKqJeUlABRsyDq2EqcA&mlSearchSessionGuid=4ebba0ab73ef8e6ccc8c87f14450bd9e",
  "is_calltracking_enabled": true,
  "deal_type": "sale",
  "status": "published",
  "balconies_count": 0,
  "formatted_short_price": "7 500 000 ₽",
  "building": {
    "material_type": "monolith",
    "access_type": null,
    "heating_type": null,
    "deadline": null,
    "parking": {
      "currency": null,
      "purpose_type": null,
      "is_free": null,
      "is_available": null,
      "places_count": null,
      "price_monthly": null,
      "price_entry": null,
      "type": "ground",
      "location_type": null
    },
    "class_type": null,
    "build_year": 2016,
    "type": null,
    "cargo_lifts_count": null,
    "passenger_lifts_count": 1,
    "floors_count": 9
  },
  "added": "21 май, 13:16",
  "is_need_hide_exact_address": false,
  "id": 329223230,
  "offer_type": "flat",
  "floor_number": 2,
  "total_area": "42.6",
  "is_imported": false,
  "basic_profi_score": 1,
  "is_auction": false,
  "is_standard": false,
  "is_top3": false,
  "auction": {
    "is_cpc_auction": true
  },
  "formatted_additional_info": "Свободная продажа, возможна ипотека",
  "is_colorized": false,
  "cian_id": 329223230,
  "offer_in_deal": false,
  "is_premium": false,
  "newbuilding": {
    "is_premium": false,
    "is_fichering": false,
    "id": 29969,
    "house": {
      "id": 86666,
      "name": "Дом №3-№4",
      "is_finished": true,
      "finish_date": {
        "year": 2016,
        "quarter": 2
      },
      "section": null
    },
    "name": "Александрия",
    "is_from_seller": false,
    "show_jk_reliable_flag": false,
    "is_from_lead_factory": false,
    "has_flat_tour_booking": false,
    "is_from_developer": false,
    "is_from_builder": false,
    "is_sales_leader": null
  },
  "is_recidivist": false,
  "user_id": 47108007,
  "title": null,
  "is_in_hidden_base": false,
  "flat_type": "rooms",
  "photos": [
    {
      "id": 2871273411,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273411-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273411-1.jpg",
      "is_default": true,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273411-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273411-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269527,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269527-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269527-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269527-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269527-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269523,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269523-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269523-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269523-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269523-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269504,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269504-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269504-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269504-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269504-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269536,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269536-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269536-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269536-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269536-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269586,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269586-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269586-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269586-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269586-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269650,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269650-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269650-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269650-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269650-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269573,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269573-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269573-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269573-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269573-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871273446,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273446-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273446-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273446-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273446-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871273449,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273449-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273449-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273449-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273449-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269632,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269632-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269632-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269632-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269632-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269649,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269649-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269649-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269649-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269649-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269618,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269618-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269618-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269618-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269618-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269652,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269652-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269652-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269652-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269652-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269605,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269605-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269605-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269605-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269605-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269502,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269502-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269502-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269502-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269502-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269545,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269545-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269545-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269545-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269545-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269497,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269497-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269497-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269497-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269497-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269532,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269532-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269532-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269532-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269532-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871273432,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273432-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273432-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273432-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273432-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269537,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269537-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269537-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269537-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269537-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871273451,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273451-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273451-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273451-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273451-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269622,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269622-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269622-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269622-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269622-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269624,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269624-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269624-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269624-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269624-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871269631,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269631-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269631-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269631-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871269631-2.jpg",
      "is_layout": false
    },
    {
      "id": 2871273352,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273352-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273352-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273352-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2871273352-2.jpg",
      "is_layout": false
    },
    {
      "id": 2861132313,
      "rotate_degree": null,
      "mini_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2861132313-3.jpg",
      "full_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2861132313-1.jpg",
      "is_default": false,
      "thumbnail2_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2861132313-4.jpg",
      "thumbnail_url": "https://images.cdn-cian.ru/images/kvartira-kaliningrad-yuriya-gagarina-ulica-2861132313-2.jpg",
      "is_layout": true
    }
  ],
  "categories_ids": [
    1,
    100,
    110,
    111
  ],
  "formatted_full_info": "1-комн.кв.  ·  42,6 м²  ·  2/9 этаж",
  "geo": {
    "address": [
      {
        "id": 4574,
        "name": "Калининградская",
        "qs": "deal_type=sale&engine_version=2&offer_type=flat&region=4574",
        "is_forming_address": true,
        "location_type_id": 2,
        "full_name": "Калининградская область",
        "short_name": "Калининградская область",
        "title": "Калининградская область",
        "geo_type": "location",
        "type": "location"
      },
      {
        "id": 4778,
        "name": "Калининград",
        "qs": "deal_type=sale&engine_version=2&offer_type=flat&region=4778",
        "is_forming_address": true,
        "location_type_id": 1,
        "full_name": "Калининград",
        "short_name": "Калининград",
        "title": "Калининград",
        "geo_type": "location",
        "type": "location"
      },
      {
        "id": 275,
        "name": "Ленинградский",
        "qs": "deal_type=sale&district%5B0%5D=275&engine_version=2&offer_type=flat",
        "is_forming_address": null,
        "location_type_id": null,
        "full_name": "р-н Ленинградский",
        "short_name": "р-н Ленинградский",
        "title": "р-н Ленинградский",
        "geo_type": "district",
        "type": "raion"
      },
      {
        "id": 779966,
        "name": "Юрия Гагарина",
        "qs": "deal_type=sale&engine_version=2&offer_type=flat&street%5B0%5D=779966",
        "is_forming_address": true,
        "location_type_id": null,
        "full_name": "улица Юрия Гагарина",
        "short_name": "ул. Юрия Гагарина",
        "title": "улица Юрия Гагарина",
        "geo_type": "street",
        "type": "street"
      },
      {
        "id": 2067800,
        "name": "16В",
        "qs": "deal_type=sale&engine_version=2&house%5B0%5D=2067800&offer_type=flat",
        "is_forming_address": true,
        "location_type_id": null,
        "full_name": "16В",
        "short_name": "16В",
        "title": "16В",
        "geo_type": "house",
        "type": "house"
      }
    ],
    "coordinates": {
      "lng": 20.543967,
      "lat": 54.719529
    },
    "undergrounds": [],
    "jk": {
      "id": 29969,
      "house": {
        "id": 86666,
        "name": "Дом №3-№4"
      },
      "name": "Александрия",
      "ga_geo": {
        "mo_id": 0,
        "obl_id": 4574,
        "city_id": 4778
      },
      "web_site_url_utm": null,
      "web_site_url": null,
      "developer": null,
      "full_url": "https://zhk-aleksandriya-kaliningrad-i.cian.ru/",
      "display_name": "ЖК «Александрия»"
    },
    "railways": [],
    "districts": [
      {
        "parent_id": null,
        "id": 275,
        "name": "Ленинградский",
        "qs": "deal_type=sale&district%5B0%5D=275&engine_version=2&offer_type=flat",
        "full_name": "р-н Ленинградский",
        "title": "р-н Ленинградский",
        "geo_type": "district",
        "type": "raion",
        "location_id": 4778
      }
    ],
    "building_address": null,
    "country_id": 138,
    "user_input": "Россия, Калининград, улица Юрия Гагарина, 16В",
    "highways": [],
    "sorted_geo_ids": [
      {
        "type": "district",
        "id": 275
      }
    ]
  },
  "specialty": {
    "additional_types": [],
    "types": [],
    "specialties": []
  },
  "is_apartments": false,
  "bargain_terms": {
    "price_for_workplace": null,
    "tags": [],
    "price_rur": 7500000,
    "mortgage_allowed": true,
    "currency": "rur",
    "sale_type": "free",
    "lease_type": null,
    "deposit": null,
    "price": 7500000,
    "agent_bonus": null,
    "vat_type": null,
    "vat_price": null,
    "lease_term_type": null,
    "client_fee": null,
    "utilities_terms": null,
    "price_type": "all",
    "agent_fee": null,
    "bargain_allowed": null,
    "payment_period": null
  },
  "moderation_info": {
    "show_contact_warning_message": false,
    "warning_message": null,
    "photo_stub": null
  },
  "is_cian_partner": false,
  "from_developer": false,
  "show_warning_message": false,
  "formatted_short_info": "1-комн.кв.  ·  2/9 этаж",
  "cian_user_id": 47108007,
  "is_excluded_from_action": false,
  "is_duplicated_description": false,
  "is_favorite": false,
  "notes": {
    "offer": null,
    "realtor": null
  },
  "user": {
    "cian_user_id": "47108007",
    "is_agent": true,
    "is_builder": false,
    "is_callback_user": false,
    "is_cian_partner": false,
    "is_hidden": false,
    "is_passport_verified": false,
    "is_sub_agent": false,
    "user_id": 47108007,
    "user_trust_level": "involved",
    "account_type": "agency",
    "agency_name": "39 МЕТРОВ",
    "agent_avatar_url": "https://www.cian.ru/api/get-avatar/?i=24592109&t=2&p=2&timestamp=1749558117",
    "agent_moderation_info": {
      "is_user_identified": true,
      "is_user_identified_by_documents": true,
      "quality_level_info": {
        "has_verified_documents": true,
        "high_responsibility": true,
        "is_blocked": false,
        "is_super_agent": true,
        "is_super_host": false,
        "level_name": "Суперагент",
        "level_order": 4,
        "level_system_name": "max",
        "show_high_responsibility": true,
        "show_super_agent": true,
        "show_super_host": false
      },
      "show_user_identified_by_documents": false
    },
    "billing_info": {
      "account_type": 0,
      "packages": [
        {
          "country_id": 138,
          "deposit_required": false,
          "geo_name": "Калининградская область",
          "location_id": 4574,
          "package_type_id": 2,
          "package_type_name": "Базовый"
        }
      ],
      "remove_competitor": false,
      "replenish_disabled": false
    },
    "can_show_online": false,
    "cian_profile_status": "approved",
    "company_name": "39 МЕТРОВ",
    "experience": "2000",
    "is_chats_enabled": true,
    "is_self_employed": false,
    "phone_numbers": [
      {
        "country_code": "+7",
        "number": "9097890139"
      },
      {
        "country_code": "+7",
        "number": "9632939111"
      }
    ],
    "profile_uri": "company/47108007/",
    "user_type": "realtor_based",
    "personal_rating": null,
    "agent_availability": {
      "available": true,
      "available_from": null,
      "available_to": null,
      "message": null,
      "title": null,
      "user_id": 47108007,
      "vacation_to": null
    },
    "agent_lists": []
  },
  "is_pro": true,
  "ga_label": "/sale/flat/mo_id=0/obl_id=4574/city_id=4778/object_type=1/ga_obj_type=1/spec=company/329223230/from_developer=0/repres=0/owner=0/pod_snos=0/nv=0/",
  "adfox_params": {
    "puid1": "deal_type_sale",
    "puid2": "offer_flat",
    "puid3": "sale_type_second",
    "puid4": "offer_type_1",
    "puid5": "obl_id_4574",
    "puid6": "7001_10000",
    "puid8": 7500000,
    "puid10": "no_agent",
    "puid16": "false",
    "puid17": "false",
    "puid18": 29969,
    "puid19": "not_video",
    "puid36": 4778,
    "puid41": "business"
  },
  "chat_id": null,
  "chat": {
    "chat_id": null,
    "can_send_message": true
  },
  "is_unique": false,
  "saved_search_labels": [],
  "is_deal_request_substitution_phone": false,
  "context_token": "4.wilXvGl_VIE.Mx8e87-Vea02Ze5JaI4yY2DZzGCY1L8y8xPF3wFU-pG7gxal-ugktw3XwQ3nKqJeUlABRsyDq2EqcA",
  "show_gallery_thumbnails": false,
  "is_newbuilding_tour_available": false,
  "is_external_tour_available": false,
  "comparison_status": {
    "status": "available",
    "description": "Добавить к сравнению"
  },
  "photo_feature_icons": [
    {
      "type": "hasVideo",
      "text": "Объявление с видео",
      "link": "https://kaliningrad.cian.ru/sale/flat/329223230/?context=4.wilXvGl_VIE.Mx8e87-Vea02Ze5JaI4yY2DZzGCY1L8y8xPF3wFU-pG7gxal-ugktw3XwQ3nKqJeUlABRsyDq2EqcA"
    }
  ],
  "factoids": [
    {
      "type": "houseFinishDate",
      "title": "Сдача корпуса",
      "text": "Сдан"
    },
    {
      "type": "house",
      "title": "Корпус",
      "text": "Дом №3-№4"
    },
    {
      "type": "livingArea",
      "title": "Жилая пл.",
      "text": "14.1 м2"
    }
  ],
  "branding_level": "secondLevel",
  "is_rosreestr_checked": false,
  "newbuilding_dynamic_calltracking": {
    "site_block_id": null,
    "newbuilding_id": null
  },
  "offer_feature_labels": [],
  "is_new_label": false,
  "from_url": "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=2"
}
```

Each scraped property returns a comprehensive record with 97 fields organized into logical categories:

#### Core Property Information

| Field | Meaning |
|---|---|
| `CIAN ID` | Unique CIAN property identifier |
| `ID` | Internal system ID |
| `Title` | Property listing title |
| `Full URL` | Direct link to the listing on CIAN.ru |
| `JK URL` | New building complex URL (if applicable) |
| `Category` | Property category (flat, house, land, etc.) |
| `Offer Type` | Type of offer (apartment, townhouse, cottage) |
| `Deal Type` | Transaction type (sale, rent, pre-sale) |
| `Status` | Current listing status (active, expired, archived) |

#### Physical Specifications

| Field | Meaning |
|---|---|
| `Rooms Count` | Number of rooms in the property |
| `Bedrooms Count` | Dedicated bedroom count |
| `Kitchen Area` | Kitchen size in square meters |
| `Living Area` | Livable space excluding kitchen (sq m) |
| `Total Area` | Full property area (sq m) |
| `Min Area` | Minimum area if multiple units |
| `Floor Number` | Floor the property is located on |
| `Balconies Count` | Number of balconies/loggias |
| `Layout` | Room layout description |
| `Flat Type` | Flat category (studio, 1-room, 2-room, etc.) |
| `Decoration` | Interior condition (bare, semi-finished, renovated) |

#### Pricing & Financial

| Field | Meaning |
|---|---|
| `Formatted Full Price` | Full property price (human-readable format) |
| `Formatted Short Price` | Abbreviated price (millions/thousands notation) |
| `Formatted Additional Info` | Extra pricing details (per sq m, mortgage info) |
| `Bargain Terms` | Negotiation or special conditions |
| `Village Mortgage Allowed` | Whether mortgage is available for this property |

#### Location & Building

| Field | Meaning |
|---|---|
| `Geo` | Geographic coordinates and address metadata |
| `Displayed Location` | Human-readable location shown to buyers |
| `Is Need Hide Exact Address` | Flag: seller requests address anonymization |
| `Building` | Building metadata (year built, type, materials) |
| `Newbuilding` | New building complex info (if applicable) |
| `From Developer` | Property sold directly by developer |
| `Is Booked From Developer` | Reserved through developer pre-sale |

#### Listing Status & Features

| Field | Meaning |
|---|---|
| `Is New` | Whether property is newly listed |
| `Is New Label` | Display new label on marketplace |
| `Is Premium` | Property has premium placement |
| `Is Top3` | Featured in top 3 results |
| `Is Standard` | Standard (non-premium) listing |
| `Is Colorized` | Enhanced listing with extra visibility |
| `Is Favorite` | Marked as favorite by current user |
| `Is Auction` | Property listed in auction format |
| `Auction` | Auction-specific details |
| `Is Unique` | Unique property marker |

#### Seller & Contact Information

| Field | Meaning |
|---|---|
| `User ID` | Seller or agent account ID |
| `Published User ID` | Public user identifier |
| `CIAN User ID` | CIAN-specific user identifier |
| `User` | Seller/agent profile information |
| `Phones` | Contact phone numbers |
| `Is Pro` | Whether seller is professional agent/agency |
| `Is By Commercial Owner` | Listed by corporate/commercial entity |
| `Is CIAN Partner` | Official CIAN partner verification |
| `Chat ID` | Internal chat identifier for inquiries |
| `Chat` | Chat system details |

#### Media & Visual Content

| Field | Meaning |
|---|---|
| `Photos` | Array of property photos with URLs |
| `Videos` | Video tour links and metadata |
| `Show Gallery Thumbnails` | Display thumbnail gallery toggle |
| `Photo Feature Icons` | Special icons for key features in photos |
| `Is External Tour Available` | Virtual or external tour available |
| `Is Newbuilding Tour Available` | New building 3D/virtual tour available |

#### Dates & Timestamps

| Field | Meaning |
|---|---|
| `Added` | Human-readable listing date |
| `Added Timestamp` | Unix timestamp of listing creation |
| `Creation Date` | Formal creation date |
| `Humanized Timedelta` | Relative time (e.g., "2 days ago") |
| `Work Time Info` | Seller availability/working hours |

#### Advanced Fields & Flags

| Field | Meaning |
|---|---|
| `Is Imported` | Data imported from external source |
| `Is Duplicated Description` | Duplicate listing detection flag |
| `Is Recidivist` | Repeat seller/problematic account flag |
| `Is In Hidden Base` | Property in hidden/restricted listings |
| `Is Excluded From Action` | Excluded from promotions/actions |
| `Is Calltracking Enabled` | Call tracking active for analytics |
| `Is Rent By Parts` | Room rental (not whole property) |
| `Access Type` | Property access (private, shared entrance) |
| `Office Type` | Type of office (if commercial) |
| `Rosreestr Check` | Government registry validation status |
| `Is Rosreestr Checked` | Registry check performed |
| `Demolished In Moscow Programm` | Included in Moscow demolition program |
| `Builders IDs` | Developer/builder identifiers |
| `Basic Profi Score` | Quality/reliability score |
| `GA Label` | Google Analytics custom label |
| `Adfox Params` | Ad tracking parameters |
| `Context Token` | Session/context authentication token |
| `Branding Level` | Seller branding tier |
| `Offer Feature Labels` | Special feature tags/badges |
| `Saved Search Labels` | User-saved search categories |
| `Specialty` | Property specialty/niche category |
| `Notes` | Internal seller notes |
| `Show Warning Message` | Warning flag display toggle |
| `Moderation Info` | Content moderation details |
| `Is Apartments` | Residential apartment classification |
| `Comparison Status` | Status in property comparison tools |
| `Is Deal Request Substitution Phone` | Phone number substitution for requests |
| `Offer In Deal` | Number of offers if listed for sale |
| `Rooms For Sale Count` | Individual rooms available for sale |
| `Similar` | Similar property recommendations |
| `Factoids` | Quick fact summaries about the property |
| `Categories IDs` | Internal category classification IDs |
| `Formatted Short Info` | Abbreviated property info summary |
| `Formatted Full Info` | Complete formatted property summary |

***

### How to Use

1. **Build search URLs** — Navigate to CIAN.ru, apply filters (location, price, property type, rooms), and copy the result page URL.
2. **Prepare configuration** — Paste URLs into the `urls` array. Set `max_items_per_url` (recommended: 100–200 for balance between data volume and speed).
3. **Run the scraper** — Execute with `ignore_url_failures: true` to handle occasional page timeouts without interruption.
4. **Monitor progress** — Track the run log to confirm successful property extraction.
5. **Export results** — Download as JSON, CSV, or Excel for analysis, database import, or further processing.

**Best Practices:**

- Use `max_items_per_url: 200` for comprehensive data collection per search.
- Test with 1–2 URLs first before running bulk extractions.
- Vary region IDs and filters to cover geographic areas of interest.
- Set `ignore_url_failures: true` for production runs spanning 10+ URLs.

***

### Use Cases & Business Value

- **Property aggregators** syncing CIAN listings into multi-market comparison platforms
- **Real estate analytics** analyzing price trends, supply density, and market heat by district
- **Investment research** identifying undervalued properties or emerging neighborhoods
- **CRM automation** auto-populating lead databases with fresh property data
- **Competitive intelligence** monitoring competitor agent portfolios and pricing strategies
- **Academic research** studying Russian housing markets and urban development patterns

The CIAN Property Scraper eliminates the tedious work of manual listing collection, delivering clean, standardized records ready for database storage, analytics dashboards, or business intelligence workflows.

***

### Conclusion

The **CIAN.ru Property Scraper** is an essential tool for anyone working with Russian real estate data at scale. With 97 richly detailed fields per property and flexible filtering options, it transforms unstructured marketplace listings into actionable intelligence. Whether you're aggregating properties, analyzing market trends, or automating lead generation, this scraper accelerates your workflow and unlocks data-driven insights that manual browsing cannot match.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=1&region=1"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=1&region=1"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/cian-property-search-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=1&region=1"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/cian-property-search-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/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=1&region=1"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/cian-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/cian-property-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Cian Property Search Scraper",
        "description": "Scrape residential and commercial properties from CIAN.ru, Russia's largest real estate marketplace. Collect 97+ data fields including prices, locations, specifications, photos, and seller details — perfect for property aggregators, market analysis, and investment research.",
        "version": "0.0",
        "x-build-id": "ay0iHyqZ6IyfDI2mW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~cian-property-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-cian-property-search-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/stealth_mode~cian-property-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-cian-property-search-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/stealth_mode~cian-property-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-cian-property-search-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": {
                    "urls": {
                        "title": "URLs of the property list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
