Reef AI: ask for any data. Try it
Cian API

Search Russia's largest property portal by region and metro, then read any ad with its price history

success rate
99.3%
median response
1.6s
endpoints
4
Measured on live customer calls,

Cian.ru is Russia's largest real-estate portal, and this API reads it region by region.

POST/cian/v1/search
Real result, captured Oct 14, 20263 of 28
addressprice_rubcategorydeal_type
Россия, Москва, улица Академика Челомея, 8к223,500,000 RUBflatSalesale
Москва, Коммунарка район, Саларьевская ул., д.16к220,299,000 RUBflatSalesale
Россия, Москва, улица Бехтерева, 9к214,900,000 RUBflatSalesale
4 active endpoints, on 1 and 3 credit tiers.search · listing · regions · geo_suggestDetails ↓OpenAPI 3.0 spec ↗

3 credits per call≈ $3/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Cian API

6 of 4 endpoints, ready to run

View docs ↗

Two-room flats for sale in Moscow, newest first

3 credits1 required · 3 optional
POST/cian/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Cian endpoints does ReefAPI ship?

4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    3 cr

    Search Cian.ru, Russia's largest property portal.

    required
    region
    optional
    deal, property_type, rent_term, commercial_type, rooms, building, min_price, max_price, min_area, max_area, min_kitchen_area, min_floor, max_floor, not_first_floor, not_last_floor, min_build_year, max_build_year, seller, user_id, metro, max_walk_minutes, district, newbuilding_id, sort, page, include_pii
  • listing

    3 cr

    One Cian ad in full.

    required
    —
    optional
    id, url, include_pii
  • regions

    1 cr

    Cian's own region and city ids for search.

    required
    —
    optional
    query, region_id
  • geo_suggest

    1 cr

    Cian's own location lookup.

    required
    query
    optional
    region, deal, property_type

Every parameter, every allowed value →

Missing a Cian endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Cian API works

Cian is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 674 engines.

Call02
POST /cian/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a metro station to a priced rental feed with landlords' phones

Resolve the station once, filter the market around it, then read the ads that matter in full.

01geo_suggest?query=Арбат&region=1
GET/cian/v1/geo_suggest?query=Арбат&region=1

Cian's own lookup: metro Арбатская is id 8 (two lines), the Арбат district is id 13, plus 5 residential complexes with their ids.

02search?region=1&metro=8&max_walk_minutes=10&sort=newest
GET/cian/v1/search?region=1&metro=8&max_walk_minutes=10&sort=newest

333 Moscow flats for sale within 10 minutes' walk of Арбатская on 2026-10-14, up to 28 per page, each with the printed price, price per m², rooms, areas, floor, every nearby station with minutes, coordinates and the seller's phone.

03listing?id=<id>
GET/cian/v1/listing?id=<id>

The full ad: price history with the previous price, view counter, Cian's feature table, rent terms where it is a rental, all photos and the seller block.

A dated, priced feed of Russian listings around one metro station, with price changes and the phone numbers the ads publish.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "cian",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
price_rub vs price_rawprice_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_rubLarge 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 adsSome 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_periodmonth 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_includedRent 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 developerseller 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_rubEvery 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_pagetotal 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.

Coverage

Russia coverage, measured

Every number below was read from live Cian on 2026-10-14; two runs of 56 calls each returned the same filter counts within a few ads.

Market

All Russian regions Cian lists (85 top-level regions, their cities by id or name), prices in roubles. Flats, rooms, houses, parts of houses, land, townhouses and 11 kinds of commercial property, for sale, long-term rent and daily rent.

Live volume

Moscow: 96,155 flats for sale, 654 rooms, 15,028 offices for rent, 808 warehouses for sale. Saint Petersburg: 12,424 long-term and 60,183 daily rentals. Moscow Oblast: 39,675 houses and 41,620 land plots for sale. Kazan: 10,746 one- and two-room flats.

Filters that bite

Moscow flats for sale 96,155: one-room 25,286, studios 7,478, new-build 58,112, 10-20 million roubles 25,127, 40-60 m² 29,731, owner-only 6,176, near Арбатская 1,078 (333 within 10 minutes' walk), district Арбат 433, one complex 101.

Field fill

On 252 search rows across 9 property types: address, coordinates, photos, description and seller phones 252; printed price 249; metro 195 of 196 city rows; rooms on 126 of 140 flat and room rows. On 16 full ads: price history and view counter 16, metro 14, building year 9.

Identity and prices

16 of 16 search ids resolved to the same ad in listing. The rouble price matched the ad page's own printed price on 16 of 16 ads, and the search row on 15 of 16 (one dollar-priced ad differs by 1 rouble).

Limits

1,500 ads per query (page 54). Coordinates-and-radius search, amenity filters and building class are not offered. View counters are not printed on every ad. Building year is missing on many new-build ads, which carry a completion year instead.

Use cases

What people build with Cian

The jobs this data is most often used for.

01

Build a rent or sale price index for a Russian city by rooms, metro station and district, with price per m² on every row.

02

Track new-build supply: filter by residential complex, read completion year and developer, and watch price changes with listing.

03

Monitor owner-only ads in a region for lead generation, with the owner's published phone number.

04

Map commercial supply: offices, retail and warehouses for rent or sale with the rouble total, per-m² basis and VAT terms.

4

endpoints

1/3

credits per call

Pricing

What Cian data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 674 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

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"
    },
    timeout=90,
)
print(r.json()["data"])
From developers

Questions developers ask about Cian data

Collected from Stack Overflow, Reddit and search, and answered with live calls on 2 Nov 2026.

