Cian API & Scraper
Cian.ru is Russia's largest real-estate portal, and this API reads it region by region.
4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`search` takes a Cian region or city (an id such as 1 for Moscow, or a Russian name such as Казань), sale or rent (long-term or daily), the property type (flat, room, house, part of a house, land, townhouse or commercial with 11 commercial kinds) and filters for rooms, new-build or resale, price, total and kitchen area, floor, building year, owner-only or developer-only ads, one agency's ads, a metro station with walking minutes, a district or a new-build complex. Each row carries the price Cian prints, the price per m², rent terms (deposit, tenant commission, utilities), rooms, areas, floor, metro stations with minutes, address, coordinates, photos, the seller and the phone numbers on the ad. `listing` adds the full price history, view counter, feature table and rent terms. On 2026-10-14 Moscow alone had 96,155 flats for sale, 15,028 offices for rent and Saint Petersburg 60,183 daily rentals.
Reference
What a Cian field actually contains
Fields that read differently from how they look. Every row was measured against live Cian ads on 2026-10-14.
| Field | What it holds |
|---|---|
| price_rub vs price_raw | price_rub is the total in roubles exactly as the ad prints it. Cian also stores a raw value that can be a price per m², per year, or in US dollars; price_raw keeps that value with its unit, period and currency. On commercial ads the raw value was 36,000 roubles per m² per year while the ad printed 3,501,000 roubles a month. |
| price_min_rub / price_max_rub | Large commercial ads offer several units and print a range such as 79,580,788 - 272,980,610 roubles. price_rub is then null and both ends are returned: 8 of 28 office-rent rows and 7 of 28 warehouse rows. |
| Dollar-priced ads | Some country houses are priced in US dollars. Their search card prints no figure, so price_text is null and price_text_was_placeholder is true; price_rub is the rouble price Cian itself computes (4,193,374,999 roubles for a 50,000,000 dollar cottage, the ad page prints 4,193,375,000). |
| price_period | month for long-term rent, day for daily rent ('from 3,500 roubles per day'), null for sales. min_price and max_price use the same basis. |
| tenant_fee_pct, deposit_rub, utilities_included | Rent terms as separate fields: the commission the tenant pays in percent, the deposit in roubles, whether utilities are in the rent and whether meters are extra. listing adds prepay_months and Cian's own terms table. |
| seller vs developer | seller is whoever placed the ad: kind owner, agent or developer, the agency or agent name, the account id and the phone numbers on the ad. developer (listing only) is the company that built the residential complex; it appears on owner ads too and is not the seller. |
| price_history and previous_price_rub | Every price change Cian lists for the ad with its date. 5 of 16 sampled ads had changed price, for example 5,200,000 to 5,500,000 roubles. |
| total and last_page | total is Cian's own count. Cian serves at most 1,500 ads per query (page 54), so a larger result set says so in a warning; narrow by rooms, price or metro to reach the rest. |
Region, metro, district and complex ids come from the regions and geo_suggest endpoints, which read Cian's own lookups.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
Captured request
{
"method": "POST",
"url": "https://api.reefapi.com/cian/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"region": "1",
"deal": "sale",
"property_type": "flat",
"rooms": "2",
"sort": "newest"
}
}Captured response
{
"ok": true,
"meta": {
"api": "cian",
"endpoint": "search",
"mode": "live",
"latency_ms": 1111.4,
"record_count": 28,
"bytes": 639777,
"cache_hit": false,
"upstream_requests": 1,
"warnings": [
"31,825 matches but Cian serves at most 1,500 per query (page 54 is the last); narrow with filters to reach the rest"
],
"charged_credits": 3,
"version": "1.0.0",
"request_id": "d9247aca885e4a77",
"queue_ms": 2.2,
"fetched_at": "2026-10-14T18:57:19.474Z"
},
"data": {
"region": 1,
"total": 31825,
"page": 1,
"page_size": 28,
"last_page": 54,
"has_more": true,
"sort": "newest",
"filters_applied": {
"region": 1,
"deal": "sale",
"property_type": "flat",
"rooms": [
"2"
],
"sort": "newest",
"page": 1
},
"duplicates_dropped": 0,
"listings": [
{
"id": 334978888,
"url": "https://www.cian.ru/sale/flat/334978888/",
"category": "flatSale",
"deal_type": "sale",
"offer_type": "flat",
"title": null,
"summary": "2-комн.кв. · 52,3 м² · 11/12 этаж",
"price_rub": 23500000,
"price_text": "23 500 000 ₽",
"price_min_rub": null,
"price_max_rub": null,
"price_per_m2_rub": 449331,
"price_period": null,
"price_text_was_placeholder": false,
"price_raw": {
"value": 23500000,
"unit": "total",
"period": null,
"currency": "rur"
},
"currency": "RUB",
"sale_type": "free",
"mortgage_allowed": true,
"bargain_allowed": null,
"vat_type": null,
"vat_rub": null,
"deposit_rub": null,
"tenant_fee_pct": null,
"agent_fee_pct": null,
"prepay_months": null,
"lease_term": null,
"utilities_included": null,
"utilities_price_rub": null,
"meters_not_included": null,
"terms_text": "Свободная продажа, возможна ипотека",
"rooms": 2,
"flat_type": "rooms",
"is_studio": false,
"is_apartments": false,
"is_new_building": false,
"total_area_m2": 52.3,
"living_area_m2": 30.5,
"kitchen_area_m2": 8.6,
"min_area_m2": null,
"land": null,
"floor": 11,
"floors_total": 12,
"build_year": 1985,
"completion": null,
"building_material": "panel",
"decoration": null,
"newbuilding": null,
"address": "Россия, Москва, улица Академика Челомея, 8к2",
"address_parts": [
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"districts": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]"
}
],
"metro": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
}
],
"lat": 55.662963,
"lng": 37.528217,
"description": "Продаётся уютная двухкомнатная квартира на улице Академика Челомея, 8к2. Квартира расположена на 11 этаже 12-этажного панельного дома. Общая площадь составляет 52,3 кв. м, из них жилая площадь — 30,5 кв. м, а кухня — 8,6 кв. м. До метро \"Воронцовская\" всего 10 минут пешком.\n\nВ квартире выполнен косметический ремонт, который позволит новому владельцу сразу заехать и жить. Просторная кухня отлично подойдёт для семейных ужинов и встреч с друзьями. Из окон открывается вид на улицу и во двор, что обеспечивает разнообразие и позволяет наслаждаться как городскими пейзажами, так и спокойствием двора. ",
"photos": [
"https://images.cdn-cian.ru/images/kvartira-moskva-ulica-akademika-chelomeya-2986345087-1.jpg",
"https://images.cdn-cian.ru/images/kvartira-moskva-ulica-akademika-chelomeya-2986344912-1.jpg",
"https://images.cdn-cian.ru/images/kvartira-moskva-ulica-akademika-chelomeya-2986344936-1.jpg"
],
"photo_count": 11,
"has_video": false,
"published_at": "2026-10-14T21:50:11.27",
"updated_at": "2026-10-14T18:50:18Z",
"added_text": "сегодня, 21:50",
"seller": {
"kind": "owner",
"user_id": 19504448,
"name": null,
"account_type": null,
"is_owner": true,
"is_developer": false,
"is_passport_verified": true,
"level": null,
"phones": [
"[trimmed-depth]"
]
},
"is_top3": false,
"is_premium": false,
"is_auction": false,
"is_unique": false,
"mortgage_text": null
},
{
"id": 334978808,
"url": "https://www.cian.ru/sale/flat/334978808/",
"category": "flatSale",
"deal_type": "sale",
"offer_type": "flat",
"title": null,
"summary": "2-комн.кв. · 50,6 м² · 9/24 этаж",
"price_rub": 20299000,
"price_text": "20 299 000 ₽",
"price_min_rub": null,
"price_max_rub": null,
"price_per_m2_rub": 401166,
"price_period": null,
"price_text_was_placeholder": false,
"price_raw": {
"value": 20299000,
"unit": "total",
"period": null,
"currency": "rur"
},
"currency": "RUB",
"sale_type": "alternative",
"mortgage_allowed": true,
"bargain_allowed": null,
"vat_type": null,
"vat_rub": null,
"deposit_rub": null,
"tenant_fee_pct": null,
"agent_fee_pct": null,
"prepay_months": null,
"lease_term": null,
"utilities_included": null,
"utilities_price_rub": null,
"meters_not_included": null,
"terms_text": "Альтернативная продажа, возможна ипотека",
"rooms": 2,
"flat_type": "rooms",
"is_studio": false,
"is_apartments": null,
"is_new_building": false,
"total_area_m2": 50.6,
"living_area_m2": 28.5,
"kitchen_area_m2": 10.4,
"min_area_m2": null,
"land": null,
"floor": 9,
"floors_total": 24,
"build_year": null,
"completion": null,
"building_material": "panel",
"decoration": null,
"newbuilding": {
"id": 20063,
"name": "Саларьево парк",
"house": "корпус 15",
"finish": {
"year": "[trimmed-depth]",
"quarter": "[trimmed-depth]"
},
"url": "https://zhk-salarevo-park-i.cian.ru/"
},
"address": "Москва, Коммунарка район, Саларьевская ул., д.16к2",
"address_parts": [
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"districts": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]"
}
],
"metro": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
}
],
"lat": 55.616056,
"lng": 37.407501,
"description": "Продается светлая просторная 2-х комнатная квартира в ЖК \"Саларьево Парк\" в 15 минутах ходьбы от метро Саларьево. Окна на лесопарк на солнечную сторону. В квартире удобная планировка, просторная кухня, 2 спальни. Кухня укомплектована современной техникой (пoсудомоечная машина, индукционная плита, xoлoдильник, стиpaльная мaшинa, 3 кондициoнеpа). Один из санузлов перестроен под гардаробную.\nРазвитая инфраструктура, хорошая транспортная доступность, рядом с домом школа и детский сад, во дворе спортивные, детские площадки, магазин Пятерочка. В доме продуктовые магазины, кофейня, магазин \"ВкусВилл\"",
"photos": [
"https://images.cdn-cian.ru/images/2986345285-1.jpg",
"https://images.cdn-cian.ru/images/2986345289-1.jpg",
"https://images.cdn-cian.ru/images/2986345301-1.jpg"
],
"photo_count": 10,
"has_video": false,
"published_at": "2026-10-14T21:47:59.373",
"updated_at": "2026-10-14T18:48:00Z",
"added_text": "сегодня, 21:48",
"seller": {
"kind": "agent",
"user_id": 144842128,
"name": "Ольга Константиновская",
"account_type": "specialist",
"is_owner": false,
"is_developer": false,
"is_passport_verified": false,
"level": "Низкий уровень",
"phones": [
"[trimmed-depth]"
]
},
"is_top3": false,
"is_premium": false,
"is_auction": false,
"is_unique": false,
"mortgage_text": null
},
{
"id": 334978634,
"url": "https://www.cian.ru/sale/flat/334978634/",
"category": "flatSale",
"deal_type": "sale",
"offer_type": "flat",
"title": null,
"summary": "2-комн.кв. · 37 м² · 1/9 этаж",
"price_rub": 14900000,
"price_text": "14 900 000 ₽",
"price_min_rub": null,
"price_max_rub": null,
"price_per_m2_rub": 402703,
"price_period": null,
"price_text_was_placeholder": false,
"price_raw": {
"value": 14900000,
"unit": "total",
"period": null,
"currency": "rur"
},
"currency": "RUB",
"sale_type": "free",
"mortgage_allowed": true,
"bargain_allowed": null,
"vat_type": null,
"vat_rub": null,
"deposit_rub": null,
"tenant_fee_pct": null,
"agent_fee_pct": null,
"prepay_months": null,
"lease_term": null,
"utilities_included": null,
"utilities_price_rub": null,
"meters_not_included": null,
"terms_text": "Свободная продажа, возможна ипотека",
"rooms": 2,
"flat_type": "rooms",
"is_studio": false,
"is_apartments": false,
"is_new_building": false,
"total_area_m2": 37,
"living_area_m2": 23,
"kitchen_area_m2": 7.5,
"min_area_m2": null,
"land": null,
"floor": 1,
"floors_total": 9,
"build_year": 1965,
"completion": null,
"building_material": "block",
"decoration": null,
"newbuilding": null,
"address": "Россия, Москва, улица Бехтерева, 9к2",
"address_parts": [
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"districts": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]"
}
],
"metro": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"minutes": "[trimmed-depth]",
"transport": "[trimmed-depth]",
"line_color": "[trimmed-depth]",
"under_construction": "[trimmed-depth]"
}
],
"lat": 55.634527,
"lng": 37.651547,
"description": "Продается уютная 2-комнатная квартира у метро Кантемировская.\n\nПолностью готовая к проживанию. Это идеальный вариант для тех, кто ищет комфортное жилье в зеленом районе с блестящей транспортной доступностью.\n\nГлавные преимущества:\n* Идеальное расположение: Всего 2 минуты пешком до станции метро Кантемировская. Вы забудете о долгих дорогах до метро!\n* Планировка: две полноценные раздельные комнаты, что обеспечивает приватность для каждого члена семьи.\n* Заезжай и живи: мебель и техника остаются новым владельцам.\n* Окружение: Дом расположен в живописном, экологически чистом районе с многочисленн",
"photos": [
"https://images.cdn-cian.ru/images/kvartira-moskva-ulica-behtereva-2986342189-1.jpg",
"https://images.cdn-cian.ru/images/kvartira-moskva-ulica-behtereva-2986342191-1.jpg",
"https://images.cdn-cian.ru/images/kvartira-moskva-ulica-behtereva-2986342163-1.jpg"
],
"photo_count": 9,
"has_video": false,
"published_at": "2026-10-14T21:43:53.437",
"updated_at": "2026-10-14T18:43:54Z",
"added_text": "сегодня, 21:43",
"seller": {
"kind": "owner",
"user_id": 118825794,
"name": null,
"account_type": null,
"is_owner": true,
"is_developer": false,
"is_passport_verified": false,
"level": null,
"phones": [
"[trimmed-depth]"
]
},
"is_top3": false,
"is_premium": false,
"is_auction": false,
"is_unique": false,
"mortgage_text": null
}
]
}
}Actions
What the Cian API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Cian.ru, Russia's largest property portal: flats, rooms, houses, land, townhouses and commercial property, for sale, long-term rent or daily rent, in any region or city. Filters: rooms, new-build/resale, price, area, kitchen, floor, building year, owner-only or developer-only, one agency's ads, metro station with walking time, district, complex. Each row carries the printed price, price per m², rent terms (deposit, tenant commission, utilities), rooms, areas, floor, metro with minutes, address, coordinates, photos, the seller and the phone numbers the page publishes. `region` is required. | Real-estate investors call search to search Cian.ru, Russia's largest property portal. | region, deal, property_type, rent_term, commercial_type, ... |
| listing | One Cian ad in full: status (published/deleted), title and full description, the printed price and its raw basis, price per m², the full price-change history with the previous price, rent terms table, rooms, all areas, floor, building year, material, lifts, parking, repair, bathrooms, balconies, amenities, the site's feature table, complex, address, metro with minutes, coordinates, all photos and videos, view counter, and the seller (name, agency/developer, account type, ad count, phones). Either `id` or `url` is required. | Brokerage tools call listing to get one Cian ad in full. | id, url, include_pii |
| regions | Cian's own region and city ids for `search`: the 85 top-level regions, the cities of one region (`region_id`), or a name lookup (`query`). | Property dashboards call regions to get cian's own region and city ids for `search`. | query, region_id |
| geo_suggest | Cian's own location lookup: type part of a name and get metro stations (with lines), districts, complexes (ЖК), cities, roads, railway stations and builders with the ids `search` accepts (`metro`, `district`, `newbuilding_id`). | Lead-generation teams call geo_suggest to get cian's own location lookup. | query, region, deal, property_type |
Code samples
Call search from your stack
curl -X POST https://api.reefapi.com/cian/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"region":"1","deal":"sale","property_type":"flat","rooms":"2","sort":"newest"}'import requests
r = requests.post(
"https://api.reefapi.com/cian/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"region": "1",
"deal": "sale",
"property_type": "flat",
"rooms": "2",
"sort": "newest"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/cian/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"region": "1",
"deal": "sale",
"property_type": "flat",
"rooms": "2",
"sort": "newest"
}),
});
const { ok, data, meta, error } = await res.json();MCP one-liner
Ask your MCP-connected assistant: call reefapi.cian.search with {"region":"1","deal":"sale","property_type":"flat","rooms":"2","sort":"newest"}.Use cases
Who uses this API and why
- Build a rent or sale price index for a Russian city by rooms, metro station and district, with price per m² on every row.
- Track new-build supply: filter by residential complex, read completion year and developer, and watch price changes with listing.
- Monitor owner-only ads in a region for lead generation, with the owner's published phone number.
- Map commercial supply: offices, retail and warehouses for rent or sale with the rouble total, per-m² basis and VAT terms.
- Watch one agency's or developer's inventory with user_id and get notified of price cuts from price_history.
FAQ
Questions developers ask before integrating
Do I need a Cian account or a Russian IP?
No. Every endpoint reads public pages and Cian's own public lookups without an account or login, and you call reefapi.com from anywhere. Results depend on the region you ask for, not on where you call from.
Which property types and deals are covered?
Flats (including studios and new-build flats), rooms in shared flats, houses, parts of houses, land, townhouses and commercial property (office, retail, warehouse, free purpose, catering, garage, production, car service, business, building, domestic services), for sale, long-term rent or daily rent.
How do I search near a metro station?
Look the station up with geo_suggest (Арбатская is id 8 in Moscow), then search with metro=8 and, if you want, max_walk_minutes. Measured: 1,078 Moscow flats for sale near Арбатская, 333 of them at most 10 minutes on foot.
Does it return phone numbers?
Yes, the numbers the ad publishes, in seller.phones: on 252 of 252 search rows and 16 of 16 full ads in our check. The seller block also says whether the ad is from the owner, an agent or agency, or a developer.
Can I get only owner ads, or only one agency's ads?
seller=owner returns only ads placed by owners (6,176 Moscow flats for sale), seller=developer only developer ads (55,333). user_id takes any row's seller.user_id and returns that account's ads: 176 for one Moscow developer, the same number Cian shows on its profile.
How deep can I page?
Up to page 54 of any query, up to 28 ads per page, which is 1,500 ads, where Cian itself stops. Use sort=newest when paging: Cian's default order is its own ranking and repeated 4 ads across the first 4 pages in our test, newest order repeated none.
What does listing add over search?
The full price history with the previous price, the view counter (total and today), Cian's feature table (ceiling height, bathrooms, repair, view, lifts, parking), amenities, rent terms with prepayment, videos, the account's ad count and registration date, and the complex developer. A removed ad still returns its last data with is_active false.
Why is price_rub empty on some commercial rows?
Because the ad offers several units and prints a price range; price_min_rub and price_max_rub carry both ends.
What is the Cian API?
Cian API is a ReefAPI endpoint group for russia's largest property portal as json: flats, houses, land and commercial for sale or rent, with metro, rent terms and price history. It returns live JSON through POST requests under /cian/v1.
Is the Cian API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Cian calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Cian login or account?
No login to Cian is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Cian data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Cian API use?
Cian actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Cian from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call cian actions with the same key, credit pool and JSON envelope used by normal REST requests.