realty.yandex.ru

GetOffersData

Получает подробные данные по списку объявлений: характеристики, описание, фотографии, планировки и другие доступные сведения. Используй для изучения или сравнения конкретных объявлений. Передавай offer_ids — массив строковых ID объявлений (не более 20 за один вызов). Бери ID из result.response.topOfferIds ответа search, из ссылок на объявления /offer/ / на странице или из ссылок пользователя. Не придумывай ID и не подставляй вместо них ID ЖК, гео-объектов или AI-фильтра. Не преобразовывай ID в числа: это может привести к потере точности. Возвращает полный ответ GetOffersData без изменения структуры: - При result.$case = "response" в result.response.offersData находится массив Markdown-текстов с подробностями объявлений. - При result.$case = "emptyResponse" сообщение находится в result.emptyResponse.message. Страницу не меняет. Для поиска объявлений по условиям используй search.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "offer_ids": {
      "description": "ID объявлений из ссылок /offer/<id>/. Передавай строками, без преобразования в число.",
      "items": {
        "pattern": "^[1-9][0-9]{0,19}$",
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    }
  },
  "required": [
    "offer_ids"
  ],
  "type": "object"
}