/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": []
  }
]

/yandexrealty

/yandexrealty/offers

Get full Yandex Realty offer (listing) details by offer id or offer URL: deal type, property category, price and price per square meter, rooms, total/living/kitchen area, room areas, floor, ceiling height, renovation, bathroom, balcony, window view, building year/type/series, address, coordinates, nearby metro stations, photos, tags, the seller (agency/agent) and the price history.

Price: 20 credits

💡 AI Hint: Fetch a single Yandex Realty offer by numeric offer id or an offer URL. Returns one item with id, url, offer_type (SELL/RENT), offer_category (APARTMENT/ROOMS/HOUSE/LOT/GARAGE/COMMERCIAL), flat_type, deal_status, description, created_at, updated_at, price (numeric), price_per_meter, currency, price_trend, rooms_total, area, living_space, kitchen_space, room_spaces, ceiling_height, floor, floors_total, renovation, bathroom_unit, balcony_type, window_view, is_apartments, is_open_plan, is_new_building, is_exclusive, built_year, building_type, building_series, flats_count, porches_count, parking_type, has_lift, has_rubbish_chute, is_guarded, has_security, has_internet, address, latitude, longitude, metro, metro_list (name, transport, time_to_metro, line_color), rgid, view_count, image, images, image_count, tags, author (id, category, name, organization, agent_name, image) and price_history (date, value).

⚠️ Common errors: 412: Offer not found, expired or removed (well-formed but nonexistent/withdrawn offer id)

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

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