/cian/offers/search

curl --request POST \
  --url https://api.anysite.io/api/cian/offers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "region": 1,
  "deal_type": "sale",
  "offer_type": "flat",
  "only_newbuilding": true,
  "rooms": [],
  "min_price": 1,
  "max_price": 1,
  "min_total_area": 1,
  "max_total_area": 1,
  "min_living_area": 1,
  "max_living_area": 1,
  "min_kitchen_area": 1,
  "max_kitchen_area": 1,
  "min_floor": 1,
  "max_floor": 1,
  "min_floors_count": 1,
  "max_floors_count": 1,
  "min_ceiling_height": 1,
  "min_build_year": 1,
  "max_build_year": 1,
  "house_material": [],
  "repair": [],
  "max_metro_time": 1,
  "from_developer": true,
  "from_owner": true,
  "mortgage_possible": true,
  "not_first_floor": true,
  "with_balcony": true,
  "with_loggia": true,
  "with_video": true,
  "with_photo": true,
  "sort": "default"
}
'

[
  {
    "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/search

Search CIAN real-estate offers within a region. Returns offer cards: id, url, deal/offer type, price (with multi-currency values), total/living/kitchen area, rooms, floor, building details, address with coordinates and nearby metro, photos, the new-building complex and the seller. Filter by deal type, property type, room layout, price/area/floor/ceiling/build-year ranges, building material, renovation, metro distance, new-build only, developer-only, owner-only, mortgage-possible, not-first-floor, balcony, loggia, video and photos, with configurable sort order.

Price: 20 credits per 28 results

💡 AI Hint: Search CIAN offers within a region (region: numeric CIAN region ID, 1 = Moscow, 2 = Saint Petersburg). Choose deal_type (sale/rent/rent_daily) and offer_type (flat/room/house/commercial/garage/…). Each result has id (feed to cian/offers for full detail), url, price, area, rooms_count, floor_number, address, latitude/longitude, undergrounds, image+images, newbuilding and seller. Narrow with rooms, min/max price (RUB; per month for rentals), total/living/kitchen area ranges, floor and building-floors ranges, ceiling height, build-year range, house_material, repair, metro distance (max_metro_time + metro_transport), only_newbuilding, from_developer, from_owner, mortgage_possible, not_first_floor, with_balcony, with_loggia, with_video, with_photo and sort.

⚠️ Common errors: 412: Region not found or no offers matched

POST

api

cian

offers

/cian/offers/search

curl --request POST \
  --url https://api.anysite.io/api/cian/offers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "region": 1,
  "deal_type": "sale",
  "offer_type": "flat",
  "only_newbuilding": true,
  "rooms": [],
  "min_price": 1,
  "max_price": 1,
  "min_total_area": 1,
  "max_total_area": 1,
  "min_living_area": 1,
  "max_living_area": 1,
  "min_kitchen_area": 1,
  "max_kitchen_area": 1,
  "min_floor": 1,
  "max_floor": 1,
  "min_floors_count": 1,
  "max_floors_count": 1,
  "min_ceiling_height": 1,
  "min_build_year": 1,
  "max_build_year": 1,
  "house_material": [],
  "repair": [],
  "max_metro_time": 1,
  "from_developer": true,
  "from_owner": true,
  "mortgage_possible": true,
  "not_first_floor": true,
  "with_balcony": true,
  "with_loggia": true,
  "with_video": true,
  "with_photo": true,
  "sort": "default"
}
'

[
  {
    "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

count

integer

required

Max number of results to return

Required range: x >= 1

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

region

integer

default:1

CIAN region ID (e.g. 1 = Moscow, 2 = Saint Petersburg).

deal_type

enum<string>

default:sale

Deal type: sale, long-term rent or daily rent.

Available options:

sale,

rent,

rent_daily

offer_type

enum<string>

default:flat

Property type.

Available options:

flat,

room,

house,

house_part,

townhouse,

land,

commercial,

garage

only_newbuilding

boolean | null

Only new-build (primary market) offers.

rooms

enum<string>[] | null

Restrict to these room layouts (multiple allowed).

Available options:

studio,

1,

2,

3,

4,

5,

6+,

free_layout

min_price

integer | null

Minimum price (RUB; per month for rentals).

Required range: x >= 0

max_price

integer | null

Maximum price (RUB; per month for rentals).

Required range: x >= 0

min_total_area

number | null

Minimum total area (m²).

Required range: x >= 0

max_total_area

number | null

Maximum total area (m²).

Required range: x >= 0

min_living_area

number | null

Minimum living area (m²).

Required range: x >= 0

max_living_area

number | null

Maximum living area (m²).

Required range: x >= 0

min_kitchen_area

number | null

Minimum kitchen area (m²).

Required range: x >= 0

max_kitchen_area

number | null

Maximum kitchen area (m²).

Required range: x >= 0

min_floor

integer | null

Minimum floor of the flat.

Required range: x >= 0

max_floor

integer | null

Maximum floor of the flat.

Required range: x >= 0

min_floors_count

integer | null

Minimum number of floors in the building.

Required range: x >= 0

max_floors_count

integer | null

Maximum number of floors in the building.

Required range: x >= 0

min_ceiling_height

number | null

Minimum ceiling height (m).

Required range: x >= 0

min_build_year

integer | null

Minimum building construction year.

Required range: x >= 0

max_build_year

integer | null

Maximum building construction year.

Required range: x >= 0

house_material

enum<string>[] | null

Restrict to these building materials (multiple allowed).

Available options:

brick,

monolith,

panel,

block,

wood,

stalin,

shield,

brick_monolith,

wireframe,

aerocrete_block,

gas_silicate_block

repair

enum<string>[] | null

Restrict to these renovation states (multiple allowed).

Available options:

without,

cosmetic,

euro,

design

metro_transport

enum<string> | null

How to measure metro distance when max_metro_time is set.

Available options:

walk,

transport

max_metro_time

integer | null

Maximum time to metro (minutes), measured per metro_transport.

Required range: x >= 0

from_developer

boolean | null

Only offers sold directly by the developer.

from_owner

boolean | null

Only offers listed directly by the owner (no agents).

mortgage_possible

boolean | null

Only offers where a mortgage purchase is possible.

not_first_floor

boolean | null

Exclude offers on the first floor.

with_balcony

boolean | null

Only offers that have at least one balcony.

with_loggia

boolean | null

Only offers that have a loggia.

with_video

boolean | null

Only offers that include a video.

with_photo

boolean | null

Only offers that have photos.

sort

enum<string>

default:default

Result ordering.

Available options:

default,

price_asc,

price_desc,

area,

metro_time,

street,

date_desc,

date_asc

Response

Successful Response

integer

required

@type

string

default:@cian_offer

url

string | null

title

string | null

deal_type

string | null

offer_type

string | null