Is there a Cian (ЦИАН) API for listings, or do people scrape it?▾

Developers who look for a Cian API on GitHub and Habr mostly end up with a scraper: the open-source Python library cianparser is the usual answer, and its own README says it relies on CloudScraper and user-supplied proxies to get past Cloudflare and still warns about captchas on long runs.

ReefAPI's Cian API gives you the same Cian.ru listings as JSON through one POST call per page: sale and long-term or daily rent in any Russian region, with price, price per m², rooms, floor, nearest metro stations and the seller on every row.

curl · two-room flats in Moscow, newest first
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","rooms":"2","sort":"newest"}'

Real response, 2 Nov 2026: total 31,832 · newest: 89 000 000 ₽ · 83.2 m² · price_per_m2_rub 1,069,712 · floor 3 of 5 · Новокузнецкая 8 min walk · district Замоскворечье

My Cian parser gets a captcha, 429 or 403 after two or three pages. How do I keep collecting?▾

Users of cianparser report the same pattern in its GitHub issues: a captcha (the traffic-light picture test) after a few pages, 429 once they go past page 2, and 403 when they switch to proxies or a VPN; one of them ended up waiting two minutes between pages.

With ReefAPI's Cian API your script never sees the Cian page at all; it asks for page 1, 2, 3 … of a search and reads listings from the JSON, stopping when has_more is false.

python · first three pages
import requests

for page in range(1, 4):
    r = requests.post(
        "https://api.reefapi.com/cian/v1/search",
        headers={"x-api-key": REEF_KEY},
        json={"region": "2", "deal": "rent", "rooms": "1", "sort": "newest", "page": page},
    )
    data = r.json()["data"]
    for ad in data["listings"]:
        print(ad["id"], ad["price_rub"], ad["deposit_rub"], ad["url"])
    if not data["has_more"]:
        break

Real response, 2 Nov 2026: Saint Petersburg, page 3 of 54: 28 ads · total 4,261 · 54 000 ₽/мес., 34 m² · deposit_rub 49,000 · tenant_fee_pct 80 · Ленинский проспект 3 min by transport

Why does my Cian scrape repeat listings after page 54, and how do I get every ad for a query?▾

The cianparser maintainer explains it in the issue about 1,319 duplicates out of 2,797 rows: Cian lists results only up to page 54, about 1,500 ads, and asking for page 55 sends you back to page 1.

ReefAPI's Cian API returns Cian's own total and the last_page you can actually reach, and adds a warning when a query is bigger than 1,500. Split it by rooms, max_price or district until total fits, then page with sort: newest so the order does not shift under you.

curl · narrowed query
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","rooms":"studio","max_price":11000000,"sort":"newest"}'

Real response, 2 Nov 2026: all Moscow flats for sale: total 96,404, last_page 54 + warning · studios up to 11 000 000 ₽: total 1,373, last_page 50, no warning · pages 1 and 2 share no ids

How do I search Cian outside Moscow: another city, Moscow Oblast, or one Moscow district?▾

This comes up in the cianparser issues: a search for Уфа that only printed empty result pages, and a request to search Московская область and Moscow districts such as Лефортово.

In ReefAPI's Cian API, region takes a Cian id or the exact Russian city name, so "Уфа" resolves to region 176245, and Moscow Oblast is 4593. For a district, look it up with geo_suggest (Лефортово is district 75, which returned 1,078 flats for sale) and pass it as district.

curl · Ufa by name
curl -X POST https://api.reefapi.com/cian/v1/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"region":"Уфа","deal":"sale","rooms":"1,2"}'

Real response, 2 Nov 2026: region 176245 "Уфа" · total 11,007 one- and two-room flats for sale · 3 500 000 ₽ for 31.3 m² on Первомайская улица, 111,821 ₽/m² · district Черниковка

Can I get only owner ads (от собственника) with the price per square metre?▾

Both were feature requests from cianparser users: an owner-only filter (Cian's own is_by_homeowner=1 key) and a price-per-m² column, so they would not have to divide price by area themselves.

ReefAPI's Cian API takes seller: "owner" (or "developer"), and every row carries price_per_m2_rub next to price_rub and total_area_m2, with seller.is_owner to confirm who placed the ad.

curl · owner-only one-room flats
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","seller":"owner","rooms":"1","sort":"newest"}'

Real response, 2 Nov 2026: total 1,527 · 25 000 000 ₽ · 38.5 m² · price_per_m2_rub 649,351 · floor 25 of 27 · Авиамоторная 11 min walk · seller.kind owner

How do I find Cian apartments for rent in Moscow near one metro station?▾

Cian filters by metro station id, so first look the station up: ReefAPI's Cian geo_suggest with Таганская returns metro id 123 (Кольцевая and Таганско-Краснопресненская lines).

Then search with deal: "rent", metro: 123 and max_walk_minutes. Each Moscow rental comes back with its monthly price, deposit_rub, the tenant commission in tenant_fee_pct, whether utilities are included, and walking minutes to every nearby station.

curl · 1-room rent, ≤10 min from Таганская
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":"rent","rooms":"1","metro":123,"max_walk_minutes":10,"sort":"newest"}'

Real response, 2 Nov 2026: total 15 · 75 000 ₽/мес. · 35 m² · deposit_rub 75,000 · tenant_fee_pct 50 · utilities_included true · Таганская 5 min walk, Марксистская 9 min

FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Cian.

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.

Same key

34 Real Estate APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Cian, you are one call away from the rest of the category — no second contract, no second integration.

Already paying for something else?Cian vs Bright Data
Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 673 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-14.