# Cian Real Estate Scraper | Парсер Циан (`zen-studio/cian-scraper`) Actor

Scrape Cian.ru searches past the 1,500-result limit: flats, rooms, houses, land, new builds and commercial, for sale and rent. Phones, prices, photos, views, house data, seller profiles and the building's listing history. Парсер Циан: объявления, телефоны, история дома.

- **URL**: https://apify.com/zen-studio/cian-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 10 total users, 1 monthly users, 84.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.29 / 1,000 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

#### Copy to your AI assistant

```
Help me use zen-studio/cian-scraper on Apify. Documentation, input schema, pricing and limits: https://apify.com/zen-studio/cian-scraper.md (if you cannot open it, ask me to paste the relevant sections). Choose the settings for the result I ask for. maxItems defaults to 100: set it to 0 to collect a whole search, which can be tens of thousands of listings in a big city. Details, phones, house data and building history are on by default and included in the listing price; similar listings need includeSimilar. Full price history (priceHistory) is filled for Moscow listings; elsewhere priceChanged carries the trend Cian publishes. To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

### Что выгружает парсер Циан · What you get from Cian

Each saved listing is one row with everything Cian shows for it, in readable form:

- **Price · Цена**: price in the listing currency and in roubles, price per m², payment period for rentals, deposit, commission, utilities, mortgage and sale terms; the price trend Cian publishes, and the full price history for listings in Moscow.
- **Contacts · Контакты**: seller phone numbers as Cian shows them, the seller type (owner, agent, agency, developer), agency name, verification, time on Cian, number of listings, rating, reviews, chat response rate and profile link.
- **Property · Объект**: rooms, total, living and kitchen area, floor and floors, ceiling height, renovation, window view, WC and balcony counts, furniture and appliances, layout, photos and floor plans, video and 3D tour flags, description.
- **Location · Адрес**: full address, region, city, okrug, district, street, house, coordinates, every nearby metro station with line and minutes on foot or by transport, highways and railways.
- **Building · Дом**: year, wall material, series, entrances, flats, lifts, gas, heating, floors type, capital repair fund, emergency status, cadastral number; new-build completion quarter, residential complex and developer details.
- **Market signals · Спрос и история**: total views, views today and per day for the last 10 days, and every current and past listing in the same building with price, price per m², days on market and status.
- **Optional · По желанию**: up to 10 similar listings per row.

Every coded value comes with a readable label next to it, for example `saleType: "fz214"` with `saleTypeLabel: "Shared construction (214-FZ)"`.

### Как выгрузить объявления Циан · How to scrape Cian listings

#### By place · По городу, району, метро или ЖК

```json
{
  "location": "метро Тверская",
  "dealType": "rent",
  "rentPeriod": "long",
  "propertyType": "flat",
  "rooms": ["1", "2"],
  "maxPrice": 120000,
  "maxItems": 200
}
```

`location` takes a city or region (`Казань`, `Московская область`, `Татарстан`), a district (`Хамовники`), a metro station (`метро Тверская`) or a residential complex (`ЖК Петровский парк II`). Leave it empty to search Moscow.

#### By Cian link · По ссылке с Циан

Open Cian, set any filters you like, copy the address bar and paste it:

```json
{
  "startUrls": [
    { "url": "https://www.cian.ru/cat.php?deal_type=rent&engine_version=2&offer_type=flat&region=4593&room2=1&type=4" }
  ],
  "maxItems": 0
}
```

A search link keeps every filter Cian has, including ones not in this form. Listing links, residential complex pages and agent, agency or developer pages work too. That search link returned 3,225 of the 3,231 listings Cian counted.

#### By listing number, radius or map shape · По номеру, радиусу или области

```json
{
  "offerIds": ["334564288", "331907301"],
  "latitude": 55.7539,
  "longitude": 37.6208,
  "radiusKm": 1,
  "polygon": ["55.74,37.60", "55.74,37.64", "55.76,37.64", "55.76,37.60"],
  "maxItems": 300
}
```

Every input in one run is collected together and they share one `maxItems`, taking turns so each input contributes.

#### Input options · Параметры

| Parameter | Default | Meaning |
|---|---|---|
| `location` | Moscow | City, region, district, metro station or residential complex |
| `dealType` | `sale` | `sale` or `rent` |
| `propertyType` | `flat` | `flat`, `room`, `flatShare`, `bed`, `house`, `housePart`, `townhouse`, `land`, `anySuburban`, `office`, `retail`, `warehouse`, `freePurpose`, `catering`, `garage`, `production`, `carService`, `business`, `building`, `consumerServices`, `anyCommercial` |
| `maxItems` | 100 | Listings to save across all inputs; `0` saves everything |
| `startUrls` | | Cian search, listing, complex, agent, agency or developer links |
| `offerIds` | | Cian listing numbers |
| `latitude`, `longitude`, `radiusKm` | radius 2 km | Radius search; every listing returned lies within it |
| `polygon` | | Map shape as `latitude,longitude` points |
| `rentPeriod` | `long` | `long` or `daily` for flats and suburban rentals |
| `buildingStatus` | `any` | `new` or `secondary` (flats) |
| `rooms` | | `studio`, `1` to `5`, `6+`, `freeLayout` |
| `minPrice`, `maxPrice` | | Roubles (per month for rent, per day for daily rent) |
| `minArea`, `maxArea`, `minKitchenArea`, `minLivingArea` | | Square metres |
| `minFloor`, `maxFloor`, `notFirstFloor`, `notLastFloor` | | Floor of the listing |
| `minFloors`, `maxFloors` | | Floors in the building |
| `minBuildYear`, `maxBuildYear`, `minCeilingHeight` | | Building |
| `repair`, `houseMaterial` | | Renovation and wall material |
| `ownerOnly`, `fromDeveloperOnly`, `withPhotoOnly` | off | Seller and photo filters |
| `publishedWithin` | `any` | `today`, `hour`, `day`, `week`, `tenDays`, `month` |
| `sort` | Cian default | Price, price per m², area, newest, oldest, walking time to metro, street, seller, distance from MKAD |
| `includeDetails` | on | Views, house data, seller and developer profiles, feature table, price history (Moscow) |
| `includeHouseHistory` | on | Current and past listings in the same building |
| `includeSimilar` | off | Up to 10 similar listings per row |

Every filter is off by default, so a search returns everything Cian has for the place.

### Пример результата · Output example

A real listing saved by the actor (Kazan). Long arrays are shortened to their first entries; the shape and every key are kept. Phone numbers and emails are masked here; the actor returns them in full. [Download the complete row as JSON](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/cian-scraper-readme-sample-row-masked-v1-fde9e6296134.json).

```json
{
  "id": 333168629,
  "url": "https://kazan.cian.ru/sale/flat/333168629/",
  "mainImage": {
    "full": "https://images.cdn-cian.ru/images/300•••••82-1.jpg",
    "small": "https://images.cdn-cian.ru/images/300•••••82-2.jpg",
    "id": 3002168082,
    "isLayout": null
  },
  "headline": "1-комн.кв.  ·  30,5 м²  ·  4/5 этаж",
  "formattedFullPrice": "5 100 000 ₽",
  "price": 5100000,
  "currency": "RUB",
  "priceRub": 5100000,
  "pricePerSqm": 167213,
  "priceChanged": "reduced",
  "priceHistory": null,
  "priceChangeCount": null,
  "address": "Республика Татарстан, Казань, р-н Советский, Агрызская улица, 78",
  "region": "Республика Татарстан",
  "city": "Казань",
  "okrug": null,
  "district": "Советский",
  "street": "Агрызская улица",
  "houseNumber": "78",
  "regionId": 4618,
  "latitude": 55.834694,
  "longitude": 49.202588,
  "nearestMetro": "Суконная слобода",
  "nearestMetroMinutes": 13,
  "nearestMetroTravelType": "transport",
  "nearestMetroLineColor": "#CF0000",
  "metro": [
    {
      "name": "Суконная слобода",
      "id": 319,
      "lineId": 23,
      "lineColor": "#CF0000",
      "lineType": null,
      "minutes": 13,
      "travelType": "transport",
      "travelTypeLabel": "By transport",
      "isNearest": true,
      "underConstruction": false,
      "releaseYear": null
    },
    {
      "name": "Яшьлек",
      "id": 315,
      "lineId": 23,
      "lineColor": "#CF0000",
      "lineType": null,
      "minutes": 14,
      "travelType": "transport",
      "travelTypeLabel": "By transport",
      "isNearest": false,
      "underConstruction": false,
      "releaseYear": null
    }
  ],
  "rooms": 1,
  "isStudio": false,
  "totalArea": 30.5,
  "livingArea": 12,
  "kitchenArea": 11,
  "roomArea": null,
  "landArea": null,
  "landAreaUnit": null,
  "floorNumber": 4,
  "floorsCount": 5,
  "ceilingHeight": 2.7,
  "buildYear": 1978,
  "materialType": "brick",
  "materialTypeLabel": "Brick",
  "parkingTypeLabel": "Open",
  "repairTypeLabel": "Cosmetic",
  "windowsViewTypeLabel": "Yard",
  "categoryLabel": "Flat for sale",
  "category": "flatSale",
  "dealTypeLabel": "Sale",
  "offerTypeLabel": "Residential",
  "flatTypeLabel": "Rooms",
  "decorationLabel": null,
  "buildingStatusLabel": "Resale",
  "isNewBuilding": false,
  "buildingDeadline": null,
  "jkName": null,
  "jkId": null,
  "jkUrl": null,
  "developerName": null,
  "saleTypeLabel": "Free sale",
  "mortgageAllowed": true,
  "phones": [
    "+7939•••••02"
  ],
  "seller": {
    "id": 137369250,
    "type": "agent",
    "typeLabel": "Agent",
    "name": "Марина Рязанова",
    "companyName": "Риэлт Групп",
    "agencyName": "Марина Рязанова",
    "accountType": "specialist",
    "accountTypeLabel": "Private realtor",
    "userType": "realtor_based",
    "userTypeLabel": "Realtor (agency)",
    "isAgent": true,
    "isBuilder": false,
    "isHomeowner": false,
    "isPro": true,
    "isCianPartner": false,
    "isPassportVerified": false,
    "isIdentified": false,
    "isIdentifiedByDocuments": true,
    "isSelfEmployed": false,
    "trustLevel": "notInvolved",
    "trustLevelLabel": "Not verified",
    "profileStatus": "hide",
    "avatarUrl": null,
    "profileUrl": null,
    "phones": [
      "+7939•••••10",
      "+7962•••••77"
    ],
    "isAvailable": true,
    "availability": {
      "available": true,
      "availableFrom": null,
      "availableTo": null,
      "message": null,
      "title": null,
      "userId": 137369250,
      "vacationTo": null
    },
    "moderationInfo": {
      "isUserIdentified": false,
      "isUserIdentifiedByDocuments": true,
      "qualityLevelInfo": {
        "hasVerifiedDocuments": false,
        "highResponsibility": true,
        "isBlocked": false,
        "isSuperAgent": false,
        "isSuperHost": false,
        "levelName": "Высокий уровень",
        "levelOrder": 3,
        "levelSystemName": "high",
        "showHighResponsibility": true,
        "showSuperAgent": false,
        "showSuperHost": false
      },
      "showUserIdentifiedByDocuments": true
    },
    "qualityLevel": null,
    "personalRating": null,
    "offersCount": 2,
    "onCianSince": null,
    "onCianFor": "11 месяцев",
    "experience": null,
    "description": null,
    "website": null,
    "email": "•••@gmail.com",
    "regions": [],
    "socialProfiles": [],
    "reviewsCount": 0,
    "responseRate": 1.0,
    "averageResponseTime": 82800,
    "profile": {
      "age": "11 месяцев",
      "hasFairplay": false,
      "isChatsEnabled": true,
      "realtyUserId": 137369250,
      "status": "published",
      "userStatus": "active",
      "hasRgrParticipation": false,
      "hasKokonParticipation": false,
      "companyName": "Риэлт Групп",
      "contactEmail": "•••@gmail.com",
      "isDeveloper": false,
      "moderationInfo": {
        "isUserIdentified": false,
        "isUserIdentifiedByDocuments": false,
        "qualityLevelInfo": {
          "showSuperAgent": false,
          "levelName": "Высокий уровень",
          "levelOrder": 3,
          "levelSystemName": "high"
        }
      },
      "name": "Марина Рязанова",
      "regionsNames": [],
      "skills": [],
      "socialProfiles": [],
      "chatStatistics": {
        "agentId": 137369250,
        "averageResponseTime": 82800,
        "responseRate": 1.0
      },
      "reviewsCount": 0,
      "reviews": [],
      "contentRating": null,
      "blogPostsCount": 0,
      "questionsCount": 0,
      "commentsCount": 0,
      "activeListingsCount": 2,
      "canDoOnlineDeal": false,
      "vacanciesCount": 0
    },
    "metrics": null,
    "skills": [],
    "isPrivateBroker": null,
    "isSubAgent": true,
    "status": null,
    "offersUrl": null
  },
  "viewsTotal": 2287,
  "viewsToday": 11,
  "dailyViews": [
    {
      "date": "2026-10-29",
      "views": 28
    },
    {
      "date": "2026-10-30",
      "views": 41
    }
  ],
  "house": {
    "id": 276558,
    "houseGasSupplyType": "central",
    "houseGasSupplyTypeText": "Центральное",
    "houseHeatSupplyType": "central",
    "houseOverhaulFundType": "regionalOp",
    "houseMaterialType": "brick",
    "houseMaterialTypeText": "Кирпичный",
    "houseOverlapType": "concrete",
    "houseOverlapTypeText": "Железобетонные",
    "demolishedInMoscowProgramm": false,
    "fiasHouseId": "faa54678-57fb-4f26-a838-88263f5f4644",
    "yearRelease": 1978,
    "floorMax": 5,
    "entrances": 2,
    "flatCount": 135,
    "isEmergency": false,
    "lifts": 0,
    "hasPlayground": false,
    "hasSportsground": false,
    "ceilingHeight": 2.7,
    "chuteCount": 0,
    "isCulturalHeritage": false,
    "houseMaterialTypeLabel": "Brick",
    "houseGasSupplyTypeLabel": "Central",
    "houseHeatSupplyTypeLabel": "Central",
    "houseOverlapTypeLabel": "Reinforced concrete",
    "houseOverhaulFundTypeLabel": "Regional operator"
  },
  "houseHistory": {
    "totalCount": 53,
    "statusCounts": [
      {
        "status": "deactivated",
        "offersCount": 53
      }
    ],
    "roomCounts": [
      {
        "offersCount": 31,
        "roomsCount": "studio"
      },
      {
        "offersCount": 11,
        "roomsCount": "one"
      }
    ],
    "listings": [
      {
        "id": 335493319,
        "url": null,
        "title": "30 м², 1-комн., 4/5 этаж",
        "price": "4,8 млн ₽",
        "pricePerSqm": "161 666 ₽/м²",
        "priceTrend": "noChange",
        "exposition": "4 дня",
        "exposureDays": 4,
        "status": "deactivated",
        "statusLabel": "Removed",
        "dateStart": "31 окт 2026",
        "dateEnd": "3 ноя 2026",
        "previewPhoto": "https://images.cdn-cian.ru/images/kvartira-kazan-agryzskaya-ulica-300•••••57-2.jpg?dh=-495506347"
      },
      {
        "id": 333949533,
        "url": null,
        "title": "18,2 м², студия, 1/5 этаж",
        "price": "3,6 млн ₽",
        "pricePerSqm": "197 802 ₽/м²",
        "priceTrend": "decrease",
        "exposition": "43 дня",
        "exposureDays": 43,
        "status": "deactivated",
        "statusLabel": "Removed",
        "dateStart": "15 сен 2026",
        "dateEnd": "31 окт 2026",
        "previewPhoto": "https://images.cdn-cian.ru/images/298•••••75-2.jpg?dh=107•••••43"
      }
    ]
  },
  "developer": null,
  "complex": null,
  "specifications": [
    {
      "group": null,
      "label": "Тип дома",
      "value": "Кирпичный"
    },
    {
      "group": null,
      "label": "Год постройки",
      "value": "1978"
    }
  ],
  "listingSummary": {
    "images": [
      "https://images.cdn-cian.ru/images/300•••••82-1.jpg?dh=-152•••••54",
      "https://images.cdn-cian.ru/images/300•••••84-1.jpg?dh=457956723"
    ],
    "title": "30,5 м² · 1-комн. · 4/5 этаж",
    "prices": {
      "price": "5,1 млн ₽",
      "priceDiff": "decrease",
      "priceSqm": "167 213 ₽/м²"
    },
    "status": "published",
    "address": "Татарстан, Казань, Агрызская улица, 78",
    "link": "/sale/flat/333168629/",
    "features": [
      {
        "title": "Тип дома",
        "value": "Кирпичный"
      },
      {
        "title": "Год постройки",
        "value": "1978"
      }
    ]
  },
  "multiOffer": null,
  "services": [
    "premium"
  ],
  "promoName": null,
  "imageUrls": [
    "https://images.cdn-cian.ru/images/300•••••82-1.jpg",
    "https://images.cdn-cian.ru/images/300•••••84-1.jpg"
  ],
  "layoutImageUrls": [],
  "photoCount": 8,
  "hasVideos": false,
  "hasTour": false,
  "description": "Уютная 1-комнатная квартира с новым ремонтом — заезжай и живи!\nПродаётся светлая и полностью готовая к проживанию 1-комнатная квартира площадью 30 м² в Советском районе.\n\n\n Главное преимущество — свежий ремонт:В квартире выполнен качественный ремонт, после которого никто не проживал. Всё новое, чистое и аккуратное — вам не придётся тратить время и деньги на переделки.\n\n\n О доме:Надёжный кирпичный дом 1978 года постройки — отличная тепло- и шумоизоляция, проверенная временем.\n Локация — идеально для жизни:\n* Магазины в шаговой доступности\n* Остановка общественного транспорта рядом\n* Парк для прогулок и отдыха\n* Школа и детский сад — прямо через дорогу\nОтличный вариант как для собственного проживания, так и для сдачи в аренду.\n Юридически чисто:\n* Один взрослый собственник\n* Без обременений\n* Быстрый выход на сделку\n\n\n Показ в любое удобное время — звоните или пишите, договоримся!\n Отличное соотношение цены и качества — не упустите шанс купить готовую квартиру без лишних вложений!\n\nУважаемый Покупатель , с этой квартиры от нашей компании Вы получаете :\n\n1 . Профессиональное юридическое сопровождение сделки !\n\n2 . Подготовка полного пакета документов с обеих сторон  Экономьте свое время !\n\n3 . Профессиональную помощь в оформлении ипотеки со сниженной ставкой от банков  партнеров , одобрение 95% заявок.\n\n4 . Профессиональную помощь в оформлении ипотеки иностранным гражданам !\n\n5 . На данный объект предоставляется максимальная скидка для покупателей по ипотеке Сбербанк от -0.2 до -1.5 % .\n\n6 . Мы являемся официальными партнерами более 20 банков .\n\n- 49% сэкономим на услугах банков и страховых компаний !!!\n\n7 . Показ объекта в любой день",
  "title": null,
  "publishedAt": "2026-11-07T01:29:40Z",
  "creationDate": "2026-08-21T14:28:04.573",
  "isByHomeowner": null,
  "detailsStatus": "ok",
  "cardStatus": "notServed",
  "searchInput": "Казань",
  "searchInputType": "search",
  "scrapedAt": "2026-11-07T11:26:18.854394Z",
  "geo": {
    "countryId": 138,
    "undergrounds": [
      {
        "name": "Суконная слобода",
        "lineId": 23,
        "underConstruction": false,
        "isDefault": true,
        "releaseYear": null,
        "id": 319,
        "time": 13,
        "lineColor": "CF0000",
        "qs": "deal_type=sale&engine_version=2&metro%5B0%5D=319&offer_type=flat",
        "transportType": "transport",
        "cianId": null,
        "lineType": null
      },
      {
        "name": "Яшьлек",
        "lineId": 23,
        "underConstruction": false,
        "isDefault": null,
        "releaseYear": null,
        "id": 315,
        "time": 14,
        "lineColor": "CF0000",
        "qs": "deal_type=sale&engine_version=2&metro%5B0%5D=315&offer_type=flat",
        "transportType": "transport",
        "cianId": null,
        "lineType": null
      }
    ],
    "highways": [],
    "districts": [
      {
        "geoType": "district",
        "name": "Советский",
        "fullName": "р-н Советский",
        "title": "р-н Советский",
        "type": "raion",
        "id": 264,
        "parentId": null,
        "qs": "deal_type=sale&district%5B0%5D=264&engine_version=2&offer_type=flat",
        "locationId": 4777
      }
    ],
    "coordinates": {
      "lat": 55.834694,
      "lng": 49.202588
    },
    "address": [
      {
        "name": "Татарстан",
        "fullName": "Республика Татарстан",
        "title": "Республика Татарстан",
        "type": "location",
        "id": 4618,
        "shortName": "Татарстан респ.",
        "qs": "deal_type=sale&engine_version=2&offer_type=flat&region=4618",
        "locationTypeId": 140,
        "geoType": "location",
        "isFormingAddress": true
      },
      {
        "name": "Казань",
        "fullName": "Казань",
        "title": "Казань",
        "type": "location",
        "id": 4777,
        "shortName": "Казань",
        "qs": "deal_type=sale&engine_version=2&offer_type=flat&region=4777",
        "locationTypeId": 1,
        "geoType": "location",
        "isFormingAddress": true
      }
    ],
    "buildingAddress": null,
    "userInput": "Россия, Татарстан республика, город Казань, улица Агрызская, дом 78",
    "railways": [],
    "jk": null,
    "sortedGeoIds": [
      {
        "type": "underground",
        "id": 319
      },
      {
        "type": "underground",
        "id": 315
      }
    ],
    "locationPath": {
      "countryId": 138,
      "childToParent": [
        4777,
        4618
      ]
    }
  },
  "bargainTerms": {
    "agentFee": null,
    "leaseType": null,
    "agentBonus": null,
    "tags": [],
    "paymentPeriod": null,
    "tax": null,
    "vatPrice": null,
    "utilitiesTerms": null,
    "clientFee": null,
    "deposit": null,
    "priceType": "all",
    "mortgageAllowed": true,
    "vatType": null,
    "priceForWorkplace": null,
    "price": 5100000,
    "bargainAllowed": null,
    "currency": "rur",
    "priceRur": 5100000,
    "saleType": "free",
    "leaseTermType": null,
    "minLeaseTerm": null,
    "depositPrices": {
      "rur": null,
      "usd": null,
      "eur": null
    },
    "bargainConditions": null,
    "securityDeposit": null,
    "hasGracePeriod": null,
    "securityDepositPrices": {
      "rur": null,
      "usd": null,
      "eur": null
    },
    "tenantsType": null,
    "utilitiesTermsPrices": null,
    "contractType": null,
    "prepayMonths": null,
    "bargainPrice": null,
    "priceUsd": 62090,
    "vatIncluded": null,
    "bargainPricePrices": {
      "rur": null,
      "usd": null,
      "eur": null
    },
    "priceEur": 55319,
    "vatPrices": {
      "rur": null,
      "usd": null,
      "eur": null
    },
    "includedOptions": []
  },
  "building": {
    "materialType": "brick",
    "accessType": null,
    "deadline": null,
    "passengerLiftsCount": null,
    "parking": {
      "isFree": null,
      "purposeType": null,
      "locationType": null,
      "isAvailable": null,
      "type": "open",
      "currency": null,
      "placesCount": null,
      "priceEntry": null,
      "priceMonthly": null
    },
    "buildYear": 1978,
    "type": null,
    "floorsCount": 5,
    "cargoLiftsCount": null,
    "classType": null,
    "heatingType": null
  },
  "newbuilding": {
    "isFromDeveloper": null,
    "isFromBuilder": null,
    "isBuilderReliableInRegion": null,
    "showJkReliableFlag": null,
    "house": null,
    "isReliable": null,
    "isFromSeller": null,
    "isFromLeadFactory": null,
    "newbuildingFeatures": null,
    "isSalesLeader": null,
    "id": null,
    "name": null
  },
  "photos": [
    {
      "rotateDegree": null,
      "isLayout": null,
      "fullUrl": "https://images.cdn-cian.ru/images/300•••••82-1.jpg",
      "isDefault": false,
      "thumbnailUrl": "https://images.cdn-cian.ru/images/300•••••82-2.jpg",
      "id": 3002168082,
      "miniUrl": "https://images.cdn-cian.ru/images/300•••••82-3.jpg",
      "thumbnail2Url": "https://images.cdn-cian.ru/images/300•••••82-4.jpg"
    },
    {
      "rotateDegree": null,
      "isLayout": null,
      "fullUrl": "https://images.cdn-cian.ru/images/300•••••84-1.jpg",
      "isDefault": false,
      "thumbnailUrl": "https://images.cdn-cian.ru/images/300•••••84-2.jpg",
      "id": 3002168084,
      "miniUrl": "https://images.cdn-cian.ru/images/300•••••84-3.jpg",
      "thumbnail2Url": "https://images.cdn-cian.ru/images/300•••••84-4.jpg"
    }
  ],
  "user": {
    "cianUserId": "137369250",
    "isAgent": true,
    "isBuilder": false,
    "isCallbackUser": false,
    "isCianPartner": false,
    "isHidden": true,
    "isPassportVerified": false,
    "isSubAgent": true,
    "userId": 137369250,
    "userTrustLevel": "notInvolved",
    "accountType": "specialist",
    "agencyName": "Марина Рязанова",
    "agentModerationInfo": {
      "isUserIdentified": false,
      "isUserIdentifiedByDocuments": true,
      "qualityLevelInfo": {
        "hasVerifiedDocuments": false,
        "highResponsibility": true,
        "isBlocked": false,
        "isSuperAgent": false,
        "isSuperHost": false,
        "levelName": "Высокий уровень",
        "levelOrder": 3,
        "levelSystemName": "high",
        "showHighResponsibility": true,
        "showSuperAgent": false,
        "showSuperHost": false
      },
      "showUserIdentifiedByDocuments": true
    },
    "billingInfo": {
      "packages": [
        {
          "countryId": 138,
          "depositRequired": false,
          "geoName": "Татарстан",
          "locationId": 4618,
          "packageTypeId": 2,
          "packageTypeName": "Базовый"
        }
      ],
      "removeCompetitor": false,
      "replenishDisabled": false
    },
    "canShowOnline": false,
    "cianProfileStatus": "hide",
    "companyName": "Риэлт Групп",
    "isChatsEnabled": true,
    "isSelfEmployed": false,
    "masterAgent": {
      "absoluteAvatarUrl": "https://www.cian.ru/api/get-avatar/?i=5209635&t=2&p=2&timestamp=162•••••41",
      "absoluteMiniAvatarUrl": "https://www.cian.ru/api/get-avatar/?i=5209635&t=2&p=1&timestamp=162•••••41",
      "accountType": "agency",
      "avatarUrl": "/api/get-avatar/?i=5209635&t=2&p=2&timestamp=162•••••41",
      "id": 12899520,
      "isModerationPassed": true,
      "miniAvatarUrl": "/api/get-avatar/?i=5209635&t=2&p=1&timestamp=162•••••41",
      "name": "Риэлт Групп",
      "profileUri": "company/12899520/"
    },
    "phoneNumbers": [
      {
        "countryCode": "+7",
        "number": "939•••••10"
      },
      {
        "countryCode": "+7",
        "number": "962•••••77"
      }
    ],
    "subAgentCompanyName": "Риэлт Групп",
    "userType": "realtor_based",
    "personalRating": null,
    "agentAvailability": {
      "available": true,
      "availableFrom": null,
      "availableTo": null,
      "message": null,
      "title": null,
      "userId": 137369250,
      "vacationTo": null
    },
    "agentLists": []
  }
}
```

Export to JSON keeps the nested structure; CSV and Excel flatten it into columns. The dataset has four views: Overview, Contacts, Prices and history, Building and house.

### Большие поиски · Large searches

Cian shows at most 1,500 results for one search and groups identical listings (several agents selling the same flat, or identical flats in a new building) under one card. The actor splits large searches automatically and opens every group, so `maxItems: 0` collects the search as far as Cian lists it: 96% to 99.8% of the listings Cian counted in our test searches. With price, price per m², area, newest, oldest, walking time or street sorting, the order holds across the whole result; Cian's default order, seller and distance from MKAD come back in price order once a search is larger than 1,500.

### Стоимость · Pricing

Pay per listing saved. Details, phones, house data, views and the building's history are included.

| Event | When charged | Price |
|---|---|---|
| Listing | Each listing saved to the dataset | $2.99 per 1,000 (Bronze $2.79, Silver $2.49, Gold $2.29) |
| Actor start | Each run | $0.005 per run |

100 listings cost $0.30 on the free plan's rate, plus $0.005 for the run. Similar listings are included at no extra charge.

### Частые вопросы · FAQ

**Do I need a Cian account, login or API key? · Нужен ли аккаунт Циан?**
No. The actor reads public listings; nothing to sign up for.

**Are phone numbers included? · Есть ли телефоны?**
Yes, as Cian shows them on the listing, with no login. Some numbers are Cian's call-forwarding numbers that ring the seller; `isCalltrackingEnabled` marks those listings.

**Can I get more than 1,500 listings? · Больше 1 500 объявлений?**
Yes. Set `maxItems` to `0`. A search for every flat for sale in Kazan returned 15,714 listings.

**Is there a price history? · Есть ли история цен?**
For listings in Moscow, `priceHistory` lists every price change with its date. For other regions, `priceChanged` gives the trend Cian publishes (increased, reduced or none), and `houseHistory` shows the prices of past and current listings in the same building.

**Which cities and regions? · Какие города?**
All of Russia that Cian covers: Moscow, St Petersburg, Kazan, Novosibirsk, Yekaterinburg and every other city or region on Cian.

**How do I monitor new listings or price changes? · Как отслеживать новые объявления?**
Schedule the actor on Apify with `sort: "newest"` and `publishedWithin: "day"`, and compare runs by `id`.

**Why does a listing have `detailsStatus: "partial"`? · Почему детали неполные?**
One of the extra parts (for example the seller profile) could not be loaded at that moment. The listing is saved with everything else; nothing is guessed in its place.

**What about the market value of a flat? · Оценка стоимости квартиры?**
Use [Apartment Valuation](https://apify.com/zen-studio/russian-apartment-valuation-api-ppe) with the address and area from this actor's output.

**Can I scrape Avito, Domclick or Yandex Realty too?**
Yes: [Avito Real Estate](https://apify.com/zen-studio/avito-realty-scraper), [Domclick](https://apify.com/zen-studio/domclick-search-scraper) and [Yandex Realty](https://apify.com/zen-studio/yandex-realty-scraper).

### More Zen Studio scrapers for Russian markets

- [Avito Listings Scraper](https://apify.com/zen-studio/avito-listings-scraper)
- [Avito Real Estate Scraper](https://apify.com/zen-studio/avito-realty-scraper)
- [Domclick Scraper](https://apify.com/zen-studio/domclick-search-scraper)
- [Yandex Realty Scraper](https://apify.com/zen-studio/yandex-realty-scraper)
- [Russian Apartment Valuation](https://apify.com/zen-studio/russian-apartment-valuation-api-ppe)
- [Yandex Maps Scraper](https://apify.com/zen-studio/yandex-maps-scraper)
- [2GIS Places Scraper](https://apify.com/zen-studio/2gis-places-scraper-api)
- [Ozon Scraper PRO](https://apify.com/zen-studio/ozon-scraper-pro)

Full directory: [Zen Studio on Apify](https://apify.com/zen-studio)

### Поддержка · Support

- **Ошибки и предложения / Bugs and requests**: the Issues tab.

### Правовая информация · Legal

Собираются публично доступные объявления с Циан. Пользователь отвечает за соблюдение условий использования сайта и законодательства о защите персональных данных: 152-ФЗ, GDPR, CCPA.

Extracts publicly available listings from Cian.ru. Users are responsible for complying with Cian's terms and data protection law (152-FZ, GDPR, CCPA).

# Actor input Schema

## `location` (type: `string`):

A Russian city or region (<code>Казань</code>, <code>Московская область</code>), a district (<code>Хамовники</code>), a metro station (<code>метро Тверская</code>) or a residential complex (<code>ЖК Петровский парк II</code>). Leave empty to search Moscow, or use Start URLs, listing IDs or coordinates instead.

## `dealType` (type: `string`):

Buy or rent.

## `propertyType` (type: `string`):

What kind of property to search. Choose <b>Any suburban</b> or <b>Any commercial</b> to get every subtype at once.

## `maxItems` (type: `integer`):

How many listings to save in total across all inputs. <b>0</b> means everything available; large cities hold tens of thousands of listings.

## `startUrls` (type: `array`):

Paste any Cian link: a search with your filters already applied, a single listing, a residential complex page, or an agent, agency or developer page. A search link keeps every filter Cian supports, including ones not in this form. Several links run together.

## `offerIds` (type: `array`):

Cian listing numbers, for example <code>334564288</code>. Any property type works.

## `latitude` (type: `number`):

Centre of a radius search, for example <code>55.7539</code>. Use together with Longitude.

## `longitude` (type: `number`):

Centre of a radius search, for example <code>37.6208</code>. Use together with Latitude.

## `radiusKm` (type: `number`):

Search radius around the coordinates, up to 100 km. Every listing returned lies within it. Defaults to 2 km.

## `polygon` (type: `array`):

At least three points, one per line, as <code>latitude,longitude</code>. Only listings inside the shape are returned.

## `rentPeriod` (type: `string`):

For rentals: long-term or daily (посуточно). Ignored for sales.

## `buildingStatus` (type: `string`):

For flats only.

## `rooms` (type: `array`):

For flats. Pick one or more.

## `minPrice` (type: `integer`):

In roubles. For rentals, per month (per day for daily rent).

## `maxPrice` (type: `integer`):

In roubles.

## `minArea` (type: `number`):

Total area in square metres.

## `maxArea` (type: `number`):

Total area in square metres.

## `minKitchenArea` (type: `number`):

Kitchen area in square metres.

## `minLivingArea` (type: `number`):

Living area in square metres.

## `minFloor` (type: `integer`):

Lowest floor of the listing.

## `maxFloor` (type: `integer`):

Highest floor of the listing.

## `notFirstFloor` (type: `boolean`):

Skip ground-floor listings.

## `notLastFloor` (type: `boolean`):

Skip top-floor listings.

## `minFloors` (type: `integer`):

Floors in the building.

## `maxFloors` (type: `integer`):

Floors in the building.

## `minBuildYear` (type: `integer`):

Year the building was completed.

## `maxBuildYear` (type: `integer`):

Year the building was completed.

## `minCeilingHeight` (type: `number`):

For example <code>3</code>.

## `repair` (type: `array`):

Renovation state of the flat.

## `houseMaterial` (type: `array`):

Wall material of the building.

## `ownerOnly` (type: `boolean`):

Only listings published by the owner, no agents.

## `fromDeveloperOnly` (type: `boolean`):

Only listings published by the developer.

## `withPhotoOnly` (type: `boolean`):

Skip listings without photos.

## `publishedWithin` (type: `string`):

Only listings published or refreshed within this period.

## `sort` (type: `string`):

Order of results. Searches larger than 1,500 listings are collected in pieces and put back in the selected order for price, price per m², area, newest, oldest, walking time to metro and street. Cian's default order, seller and distance from MKAD then come in price order.

## `includeDetails` (type: `boolean`):

Adds price history, total and daily views, house data (year, entrances, flats, gas, heating, lifts, series), the full seller profile, developer and residential complex details and the feature table. Included in the listing price; turn off for faster runs.

## `includeHouseHistory` (type: `boolean`):

Adds every current and past listing Cian has for the same building: price, price per m², days on market, status (published or removed) and dates.

## `includeSimilar` (type: `boolean`):

Adds up to 10 comparable listings to each row, with price, address, photo and link.

## `feedback` (type: `string`):

For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers.

## Actor input object example

```json
{
  "location": "Москва",
  "dealType": "sale",
  "propertyType": "flat",
  "maxItems": 100,
  "rentPeriod": "long",
  "buildingStatus": "any",
  "publishedWithin": "any",
  "sort": "default",
  "includeDetails": true,
  "includeHouseHistory": true,
  "includeSimilar": false
}
```

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

// Prepare Actor input
const input = {
    "location": "Москва",
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/cian-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 = {
    "location": "Москва",
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/cian-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "location": "Москва",
  "maxItems": 100
}' |
apify call zen-studio/cian-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/cian-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TTLdj3pylSowaj1bL/builds/N0hhwBt9Vpg9eCGwQ/openapi.json
