# Changelog of Cian Scraper — Russia Property Data & API (`sian.agency/cian-property-scraper`) Actor

- **URL**: https://apify.com/sian.agency/cian-property-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/cian-property-scraper.md

## Changelog

All notable changes to **Cian Scraper — Russia Property Data & API** will be documented in this file.

### \[2026-08-28] — v1.0.8

#### 📊 More useful dataset columns

- **Run metadata on every row** — each listing now carries a processed-at timestamp, scraping date and processing status, so you can filter and audit large pulls without cross-referencing the run log.
- **Clickable listing & photo links** — the thumbnail and listing URL columns now render as clickable links directly in the dataset view instead of plain text.
- **Cleaner bulk URL fields** — pasting search or listing URLs no longer accepts accidental duplicate entries.

### \[1.0.7] — 2026-08-22

#### 📄 New run report — see what you got, and what you paid for

- **Value first** — the report opens with the listings you extracted, the pages fetched and the median price per square metre for the run, then hands you the dataset in one click (JSON, CSV or Excel).
- **Best-value listing, ready to paste** — the lowest ₽/m² listing of the run is rendered as copyable text for a note, a message or a shortlist.
- **Failed items come with a fix** — anything that did not come back is listed with a plain-English reason and a ready-made retry input you can paste straight into the JSON input tab. Failed fetches are never charged.
- **Itemized charges statement** — every billed event, its count and its rate, so the report reads like the invoice.
- **Copy-paste API and AI-agent snippets** — the exact API request that reproduces the run, plus an MCP config for Claude, ChatGPT or Cursor.

#### 💎 User Benefits

- No more guessing why a run returned fewer listings than expected — the reason and the retry are on the page.
- Market researchers get a headline ₽/m² figure without opening a spreadsheet.
- Analysts can re-run the exact same query from the report, months later.

#### 🎯 Use Cases

- A property investor re-runs a Moscow search from last week's report and diffs the two datasets.
- A PropTech team pastes the API snippet into their pipeline to schedule the same pull nightly.
- A lead-gen agency copies the failed-listing retry input and recovers the handful of listings a run missed.

### \[1.0.6] — 2026-07-11

- ⚡ **Detail mode is now ~10× faster and lighter**: a 25-listing detail run completes in about two minutes, with the same fields and the same reliability.
- 🪶 Quicker run starts — less time spent getting ready, more time pulling listings.

### \[1.0.5] — 2026-07-11

- 🛡️ **Fail-fast reliability** in Detail mode: if listing pages stop loading, the run now stops after a few consecutive failures instead of grinding through the whole list — you get a clear error fast and are never charged for undelivered rows.
- 🎯 **Charge integrity**: a removed or redirected listing URL now fails cleanly instead of occasionally returning (and billing) an unrelated listing from Cian's recommendations page.
- 🆔 **Pasted listing URLs are now always honored** in Detail mode: previously, leaving the "Search by" dropdown untouched could silently run a default search instead of fetching your listing URLs.
- 🔎 More accurate error reporting: failures to reach a page are now reported as fetch errors rather than parse errors, making run logs easier to act on.

### \[1.0.1] — 2026-07-03

- ⚡ **New "By API location" search mode** — a fast path: search by free-text **location** (city, district, metro station or street, e.g. Москва) or by **latitude/longitude/radius**, with no region ID to look up.
- 🎛️ Reuses your existing filters (deal type, property type, rooms, price & area range, new-builds only, sort) and bills the same per-result Overview price.
- 🪶 Lightweight — runs comfortably at 512 MB (the URL/region modes keep the 2 GB default).

### \[1.0.0] — 2026-06-16

- 🎉 Initial release: scrape Cian (Циан), Russia's #1 real-estate portal, into clean structured data.
- 🇷🇺 Nationwide coverage by region ID, native filters, or pasted Cian search URL (Moscow, St Petersburg & beyond).
- ⚡ **Overview** mode: every core field straight from the search results — price, price/m², rooms, area, floor, metro & walk time, GPS, building, complex/developer and seller.
- 🔍 **Detail** mode: full per-listing data — complete description, all photos and the richest building & seller fields.
- 🛏️ Native filters & sort: deal type, property type, rooms, price & area ranges, new-builds (ЖК) only, and Cian's own sort orders.
- 💸 Transparent pay-per-result pricing with a free tier; input validated before any charge.
- 📤 Export to JSON, CSV or Excel, or pull via the Apify API.