Skip to main content
POST
/
api
/
domclick
/
offers
/
search
/domclick/offers/search
curl --request POST \
  --url https://api.anysite.io/api/domclick/offers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "region": "<string>",
  "count": 2,
  "timeout": 300,
  "deal_type": "sale",
  "category": "living",
  "offer_type": [],
  "rooms": [],
  "min_price": 1,
  "max_price": 1,
  "min_area": 1,
  "max_area": 1,
  "min_room_area": 1,
  "max_room_area": 1,
  "min_land_area": 1,
  "max_land_area": 1,
  "min_floor": 1,
  "max_floor": 1,
  "min_floors": 1,
  "max_floors": 1,
  "not_first_floor": true,
  "not_last_floor": true,
  "last_floor": true,
  "min_kitchen_area": 1,
  "min_ceiling_height": 1,
  "renovation": [],
  "wall_type": [],
  "building_class": [],
  "min_build_year": 1,
  "max_build_year": 1,
  "is_apartment": true,
  "with_balcony": true,
  "with_separated_bathroom": true,
  "with_connected_bathroom": true,
  "with_lifts": true,
  "with_freight_lifts": true,
  "sell_type": [],
  "from_owner": true,
  "from_developer": true,
  "from_agents": true,
  "rosreestr_approved": true,
  "exclude_auction": true,
  "only_newbuilding": true,
  "with_video": true,
  "with_photo": true,
  "online_show": true,
  "max_metro_time_on_foot": 1,
  "max_metro_time_by_car": 1,
  "min_mkad_distance": 1,
  "max_mkad_distance": 1,
  "no_commission": true,
  "no_deposit": true,
  "with_children": true,
  "with_animals": true,
  "amenities": [],
  "include_keywords": "<string>",
  "exclude_keywords": "<string>",
  "sort": "qi",
  "sort_dir": "desc"
}
'
[
  {
    "id": 123,
    "@type": "@domclick_offer",
    "url": "<string>",
    "deal_type": "<string>",
    "offer_type": "<string>",
    "price": 123,
    "square_price": 123,
    "monthly_payment": 123,
    "has_discount": true,
    "discount_value": 123,
    "area": 123,
    "rooms": 123,
    "floor": 123,
    "floors": 123,
    "is_apartment": true,
    "build_year": 123,
    "address": "<string>",
    "latitude": 123,
    "longitude": 123,
    "description": "<string>",
    "image": "<string>",
    "images": [],
    "subways": [],
    "complex": {
      "id": 123,
      "@type": "@domclick_offer_complex",
      "name": "<string>",
      "alias": "<string>",
      "building_id": 123,
      "end_build_year": 123,
      "end_build_quarter": 123
    },
    "developer_name": "<string>",
    "developer_image": "<string>",
    "seller": {
      "@type": "@domclick_offer_seller",
      "name": "<string>",
      "is_agent": true,
      "is_agency": true,
      "is_owner": true,
      "is_sbol_verified": true,
      "agent_cas_id": 123,
      "agent_name": "<string>",
      "agent_image": "<string>",
      "agent_experience": "<string>",
      "company_id": 123,
      "company_name": "<string>",
      "company_logo": "<string>",
      "company_experience": "<string>"
    },
    "is_owner": true,
    "is_rosreestr_approved": true,
    "has_video": true,
    "duplicates_offer_count": 123,
    "published_at": "<string>",
    "updated_at": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
region
string
required

Region/area/district/metro GUID or numeric area id (aid) to search within.

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:sale

Deal type.

Available options:
sale,
rent
category
enum<string>
default:living

Property category.

Available options:
living,
living_house,
commercial,
garage
offer_type
enum<string>[] | null

Restrict to these property types (multiple allowed).

Available options:
flat,
layout,
room,
complex,
house,
house_part,
townhouse,
land
rooms
enum<string>[] | null

Restrict to these room layouts (multiple allowed).

Available options:
st,
1,
2,
3,
4,
5+
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_area
number | null

Minimum total area (m²).

Required range: x >= 0
max_area
number | null

Maximum total area (m²).

Required range: x >= 0
min_room_area
number | null

Minimum room area (m²); for rooms.

Required range: x >= 0
max_room_area
number | null

Maximum room area (m²); for rooms.

Required range: x >= 0
min_land_area
number | null

Minimum land plot area (sotka).

Required range: x >= 0
max_land_area
number | null

Maximum land plot area (sotka).

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
integer | null

Minimum number of floors in the building.

Required range: x >= 0
max_floors
integer | null

Maximum number of floors in the building.

Required range: x >= 0
not_first_floor
boolean | null

Exclude offers on the first floor.

not_last_floor
boolean | null

Exclude offers on the last floor.

last_floor
boolean | null

Only offers on the last floor.

min_kitchen_area
number | null

Minimum kitchen area (m²).

Required range: x >= 0
min_ceiling_height
number | null

Minimum ceiling height (m).

Required range: x >= 0
renovation
enum<string>[] | null

Restrict to these renovation states (multiple allowed).

Available options:
without_repair,
standard,
well_done,
design
wall_type
enum<string>[] | null

Restrict to these building wall materials (multiple allowed).

Available options:
monolith,
brick_monolith,
brick,
panel,
block
building_class
enum<string>[] | null

Restrict to these building classes (multiple allowed).

Available options:
economy,
comfort,
business,
elite
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
is_apartment
boolean | null

Filter apartments (true) or regular flats (false).

with_balcony
boolean | null

Only offers that have a balcony.

with_separated_bathroom
boolean | null

Only offers with a separated bathroom.

with_connected_bathroom
boolean | null

Only offers with a connected bathroom.

with_lifts
boolean | null

Only offers in buildings with a lift.

with_freight_lifts
boolean | null

Only offers in buildings with a freight lift.

window_view
enum<string> | null

Restrict to this window view.

Available options:
garden,
park,
water,
forest,
street
sell_type
enum<string>[] | null

Restrict to these sale types (multiple allowed).

Available options:
free_sale,
alternative
from_owner
boolean | null

Only offers listed directly by the owner.

from_developer
boolean | null

Only offers listed by the developer.

from_agents
boolean | null

Only offers listed by agents or private sellers.

rosreestr_approved
boolean | null

Only offers verified by Rosreestr.

exclude_auction
boolean | null

Exclude auction offers.

only_newbuilding
boolean | null

Only new-build (primary market) offers.

published_filter
enum<string> | null

Only offers published within this time window.

Available options:
hour,
today,
24h,
10d,
30d
with_video
boolean | null

Only offers that include a video.

with_photo
boolean | null

Only offers that have photos.

online_show
boolean | null

Only offers that support an online showing.

max_metro_time_on_foot
integer | null

Maximum walking time to metro (minutes).

Required range: x >= 0
max_metro_time_by_car
integer | null

Maximum driving time to metro (minutes).

Required range: x >= 0
min_mkad_distance
integer | null

Minimum distance from the MKAD (km).

Required range: x >= 0
max_mkad_distance
integer | null

Maximum distance from the MKAD (km).

Required range: x >= 0
no_commission
boolean | null

Only rentals without an agent commission.

no_deposit
boolean | null

Only rentals without a security deposit.

with_children
boolean | null

Only rentals that allow children.

with_animals
boolean | null

Only rentals that allow pets.

amenities
enum<string>[] | null

Only rentals with these amenities (multiple allowed).

Available options:
internet,
living_furniture,
kitchen_furniture,
refrigerator,
tv,
dish_washer,
conditioner
include_keywords
string | null

Only offers whose description contains this text.

exclude_keywords
string | null

Exclude offers whose description contains this text.

sort
enum<string>
default:qi

Result ordering.

Available options:
qi,
price,
area,
published
sort_dir
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Response

Successful Response

id
integer
required
@type
string
default:@domclick_offer
url
string | null
deal_type
string | null
offer_type
string | null
price
integer | null
square_price
integer | null
monthly_payment
integer | null
has_discount
boolean | null
discount_value
number | null
area
number | null
rooms
integer | null
floor
integer | null
floors
integer | null
is_apartment
boolean | null
build_year
integer | null
address
string | null
latitude
number | null
longitude
number | null
description
string | null
image
string | null
images
string[]
subways
DomclickSubway · object[]
complex
DomclickOfferComplex · object
developer_name
string | null
developer_image
string | null
seller
DomclickOfferSeller · object
is_owner
boolean | null
is_rosreestr_approved
boolean | null
has_video
boolean | null
duplicates_offer_count
integer | null
published_at
string | null
updated_at
string | null