/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"
}
'

import requests

url = "https://api.anysite.io/api/cian/offers/search"

payload = {
    "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"
}
headers = {
    "access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.anysite.io/api/cian/offers/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anysite.io/api/cian/offers/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anysite.io/api/cian/offers/search"

	payload := strings.NewReader("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"region\": 1,\n  \"deal_type\": \"sale\",\n  \"offer_type\": \"flat\",\n  \"only_newbuilding\": true,\n  \"rooms\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_total_area\": 1,\n  \"max_total_area\": 1,\n  \"min_living_area\": 1,\n  \"max_living_area\": 1,\n  \"min_kitchen_area\": 1,\n  \"max_kitchen_area\": 1,\n  \"min_floor\": 1,\n  \"max_floor\": 1,\n  \"min_floors_count\": 1,\n  \"max_floors_count\": 1,\n  \"min_ceiling_height\": 1,\n  \"min_build_year\": 1,\n  \"max_build_year\": 1,\n  \"house_material\": [],\n  \"repair\": [],\n  \"max_metro_time\": 1,\n  \"from_developer\": true,\n  \"from_owner\": true,\n  \"mortgage_possible\": true,\n  \"not_first_floor\": true,\n  \"with_balcony\": true,\n  \"with_loggia\": true,\n  \"with_video\": true,\n  \"with_photo\": true,\n  \"sort\": \"default\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/cian/offers/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"region\": 1,\n  \"deal_type\": \"sale\",\n  \"offer_type\": \"flat\",\n  \"only_newbuilding\": true,\n  \"rooms\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_total_area\": 1,\n  \"max_total_area\": 1,\n  \"min_living_area\": 1,\n  \"max_living_area\": 1,\n  \"min_kitchen_area\": 1,\n  \"max_kitchen_area\": 1,\n  \"min_floor\": 1,\n  \"max_floor\": 1,\n  \"min_floors_count\": 1,\n  \"max_floors_count\": 1,\n  \"min_ceiling_height\": 1,\n  \"min_build_year\": 1,\n  \"max_build_year\": 1,\n  \"house_material\": [],\n  \"repair\": [],\n  \"max_metro_time\": 1,\n  \"from_developer\": true,\n  \"from_owner\": true,\n  \"mortgage_possible\": true,\n  \"not_first_floor\": true,\n  \"with_balcony\": true,\n  \"with_loggia\": true,\n  \"with_video\": true,\n  \"with_photo\": true,\n  \"sort\": \"default\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/cian/offers/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"region\": 1,\n  \"deal_type\": \"sale\",\n  \"offer_type\": \"flat\",\n  \"only_newbuilding\": true,\n  \"rooms\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_total_area\": 1,\n  \"max_total_area\": 1,\n  \"min_living_area\": 1,\n  \"max_living_area\": 1,\n  \"min_kitchen_area\": 1,\n  \"max_kitchen_area\": 1,\n  \"min_floor\": 1,\n  \"max_floor\": 1,\n  \"min_floors_count\": 1,\n  \"max_floors_count\": 1,\n  \"min_ceiling_height\": 1,\n  \"min_build_year\": 1,\n  \"max_build_year\": 1,\n  \"house_material\": [],\n  \"repair\": [],\n  \"max_metro_time\": 1,\n  \"from_developer\": true,\n  \"from_owner\": true,\n  \"mortgage_possible\": true,\n  \"not_first_floor\": true,\n  \"with_balcony\": true,\n  \"with_loggia\": true,\n  \"with_video\": true,\n  \"with_photo\": true,\n  \"sort\": \"default\"\n}"

response = http.request(request)
puts response.read_body

[
  {
    "id": 123,
    "@type": "CianOffer",
    "url": "<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": [],
    "image": "<string>",
    "images": [],
    "published_at": 123,
    "created_at": "<string>",
    "edited_at": "<string>",
    "newbuilding": {
      "name": "<string>",
      "@type": "CianNewbuildingRef",
      "id": 123,
      "url": "<string>",
      "deadline_year": 123,
      "deadline_quarter": "<string>",
      "is_finished": true
    },
    "seller": {
      "@type": "CianSeller",
      "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": []
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

/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

⚠️ 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"
}
'

import requests

url = "https://api.anysite.io/api/cian/offers/search"

payload = {
    "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"
}
headers = {
    "access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.anysite.io/api/cian/offers/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anysite.io/api/cian/offers/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anysite.io/api/cian/offers/search"

	payload := strings.NewReader("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"region\": 1,\n  \"deal_type\": \"sale\",\n  \"offer_type\": \"flat\",\n  \"only_newbuilding\": true,\n  \"rooms\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_total_area\": 1,\n  \"max_total_area\": 1,\n  \"min_living_area\": 1,\n  \"max_living_area\": 1,\n  \"min_kitchen_area\": 1,\n  \"max_kitchen_area\": 1,\n  \"min_floor\": 1,\n  \"max_floor\": 1,\n  \"min_floors_count\": 1,\n  \"max_floors_count\": 1,\n  \"min_ceiling_height\": 1,\n  \"min_build_year\": 1,\n  \"max_build_year\": 1,\n  \"house_material\": [],\n  \"repair\": [],\n  \"max_metro_time\": 1,\n  \"from_developer\": true,\n  \"from_owner\": true,\n  \"mortgage_possible\": true,\n  \"not_first_floor\": true,\n  \"with_balcony\": true,\n  \"with_loggia\": true,\n  \"with_video\": true,\n  \"with_photo\": true,\n  \"sort\": \"default\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/cian/offers/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"region\": 1,\n  \"deal_type\": \"sale\",\n  \"offer_type\": \"flat\",\n  \"only_newbuilding\": true,\n  \"rooms\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_total_area\": 1,\n  \"max_total_area\": 1,\n  \"min_living_area\": 1,\n  \"max_living_area\": 1,\n  \"min_kitchen_area\": 1,\n  \"max_kitchen_area\": 1,\n  \"min_floor\": 1,\n  \"max_floor\": 1,\n  \"min_floors_count\": 1,\n  \"max_floors_count\": 1,\n  \"min_ceiling_height\": 1,\n  \"min_build_year\": 1,\n  \"max_build_year\": 1,\n  \"house_material\": [],\n  \"repair\": [],\n  \"max_metro_time\": 1,\n  \"from_developer\": true,\n  \"from_owner\": true,\n  \"mortgage_possible\": true,\n  \"not_first_floor\": true,\n  \"with_balcony\": true,\n  \"with_loggia\": true,\n  \"with_video\": true,\n  \"with_photo\": true,\n  \"sort\": \"default\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/cian/offers/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"region\": 1,\n  \"deal_type\": \"sale\",\n  \"offer_type\": \"flat\",\n  \"only_newbuilding\": true,\n  \"rooms\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_total_area\": 1,\n  \"max_total_area\": 1,\n  \"min_living_area\": 1,\n  \"max_living_area\": 1,\n  \"min_kitchen_area\": 1,\n  \"max_kitchen_area\": 1,\n  \"min_floor\": 1,\n  \"max_floor\": 1,\n  \"min_floors_count\": 1,\n  \"max_floors_count\": 1,\n  \"min_ceiling_height\": 1,\n  \"min_build_year\": 1,\n  \"max_build_year\": 1,\n  \"house_material\": [],\n  \"repair\": [],\n  \"max_metro_time\": 1,\n  \"from_developer\": true,\n  \"from_owner\": true,\n  \"mortgage_possible\": true,\n  \"not_first_floor\": true,\n  \"with_balcony\": true,\n  \"with_loggia\": true,\n  \"with_video\": true,\n  \"with_photo\": true,\n  \"sort\": \"default\"\n}"

response = http.request(request)
puts response.read_body

[
  {
    "id": 123,
    "@type": "CianOffer",
    "url": "<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": [],
    "image": "<string>",
    "images": [],
    "published_at": 123,
    "created_at": "<string>",
    "edited_at": "<string>",
    "newbuilding": {
      "name": "<string>",
      "@type": "CianNewbuildingRef",
      "id": 123,
      "url": "<string>",
      "deadline_year": 123,
      "deadline_quarter": "<string>",
      "is_finished": true
    },
    "seller": {
      "@type": "CianSeller",
      "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": []
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

count

integer

required

Required range: x >= 1

timeout

integer

default:300

Required range: 20 <= x <= 1500

region

integer

default:1

deal_type

enum<string>

default:sale

Available options:

sale,

rent,

rent_daily

offer_type

enum<string>

default:flat

Available options:

flat,

room,

house,

house_part,

townhouse,

land,

commercial,

garage

only_newbuilding

boolean | null

rooms

enum<string>[] | null

Available options:

studio,

1,

2,

3,

4,

5,

6+,

free_layout

min_price

integer | null

Required range: x >= 0

max_price

integer | null

Required range: x >= 0

min_total_area

number | null

Required range: x >= 0

max_total_area

number | null

Required range: x >= 0

min_living_area

number | null

Required range: x >= 0

max_living_area

number | null

Required range: x >= 0

min_kitchen_area

number | null

Required range: x >= 0

max_kitchen_area

number | null

Required range: x >= 0

min_floor

integer | null

Required range: x >= 0

max_floor

integer | null

Required range: x >= 0

min_floors_count

integer | null

Required range: x >= 0

max_floors_count

integer | null

Required range: x >= 0

min_ceiling_height

number | null

Required range: x >= 0

min_build_year

integer | null

Required range: x >= 0

max_build_year

integer | null

Required range: x >= 0

house_material

enum<string>[] | null

Available options:

brick,

monolith,

panel,

block,

wood,

stalin,

shield,

brick_monolith,

wireframe,

aerocrete_block,

gas_silicate_block

repair

enum<string>[] | null

Available options:

without,

cosmetic,

euro,

design

metro_transport

enum<string> | null

Available options:

walk,

transport

max_metro_time

integer | null

Required range: x >= 0

from_developer

boolean | null

from_owner

boolean | null

mortgage_possible

boolean | null

not_first_floor

boolean | null

with_balcony

boolean | null

with_loggia

boolean | null

with_video

boolean | null

with_photo

boolean | null

sort

enum<string>

default:default

Available options:

default,

price_asc,

price_desc,

area,

metro_time,

street,

date_desc,

date_asc

Response

Successful Response

integer

required

@type

string

default:CianOffer

url

string | null

deal_type

string | null

offer_type

string | null

Token

Ad transparency

App stores

Books

Company & startup intel

Company registries

Compliance & sanctions

Crypto & DeFi

Developer & data

Domains & OSINT

E-commerce & marketplaces

Education & courses

Events & tickets

Finance & markets

Games

Gov & public sector

Jobs

Legal

Local & places

Movies & TV

Music

News & publishing

Package registries

Price comparison

Professional network

Real estate

Research papers

Reviews — consumer & business

Reviews — software & employer

Social media

Travel & hospitality

Utility

Web search

/cian/offers/search

Authorizations

Headers

Body

Response