/yandexrealty/offers/search

curl --request POST \
  --url https://api.anysite.io/api/yandexrealty/offers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "region": "<string>",
  "count": 2,
  "timeout": 300,
  "deal_type": "kupit",
  "property_type": "kvartira",
  "price_min": 1,
  "price_max": 1,
  "area_min": 1,
  "area_max": 1,
  "living_space_min": 1,
  "living_space_max": 1,
  "kitchen_space_min": 1,
  "floor_min": 1,
  "floor_max": 1,
  "not_first_floor": true,
  "not_last_floor": true,
  "built_year_min": 1,
  "built_year_max": 1,
  "ceiling_height_min": 1,
  "metro_id": 1,
  "has_balcony": true,
  "has_parking": true,
  "has_furniture": true,
  "no_agent_fee": true,
  "no_commission": true,
  "has_photo": true,
  "has_virtual_tour": true,
  "sort": "RELEVANCE"
}
'

[
  {
    "id": "<string>",
    "@type": "@yandexrealty_offer",
    "url": "<string>",
    "offer_type": "<string>",
    "offer_category": "<string>",
    "flat_type": "<string>",
    "deal_status": "<string>",
    "trust": "<string>",
    "description": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "price": 123,
    "price_per_meter": 123,
    "currency": "<string>",
    "price_trend": "<string>",
    "rooms_total": 123,
    "area": 123,
    "living_space": 123,
    "kitchen_space": 123,
    "room_spaces": [],
    "ceiling_height": 123,
    "floor": 123,
    "floors_total": 123,
    "renovation": "<string>",
    "bathroom_unit": "<string>",
    "balcony_type": "<string>",
    "window_view": "<string>",
    "is_apartments": true,
    "is_open_plan": true,
    "is_new_building": true,
    "is_exclusive": true,
    "built_year": 123,
    "building_type": "<string>",
    "building_series": "<string>",
    "building_id": "<string>",
    "flats_count": 123,
    "porches_count": 123,
    "parking_type": "<string>",
    "address": "<string>",
    "latitude": 123,
    "longitude": 123,
    "metro": {
      "name": "<string>",
      "@type": "@yandexrealty_metro",
      "transport": "<string>",
      "time_to_metro": 123,
      "line_color": "<string>"
    },
    "metro_list": [],
    "rgid": 123,
    "view_count": 123,
    "has_lift": true,
    "has_rubbish_chute": true,
    "is_guarded": true,
    "has_security": true,
    "has_internet": true,
    "image": "<string>",
    "images": [],
    "image_count": 123,
    "tags": [],
    "author": {
      "@type": "@yandexrealty_offer_author",
      "id": "<string>",
      "category": "<string>",
      "name": "<string>",
      "organization": "<string>",
      "agent_name": "<string>",
      "image": "<string>",
      "created_at": "<string>"
    },
    "price_history": []
  }
]

/yandexrealty

/yandexrealty/offers/search

Search Yandex Realty offers (listings) in a region by deal type (buy/rent/daily rent), property type (apartment/room/house/lot/garage/commercial), market (secondary/new building) and a full set of real estate filters: rooms, price, total/living/kitchen area, floor, building year, ceiling height, wall material, renovation, decoration, bathroom layout, building class, metro, balcony, parking, furniture, no agent fee / no commission (rentals), photos and virtual tour. Returns offer cards with price, area, rooms, floor, address, metro, photos, tags and the seller.

Price: 20 credits per 20 results

💡 AI Hint: Search Yandex Realty offers. region is the site region slug (‘moskva’, ‘sankt-peterburg’, ‘moskva_i_moskovskaya_oblast’); deal_type selects buy/rent/daily rent; property_type selects the object kind; market (secondary/new building) applies to apartments; rooms, price_min/max, area_min/max, living_space_min/max, kitchen_space_min, floor_min/max, not_first_floor, not_last_floor, built_year_min/max, ceiling_height_min, building_type, renovation, decoration, bathroom_unit, building_class, metro_id, has_balcony, has_parking, has_furniture, no_agent_fee, no_commission, has_photo, has_virtual_tour and sort are optional filters. Each result has the same fields as the offer get-by-id endpoint (id, url, price, area, rooms_total, floor, address, metro, images, tags, author, etc).

