Cian Property Search Scraper

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:

{
  "urls": [
    "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=1&region=1"
  ],
  "ignore_url_failures": true,
  "include_raw_data": false,
  "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
include_raw_data	Boolean	If true, includes raw data from website before cleaning in the output	false

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

{
  "id": 335213260,
  "listing_url": "https://kaliningrad.cian.ru/sale/flat/335213260/",
  "title": null,
  "description": "Код объекта: 2398966.\nПродам просторную ВИДОВУЮ КВАРТИРУ в современном доме с лифтом, рядом с парком в центре Гурьевска!\n\n • Автономное отопление.\n • Тёплый пол на кухне и в ванной комнате.\n • Установлена многоступенчатая система очистки воды на кухне.\n • Над квартирой - технический этаж.\n • В подъезде есть приспособления для нужд маломобильных групп населения.\n\n2х комнатная квартира, Гурьевск, ул. Советская, 17г - удобная локация, отличный свежий ремонт из современных качественных материалов - можно сразу переезжать, ничего не нужно доделывать.\nРядом с домом парк. Это идеальные условия для утренних пробежек, прогулок с ребёнком или с собакой, спокойных вечеров после работы. Район тихий, зелёный, при этом всё нужное под рукой.\n\nЧто еще удобно:\n • Развитая инфраструктура: магазины, аптеки, кафе - в шаговой доступности,\n • Удобная транспортная доступность: рядом автобусная остановка, быстрый выезд в сторону Калининграда.\n • Спокойные дворы, хорошие соседи, ухоженная территория.\n\nПланировка практичная: комнаты изолированные, кухня удобная, места хватает и для хранения и для уюта.\nСостояние квартиры - полностью готова к жизни. Есть Wi-Fi и проводной интернет.\nПодходит под ипотеку.\nОдин взрослый собственник.\nЗвоните или пишите - с радостью покажу квартиру и расскажу подробнее.",
  "info_text": "2-комн.кв.  ·  65,6 м²  ·  6/8 этаж",
  "additional_info": "Свободная продажа, возможна ипотека",
  "deal_type": "sale",
  "offer_type": "flat",
  "category": "flatSale",
  "flat_type": "rooms",
  "status": "published",
  "price": 8499000,
  "price_text": "8 499 000 ₽",
  "currency": "rur",
  "price_type": "all",
  "sale_type": "free",
  "mortgage_allowed": true,
  "bargain_allowed": null,
  "agent_fee": null,
  "client_fee": null,
  "agent_bonus": null,
  "deposit": null,
  "vat_type": null,
  "vat_price": null,
  "tax": null,
  "lease_type": null,
  "lease_term_type": null,
  "utilities_terms": null,
  "payment_period": null,
  "total_area_m2": "65.6",
  "living_area_m2": "43.0",
  "kitchen_area_m2": "12.0",
  "min_area_m2": null,
  "rooms_count": 2,
  "bedrooms_count": null,
  "rooms_for_sale_count": null,
  "floor_number": 6,
  "balconies_count": 1,
  "layout": null,
  "decoration": null,
  "is_apartments": false,
  "is_rent_by_parts": false,
  "building_floors_count": 8,
  "building_year": 2016,
  "building_type": null,
  "building_material": "brick",
  "building_class": null,
  "heating_type": null,
  "passenger_lifts_count": 1,
  "cargo_lifts_count": null,
  "building_deadline": null,
  "building_access_type": null,
  "parking_type": "ground",
  "parking_places_count": null,
  "parking_is_free": null,
  "parking_price_monthly": null,
  "parking_price_entry": null,
  "address": "Россия, Калининградская область, Гурьевск, Советская улица, 17Г",
  "region": "Калининградская область",
  "region_id": 4574,
  "city": "Гурьевск",
  "city_id": 174599,
  "street": "Советская улица",
  "house": "17Г",
  "latitude": 54.7709,
  "longitude": 20.600121,
  "undergrounds": [],
  "railways": [],
  "highways": [],
  "districts": [],
  "residential_complex": null,
  "residential_complex_url": null,
  "created_at": "2026-10-22T18:54:19.547",
  "added_timestamp": 1793791531,
  "added_text": "вчера, 14:25",
  "is_new": false,
  "is_by_commercial_owner": null,
  "is_from_developer": false,
  "is_booked_from_developer": null,
  "is_premium": false,
  "is_top3": false,
  "is_pro": true,
  "is_cian_partner": false,
  "is_rosreestr_checked": false,
  "rosreestr_check": null,
  "village_mortgage_allowed": null,
  "demolished_in_moscow_program": null,
  "land": null,
  "offer_feature_labels": [],
  "contact_phones": [
    "+79339360334"
  ],
  "agent_id": 87744054,
  "agent_name": "Майя Шкатулова",
  "agent_company_name": "МоРе Калининград",
  "agent_account_type": "specialist",
  "agent_user_type": "realtor_based",
  "agent_trust_level": "involved",
  "agent_level_name": "Суперагент",
  "agent_is_super_agent": true,
  "agent_is_passport_verified": true,
  "agent_has_verified_documents": true,
  "agent_rating": null,
  "agent_avatar_url": "https://www.cian.ru/api/get-avatar/?i=69453162&t=2&p=2&timestamp=1740654537",
  "agent_phones": [
    "+79059625637",
    "+79097841122"
  ],
  "agency_id": 99627497,
  "agency_name": "МоРе Калининград",
  "agency_account_type": "agency",
  "agency_url": "https://www.cian.ru//company/99627497/",
  "photo_count": 26,
  "photo_urls": [
    "https://images.cdn-cian.ru/images/2991745062-1.jpg",
    "https://images.cdn-cian.ru/images/2991541398-1.jpg",
    "https://images.cdn-cian.ru/images/2991541404-1.jpg",
    "https://images.cdn-cian.ru/images/2991541416-1.jpg",
    "https://images.cdn-cian.ru/images/2991541429-1.jpg",
    "https://images.cdn-cian.ru/images/2993848665-1.jpg",
    "https://images.cdn-cian.ru/images/2991541445-1.jpg",
    "https://images.cdn-cian.ru/images/2991541451-1.jpg",
    "https://images.cdn-cian.ru/images/2991541467-1.jpg",
    "https://images.cdn-cian.ru/images/2993292191-1.jpg",
    "https://images.cdn-cian.ru/images/2992120865-1.jpg",
    "https://images.cdn-cian.ru/images/2991541502-1.jpg",
    "https://images.cdn-cian.ru/images/2991541507-1.jpg",
    "https://images.cdn-cian.ru/images/2991541510-1.jpg",
    "https://images.cdn-cian.ru/images/2993292181-1.jpg",
    "https://images.cdn-cian.ru/images/2991541528-1.jpg",
    "https://images.cdn-cian.ru/images/2991541535-1.jpg",
    "https://images.cdn-cian.ru/images/2991541550-1.jpg",
    "https://images.cdn-cian.ru/images/2991541557-1.jpg",
    "https://images.cdn-cian.ru/images/2991541563-1.jpg",
    "https://images.cdn-cian.ru/images/2991745066-1.jpg",
    "https://images.cdn-cian.ru/images/2991541578-1.jpg",
    "https://images.cdn-cian.ru/images/2991541581-1.jpg",
    "https://images.cdn-cian.ru/images/2991541594-1.jpg",
    "https://images.cdn-cian.ru/images/2991745069-1.jpg",
    "https://images.cdn-cian.ru/images/2991745071-1.jpg"
  ],
  "layout_photo_urls": [],
  "has_video": false,
  "video_urls": [],
  "raw_data": null,
  "from_url": "https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat&p=2"
}

Complete Output Structure and Field Definitions

The scraper returns JSON data with each property as an object containing detailed fields. Understanding field purposes enables effective analysis and application.

Listing Identification

ID: Unique numeric identifier of the listing on CIAN. Purpose: Database indexing, tracking specific listings over time, avoiding duplicates.

Listing URL: Direct link to the listing on CIAN (tracking parameters removed). Purpose: Accessing complete details, sharing opportunities with clients, verification of scraped data.

Title: Custom title of the listing (often null). Purpose: Quick preview when provided by the advertiser.

Description: Full text description written by the advertiser. Purpose: Extracting extra details (amenities, renovation, nearby services, ownership), keyword and sentiment analysis.

Info Text: Short summary line as displayed on CIAN (rooms, area, floor). Purpose: Quick display in reports and dashboards.

Additional Info: Sale conditions summary (e.g., free sale, mortgage possible). Purpose: Fast assessment of deal terms.

Listing Classification

Deal Type: Type of deal (e.g., sale, rent). Purpose: Separating sales from rentals.

Offer Type: Type of object offered (e.g., flat). Purpose: Segmenting by property class.

Category: CIAN category code (e.g., flatSale). Purpose: Fine-grained filtering by deal and property type.

Flat Type: Flat format (e.g., rooms, studio). Purpose: Distinguishing standard flats from studios and other formats.

Status: Publication status of the listing. Purpose: Filtering active listings.

Pricing and Terms

Price: Asking price as a number. Purpose: Price comparison, market valuation, price-per-m² calculation.

Price Text: Price exactly as displayed on the listing. Purpose: Display and verification against the website.

Currency: Currency code of the price (e.g., rur). Purpose: Correct financial interpretation across markets.

Price Type: What the price covers (e.g., all, per m²). Purpose: Interpreting the price correctly.

Sale Type: Sale format (e.g., free sale, alternative). Purpose: Understanding deal complexity.

Mortgage Allowed: Whether mortgage purchase is possible. Purpose: Targeting buyers who rely on financing.

Bargain Allowed: Whether price negotiation is allowed. Purpose: Estimating negotiation margin.

Agent Fee: Agent commission. Purpose: Estimating total transaction cost.

Client Fee: Commission charged to the client. Purpose: Estimating total transaction cost.

Agent Bonus: Bonus offered to cooperating agents. Purpose: Identifying motivated sellers and partner programs.

Deposit: Security deposit (rentals). Purpose: Rental cost analysis.

VAT Type: VAT treatment of the price. Purpose: Commercial property price interpretation.

VAT Price: Price including VAT. Purpose: Commercial property price comparison.

Tax: Tax terms of the deal. Purpose: Total cost assessment.

Lease Type: Lease format (rentals/commercial). Purpose: Segmenting rental deals.

Lease Term Type: Lease duration type. Purpose: Separating short-term from long-term rentals.

Utilities Terms: Utilities payment terms. Purpose: Estimating monthly running costs.

Payment Period: Payment frequency (rentals). Purpose: Rental cost analysis.

Property Characteristics

Total Area M2: Total area in square meters. Purpose: Price-per-m² analysis, size filtering.

Living Area M2: Living area in square meters. Purpose: Assessing usable space.

Kitchen Area M2: Kitchen area in square meters. Purpose: Layout and comfort evaluation.

Min Area M2: Minimum area (for divisible commercial units). Purpose: Filtering flexible commercial offers.

Rooms Count: Number of rooms. Purpose: Matching properties to buyer requirements.

Bedrooms Count: Number of bedrooms (when provided). Purpose: Household size targeting.

Rooms For Sale Count: Number of rooms sold in a shared flat. Purpose: Identifying partial-flat sales.

Floor Number: Floor on which the property is located. Purpose: Filtering by floor preference, accessibility analysis.

Balconies Count: Number of balconies. Purpose: Feature-based filtering.

Layout: Layout type of the property. Purpose: Layout-based filtering.

Decoration: Interior finishing level. Purpose: Assessing renovation needs and move-in readiness.

Is Apartments: Whether the property is legally apartments (non-residential status). Purpose: Identifying legal status differences.

Is Rent By Parts: Whether the property is rented by parts. Purpose: Separating shared rentals.

Building

Building Floors Count: Total floors in the building. Purpose: Building type assessment and floor-position analysis.

Building Year: Year the building was constructed. Purpose: Age-based valuation and renovation analysis.

Building Type: Building type classification. Purpose: Segmenting by building category.

Building Material: Main construction material (e.g., brick, panel). Purpose: Durability and valuation analysis.

Building Class: Quality class of the building (mainly commercial). Purpose: Segmenting by building tier.

Heating Type: Heating system type. Purpose: Estimating running costs.

Passenger Lifts Count: Number of passenger elevators. Purpose: Comfort and accessibility assessment.

Cargo Lifts Count: Number of cargo elevators. Purpose: Commercial property evaluation.

Building Deadline: Completion deadline (new buildings). Purpose: Tracking delivery timelines.

Building Access Type: Access type to the building. Purpose: Assessing accessibility and security.

Parking Type: Parking type available (e.g., ground). Purpose: Evaluating parking convenience.

Parking Places Count: Number of parking places. Purpose: Parking capacity analysis.

Parking Is Free: Whether parking is free. Purpose: Estimating additional costs.

Parking Price Monthly: Monthly parking fee. Purpose: Running cost estimation.

Parking Price Entry: One-time parking entry fee. Purpose: Upfront cost estimation.

Location

Address: Full address string. Purpose: Display and manual verification of the property position.

Region: Region (oblast) of the property. Purpose: Regional market comparison.

Region ID: CIAN identifier of the region. Purpose: Joining datasets and building search queries.

City: City or town of the property. Purpose: City-level market analysis and lead targeting.

City ID: CIAN identifier of the city. Purpose: Joining datasets and building search queries.

Street: Street name. Purpose: Street-level analysis.

House: House number. Purpose: Exact address matching.

Latitude: Geographic latitude. Purpose: Map plotting, distance calculations, spatial analysis.

Longitude: Geographic longitude. Purpose: Map plotting, distance calculations, spatial analysis.

Undergrounds: List of nearby metro stations. Purpose: Transport accessibility analysis.

Railways: List of nearby railway stations. Purpose: Transport accessibility analysis.

Highways: List of nearby highways. Purpose: Road accessibility analysis.

Districts: List of city districts. Purpose: Micro-market analysis.

Residential Complex: Residential complex information (new buildings). Purpose: Project-level analysis.

Residential Complex URL: Link to the residential complex page. Purpose: Accessing project details.

Listing Dates

Created At: Date and time the listing was created (ISO 8601). Purpose: Measuring time on market.

Added Timestamp: Unix timestamp (seconds) of the latest publication/update. Purpose: Precise sorting, detecting renewed listings.

Added Text: Publication time as displayed on CIAN (in Russian, relative). Purpose: Display and verification.

Listing Flags

Is New: Whether the listing is flagged as new. Purpose: Identifying recent market entries.

Is By Commercial Owner: Whether the offer is from a commercial owner. Purpose: Segmenting commercial listings.

Is From Developer: Whether the offer comes directly from a developer. Purpose: Separating primary from secondary market.

Is Booked From Developer: Whether the unit is booked at the developer. Purpose: Checking availability.

Is Premium: Whether the listing uses premium placement. Purpose: Analyzing advertising investment.

Is Top3: Whether the listing is promoted in the top 3 positions. Purpose: Analyzing advertising investment and visibility.

Is Pro: Whether the advertiser is a professional account. Purpose: Separating professionals from private sellers.

Is Cian Partner: Whether the advertiser is a CIAN partner. Purpose: Assessing advertiser status.

Is Rosreestr Checked: Whether the property was verified against the national property registry (Rosreestr). Purpose: Assessing listing trust.

Rosreestr Check: Details of the Rosreestr verification. Purpose: Verification auditing.

Village Mortgage Allowed: Whether rural mortgage programs apply. Purpose: Financing option analysis.

Demolished In Moscow Program: Whether the building is part of the Moscow demolition program. Purpose: Identifying relocation-program properties.

Land: Land plot information (houses and land). Purpose: Analyzing land attributes.

Offer Feature Labels: Special labels attached to the listing. Purpose: Identifying highlighted features.

Contact and Agent

Contact Phones: Phone numbers shown on the listing, in international format. Purpose: Direct outreach.

Agent ID: Unique identifier of the agent. Purpose: Grouping listings by agent, competitor tracking.

Agent Name: Name of the agent shown on the profile. Purpose: Lead generation, contact identification.

Agent Company Name: Company the agent works for. Purpose: Linking agents to agencies.

Agent Account Type: CIAN account type of the agent. Purpose: Segmenting advertisers.

Agent User Type: User category of the agent. Purpose: Segmenting advertisers.

Agent Trust Level: CIAN trust level of the agent. Purpose: Assessing reliability.

Agent Level Name: Quality level title of the agent (e.g., Superagent). Purpose: Assessing agent quality.

Agent Is Super Agent: Whether the agent holds the super agent status. Purpose: Identifying top-performing agents.

Agent Is Passport Verified: Whether the agent's identity is verified by passport. Purpose: Assessing trust.

Agent Has Verified Documents: Whether the agent's documents are verified. Purpose: Assessing trust.

Agent Rating: Personal rating of the agent (may be null). Purpose: Quality benchmarking.

Agent Avatar URL: Link to the agent's avatar. Purpose: Branding in reports and dashboards.

Agent Phones: Phone numbers of the agent profile. Purpose: Direct outreach.

Agency ID: Unique identifier of the parent agency. Purpose: Grouping listings by agency, market share analysis.

Agency Name: Name of the parent agency. Purpose: Lead generation, competitor analysis.

Agency Account Type: Account type of the agency. Purpose: Segmenting agencies.

Agency URL: Link to the agency profile on CIAN. Purpose: Exploring the agency's portfolio.

Media

Photo Count: Total number of photos. Purpose: Evaluating listing quality and completeness.

Photo URLs: List of full-size photo links in original order. Purpose: Downloading images, visual inspection, computer vision analysis.

Layout Photo URLs: Links of photos marked as floor layouts. Purpose: Accessing floor plans.

Has Video: Whether the listing includes video. Purpose: Measuring listing quality and presentation effort.

Video URLs: List of video links (empty if none). Purpose: Direct access to video walkthroughs.

Raw Data

Raw Data: Complete original JSON object of the listing as scraped, without modification. Purpose: Auditing, debugging, accessing fields not included in the cleaned output, and reprocessing without re-scraping.

---

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.