Skip to main content
POST
/yandexrealty/offers/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
region
string
required
Minimum string length: 1
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
deal_type
enum<string>
default:kupit
Available options:
kupit,
snyat,
snyat/posutochno
property_type
enum<string>
default:kvartira
Available options:
kvartira,
komnata,
dom,
uchastok,
garazh,
kommercheskaya-nedvizhimost
market
enum<string> | null
Available options:
vtorichniy-rynok,
novostroyki
rooms
enum<string> | null
Available options:
STUDIO,
1,
2,
3,
PLUS_4
price_min
integer | null
Required range: x >= 0
price_max
integer | null
Required range: x >= 0
area_min
number | null
Required range: x >= 0
area_max
number | null
Required range: x >= 0
living_space_min
number | null
Required range: x >= 0
living_space_max
number | null
Required range: x >= 0
kitchen_space_min
number | null
Required range: x >= 0
floor_min
integer | null
Required range: x >= 0
floor_max
integer | null
Required range: x >= 0
not_first_floor
boolean | null
not_last_floor
boolean | null
built_year_min
integer | null
Required range: x >= 0
built_year_max
integer | null
Required range: x >= 0
ceiling_height_min
number | null
Required range: x >= 0
building_type
enum<string> | null
Available options:
BRICK,
MONOLIT,
PANEL,
BLOCK,
MONOLIT_BRICK,
WOOD,
FERROCONCRETE,
STALIN
renovation
enum<string> | null
Available options:
COSMETIC_DONE,
DESIGNER_RENOVATION,
EURO,
NEEDS_RENOVATION,
NON_GRANDMOTHER,
GRANDMOTHER,
PRIMARY_FINISHING,
ROUGH
decoration
enum<string> | null
Available options:
ROUGH,
CLEAN,
TURNKEY,
NO_DECORATION,
PRE_CLEAN,
WHITE_BOX
bathroom_unit
enum<string> | null
Available options:
MATCHED,
SEPARATED,
TWO_AND_MORE
building_class
enum<string> | null
Available options:
ECONOM,
COMFORT,
COMFORT_PLUS,
BUSINESS,
ELITE
metro_id
integer | null
Required range: x >= 0
has_balcony
boolean | null
has_parking
boolean | null
has_furniture
boolean | null
no_agent_fee
boolean | null
no_commission
boolean | null
has_photo
boolean | null
has_virtual_tour
boolean | null
sort
enum<string>
default:RELEVANCE
Available options:
RELEVANCE,
PRICE,
PRICE_DESC,
PRICE_PER_SQUARE,
AREA,
AREA_DESC,
DATE_DESC,
FLOOR,
FLOOR_DESC

Response

Successful Response

id
string
required
@type
string
default:YandexrealtyOffer
url
string | null
offer_type
string | null
offer_category
string | null
flat_type
string | null
deal_status
string | null
trust
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
object | null
metro_list
object[]
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
tags
string[]
author
object | null
price_history
object[]