⚠️ Common errors: 412: Region not found or no offers match the given region/filters

POST

api

yandexrealty

offers

/yandexrealty/offers/search

curl --request POST \
  --url https://api.anysite.io/api/yandexrealty/offers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "region": "<string>",
  "count": 2,
  "timeout": 300,
  "deal_type": "kupit",
  "property_type": "kvartira",
  "price_min": 1,
  "price_max": 1,
  "area_min": 1,
  "area_max": 1,
  "living_space_min": 1,
  "living_space_max": 1,
  "kitchen_space_min": 1,
  "floor_min": 1,
  "floor_max": 1,
  "not_first_floor": true,
  "not_last_floor": true,
  "built_year_min": 1,
  "built_year_max": 1,
  "ceiling_height_min": 1,
  "metro_id": 1,
  "has_balcony": true,
  "has_parking": true,
  "has_furniture": true,
  "no_agent_fee": true,
  "no_commission": true,
  "has_photo": true,
  "has_virtual_tour": true,
  "sort": "RELEVANCE"
}
'

[
  {
    "id": "<string>",
    "@type": "@yandexrealty_offer",
    "url": "<string>",
    "offer_type": "<string>",
    "offer_category": "<string>",
    "flat_type": "<string>",
    "deal_status": "<string>",
    "trust": "<string>",
    "description": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "price": 123,
    "price_per_meter": 123,
    "currency": "<string>",
    "price_trend": "<string>",
    "rooms_total": 123,
    "area": 123,
    "living_space": 123,
    "kitchen_space": 123,
    "room_spaces": [],
    "ceiling_height": 123,
    "floor": 123,
    "floors_total": 123,
    "renovation": "<string>",
    "bathroom_unit": "<string>",
    "balcony_type": "<string>",
    "window_view": "<string>",
    "is_apartments": true,
    "is_open_plan": true,
    "is_new_building": true,
    "is_exclusive": true,
    "built_year": 123,
    "building_type": "<string>",
    "building_series": "<string>",
    "building_id": "<string>",
    "flats_count": 123,
    "porches_count": 123,
    "parking_type": "<string>",
    "address": "<string>",
    "latitude": 123,
    "longitude": 123,
    "metro": {
      "name": "<string>",
      "@type": "@yandexrealty_metro",
      "transport": "<string>",
      "time_to_metro": 123,
      "line_color": "<string>"
    },
    "metro_list": [],
    "rgid": 123,
    "view_count": 123,
    "has_lift": true,
    "has_rubbish_chute": true,
    "is_guarded": true,
    "has_security": true,
    "has_internet": true,
    "image": "<string>",
    "images": [],
    "image_count": 123,
    "tags": [],
    "author": {
      "@type": "@yandexrealty_offer_author",
      "id": "<string>",
      "category": "<string>",
      "name": "<string>",
      "organization": "<string>",
      "agent_name": "<string>",
      "image": "<string>",
      "created_at": "<string>"
    },
    "price_history": []
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

region

string

required

Region path slug as used on the site, e.g. 'moskva', 'sankt-peterburg', 'moskva_i_moskovskaya_oblast'

Minimum string length: 1

Examples:

"moskva"

"sankt-peterburg"

"moskva_i_moskovskaya_oblast"

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

deal_type

enum<string>

default:kupit

Deal type

Available options:

kupit,

snyat,

snyat/posutochno

property_type

enum<string>

default:kvartira

Property type

Available options:

kvartira,

komnata,

dom,

uchastok,

garazh,

kommercheskaya-nedvizhimost

market

enum<string> | null

Market type for apartments (secondary or new building)

Available options:

vtorichniy-rynok,

novostroyki

rooms

enum<string> | null

Number of rooms

Available options:

STUDIO,

1,

2,

3,

PLUS_4

price_min

integer | null

Minimum price

Required range: x >= 0

price_max

integer | null

Maximum price

Required range: x >= 0

area_min

number | null

Minimum total area in square meters

Required range: x >= 0

area_max

number | null

Maximum total area in square meters

Required range: x >= 0

living_space_min

number | null

Minimum living area in square meters

Required range: x >= 0

living_space_max

number | null

Maximum living area in square meters

Required range: x >= 0

kitchen_space_min

number | null

Minimum kitchen area in square meters

Required range: x >= 0

floor_min

integer | null

Minimum floor

Required range: x >= 0

floor_max

integer | null

Maximum floor

Required range: x >= 0

not_first_floor

boolean | null

Exclude first floor offers

not_last_floor

boolean | null

Exclude last floor offers

built_year_min

integer | null

Minimum building construction year

Required range: x >= 0

built_year_max

integer | null

Maximum building construction year

Required range: x >= 0

ceiling_height_min

number | null

Minimum ceiling height in meters

Required range: x >= 0

building_type

enum<string> | null

Building wall material

Available options:

BRICK,

MONOLIT,

PANEL,

BLOCK,

MONOLIT_BRICK,

WOOD,

FERROCONCRETE,

STALIN

renovation

enum<string> | null

Renovation / finishing state

Available options:

COSMETIC_DONE,

DESIGNER_RENOVATION,

EURO,

NEEDS_RENOVATION,

NON_GRANDMOTHER,

GRANDMOTHER,

PRIMARY_FINISHING,

ROUGH

decoration

enum<string> | null

New building decoration / finishing level

Available options:

ROUGH,

CLEAN,

TURNKEY,

NO_DECORATION,

PRE_CLEAN,

WHITE_BOX

bathroom_unit

enum<string> | null

Bathroom layout

Available options:

MATCHED,

SEPARATED,

TWO_AND_MORE

building_class

enum<string> | null

Building class (for new buildings)

Available options:

ECONOM,

COMFORT,

COMFORT_PLUS,

BUSINESS,

ELITE

metro_id

integer | null

Metro station geo id to search near

Required range: x >= 0

has_balcony

boolean | null

Only offers with a balcony or loggia

has_parking

boolean | null

Only offers with parking

has_furniture

boolean | null

Only rentals with furniture

no_agent_fee

boolean | null

Only rentals without an agent fee

no_commission

boolean | null

Only rentals without a commission

has_photo

boolean | null

Only offers with photos

has_virtual_tour

boolean | null

Only offers with a 3D virtual tour

sort

enum<string>

default:RELEVANCE

Result sort order

Available options:

RELEVANCE,

PRICE,

PRICE_DESC,

PRICE_PER_SQUARE,

AREA,

AREA_DESC,

DATE_DESC,

FLOOR,

FLOOR_DESC

Response

Successful Response

string

required

@type

string

default:@yandexrealty_offer

url

string | null

offer_type

string | null

offer_category

string | null

flat_type

string | null

deal_status

string | null

trust

string | null

description

string | null

created_at

string | null

updated_at

string | null

price

integer | null

price_per_meter

integer | null

currency

string | null

price_trend

string | null

rooms_total

integer | null

area

number | null

living_space

number | null

kitchen_space

number | null

room_spaces

number[]

ceiling_height

number | null

floor

integer | null

floors_total

integer | null

renovation

string | null

bathroom_unit

string | null

balcony_type

string | null

window_view

string | null

is_apartments

boolean | null

is_open_plan

boolean | null

is_new_building

boolean | null

is_exclusive

boolean | null

built_year

integer | null

building_type

string | null

building_series

string | null

building_id

string | null

flats_count

integer | null

porches_count

integer | null

parking_type

string | null

address

string | null

latitude

number | null

longitude

number | null

metro

YandexrealtyMetro · object

Show child attributes

metro_list

YandexrealtyMetro · object[]

Show child attributes

rgid

integer | null

view_count

integer | null

has_lift

boolean | null

has_rubbish_chute

boolean | null

is_guarded

boolean | null

has_security

boolean | null

has_internet

boolean | null

image

string | null

images

string[]

image_count

integer | null