Skip to main content
POST
/
api
/
yandexrealty
/
offers
/yandexrealty/offers
curl --request POST \
  --url https://api.anysite.io/api/yandexrealty/offers \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "offer": "<string>",
  "timeout": 300
}
'
[
  {
    "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
offer
string
required

Yandex Realty offer id or an offer URL containing it

Minimum string length: 1
Examples:

"7035113340557150178"

"https://realty.yandex.ru/offer/7035113340557150178/"

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

id
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
metro_list
YandexrealtyMetro · 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
YandexrealtyOfferAuthor · object
price_history
YandexrealtyPricePoint · object[]