/cian/offers

curl --request POST \
  --url https://api.anysite.io/api/cian/offers \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "offer": "<string>",
  "timeout": 300
}
'

[
  {
    "id": 123,
    "@type": "@cian_offer",
    "url": "<string>",
    "title": "<string>",
    "deal_type": "<string>",
    "offer_type": "<string>",
    "category": "<string>",
    "status": "<string>",
    "flat_type": "<string>",
    "is_apartments": true,
    "price": 123,
    "price_rur": 123,
    "price_usd": 123,
    "price_eur": 123,
    "price_per_meter": 123,
    "currency": "<string>",
    "sale_type": "<string>",
    "rooms_count": 123,
    "total_area": 123,
    "living_area": 123,
    "kitchen_area": 123,
    "floor_number": 123,
    "combined_wcs_count": 123,
    "windows_view_type": "<string>",
    "decoration": "<string>",
    "build_year": 123,
    "material_type": "<string>",
    "floors_count": 123,
    "ceiling_height": 123,
    "passenger_lifts_count": 123,
    "cargo_lifts_count": 123,
    "parking_type": "<string>",
    "deadline_year": 123,
    "deadline_quarter": "<string>",
    "address": "<string>",
    "latitude": 123,
    "longitude": 123,
    "undergrounds": [],
    "districts": [],
    "description": "<string>",
    "image": "<string>",
    "images": [],
    "published_at": 123,
    "created_at": "<string>",
    "edited_at": "<string>",
    "newbuilding": {
      "name": "<string>",
      "@type": "@cian_newbuilding_ref",
      "id": 123,
      "url": "<string>",
      "deadline_year": 123,
      "deadline_quarter": "<string>",
      "is_finished": true
    },
    "seller": {
      "@type": "@cian_seller",
      "id": 123,
      "name": "<string>",
      "type": "<string>",
      "account_type": "<string>",
      "company_name": "<string>",
      "is_agent": true,
      "is_builder": true,
      "is_developer": true,
      "offers_count": 123,
      "image": "<string>"
    },
    "view_count": 123,
    "price_history": [],
    "features": []
  }
]

/cian

/cian/offers

Get full CIAN real-estate offer details by offer ID (or offer URL): deal type, offer type, price (with per-square-meter and multi-currency values), total/living/kitchen area, rooms, floor, decoration, building (material, year, floors, ceiling height, lifts, parking, completion deadline), address with coordinates and nearby metro/districts, description, photos, the new-building complex, the seller/agent, view count, price history and the about-flat/about-building feature list.

Price: 20 credits

💡 AI Hint: Fetch a single CIAN offer by numeric ID or an offer URL. Returns one item with id, url, title, deal_type (sale/rent), offer_type, category, status, price (numeric) with price_per_meter and price_rur/usd/eur, currency, sale_type, rooms_count, total_area/living_area/kitchen_area, floor_number, combined_wcs_count, windows_view_type, decoration, build_year, material_type, floors_count, ceiling_height, passenger/cargo_lifts_count, parking_type, deadline_year/quarter, address, latitude/longitude, undergrounds (metro with travel time), districts, description, image+images, published_at, created_at, edited_at, newbuilding (complex ref), seller (agent/agency), view_count, price_history and features (about flat/building).

⚠️ Common errors: 412: Offer not found (well-formed but nonexistent or removed listing)

POST

api

cian

offers

/cian/offers

curl --request POST \
  --url https://api.anysite.io/api/cian/offers \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "offer": "<string>",
  "timeout": 300
}
'

[
  {
    "id": 123,
    "@type": "@cian_offer",
    "url": "<string>",
    "title": "<string>",
    "deal_type": "<string>",
    "offer_type": "<string>",
    "category": "<string>",
    "status": "<string>",
    "flat_type": "<string>",
    "is_apartments": true,
    "price": 123,
    "price_rur": 123,
    "price_usd": 123,
    "price_eur": 123,
    "price_per_meter": 123,
    "currency": "<string>",
    "sale_type": "<string>",
    "rooms_count": 123,
    "total_area": 123,
    "living_area": 123,
    "kitchen_area": 123,
    "floor_number": 123,
    "combined_wcs_count": 123,
    "windows_view_type": "<string>",
    "decoration": "<string>",
    "build_year": 123,
    "material_type": "<string>",
    "floors_count": 123,
    "ceiling_height": 123,
    "passenger_lifts_count": 123,
    "cargo_lifts_count": 123,
    "parking_type": "<string>",
    "deadline_year": 123,
    "deadline_quarter": "<string>",
    "address": "<string>",
    "latitude": 123,
    "longitude": 123,
    "undergrounds": [],
    "districts": [],
    "description": "<string>",
    "image": "<string>",
    "images": [],
    "published_at": 123,
    "created_at": "<string>",
    "edited_at": "<string>",
    "newbuilding": {
      "name": "<string>",
      "@type": "@cian_newbuilding_ref",
      "id": 123,
      "url": "<string>",
      "deadline_year": 123,
      "deadline_quarter": "<string>",
      "is_finished": true
    },
    "seller": {
      "@type": "@cian_seller",
      "id": 123,
      "name": "<string>",
      "type": "<string>",
      "account_type": "<string>",
      "company_name": "<string>",
      "is_agent": true,
      "is_builder": true,
      "is_developer": true,
      "offers_count": 123,
      "image": "<string>"
    },
    "view_count": 123,
    "price_history": [],
    "features": []
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

offer

string

required

CIAN offer ID or an offer URL containing it

Minimum string length: 1

Examples:

"317927888"

"https://www.cian.ru/sale/flat/317927888/"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

integer

required

@type

string

default:@cian_offer

url

string | null

title

string | null

deal_type

string | null

offer_type

string | null