registration
logo ®
Your desires are our goal.
Search
Tariffs
FAQ
Partners
API
About us
Contacts
Home Search Login

Documentation API

API Terms of Use

Content

1. Authentication

To access protected data, use the authorization token in the header.:

Authorization: Bearer YOUR_API_TOKEN
Content-Type: multipart/form-data

2. Rate Limiting

Maximum number of requests per minute: 20.

3. Safety

  • Use HTTPS for all requests.
  • Tokens are stored in encrypted form.

4. Error Handling

Code Name Description
200 OK The request was completed successfully and the data was returned.
201 Created POST-The request was completed successfully, the record was created.
401 Unauthorized The token is missing, expired, or invalid.
403 Forbidden No rights to access the resource.
404 Not found The requested resource does not exist (e.g. a non-existent property).
422 Validation error The request data was not validated (e.g., invalid form fields).
429 Too many requests Request limit exceeded (>60/min with token).
500 Internal Server Error Server-side error. Please check the logs or try your request again later.

Sample answers

401 Unauthorized:

{
    "success": false,
    "message": "The token is missing, expired, or invalid",
    "error": "Unauthenticated"
}

403 Forbidden:

{
    "success": false,
    "message": "No rights to access the resource",
    "error": "Forbidden"
}

404 Not found:

{
    "success": false,
    "message": "Object not found",
    "error": "Record not found"
}

422 Validation error:

{
    "success": false,
    "message": "Data validation error",
    "errors": {
        "title": ["This field is required"],
        "price": ["The price must be a number"]
    },
    "error": "Unprocessable Entity"
}

429 Too many requests:

{
    "success": false,
    "message": "Request limit exceeded. Please try again in 10 seconds.",
    "error": "Too Many Requests"
}

500 Внутренняя ошибка:

{
    "success": false,
    "message": "A server error occurred",
    "error": "Internal Server Error"
}

Tips for handling errors:

  • For 401: Check the token and its expiration date.
  • For 403: Make sure the user has access rights.
  • For 404: Check the object ID.
  • For 422: Please refine your request details (e.g. field validation).
  • For 429: Use Retry-After header for repeated requests.
  • For 500: Свяжитесь с администратором или проверьте логи сервера.

5.1 Поиск объявлений

URL: GET https://dvaugla.ru/api/v1/ads

Возвращает список всех объектов недвижимости с возможностью фильтрации и пагинации.

Параметры запроса

Параметр Тип Описание
page integer Номер страницы для пагинации.
per_page integer (5-100) Количество объектов на странице. По умолчанию: 25.
user_id string (255) id авторов объявления. Можно указать сразу нескольких авторов через запятую. Для отображения собственных объявлений можно указать параметр: my_id. По умолчанию возвращаются объявления всех авторов.
type string (255) Тип объекта. Доступны значения: Flat House Parking space Storeroom Garage Territory Office . Можно указать сразу несколько значений через запятую.
action string (255) Операция с объектом. Доступны значения: Sell For rent Exchange Donate . Можно указать сразу несколько значений через запятую.
material string (255) Материал стен: not specified Brick Monolithic Panel Wooden Block Tin other . Можно указать сразу несколько значений через запятую.
tariff string (255) Тарифный план. Доступны значения: Free Premium Можно указать сразу несколько значений через запятую.
state string (255) Статус объявления на сайте. Доступны значения: Active Draft Completed . Можно указать сразу несколько значений через запятую.
period string (255) За какой период оплата. Доступны значения: in total per month per day per hour . Можно указать сразу несколько значений через запятую.
min_price int Минимальная стоимость
max_price int Максимальная стоимость
min_total_area float Минимальная Total area (m²)
max_total_area float Максимальная Total area (m²)
min_floor int Минимальный этаж
max_floor int Максимальный этаж
sort enum Сортировка по полю: type action material tariff state period
order enum Направление сортировки: asc desc

Пример запроса с дополнительными полями

http://127.0.0.1:8000/api/v1/ads?page=1&per_page=5&user_id=my_id,555&material=Монолитный&state=Черновик,Активное&type=Дом,Квартира&tariff=Бесплатный,Премиум&action=Продать,Сдать&period=за всё,за час&min_price=400&max_price=40000000&min_floor=5&max_floor=40&min_total_area=1&max_total_area=100&sort=tariff&order=asc

Параметры ответа

Параметр Тип Описание
success boolean (['true','false']) Успешно ли прошёл запрос все проверки
id string (16) id объявления
type enum Тип объекта: Flat House Parking space Storeroom Garage Territory Office
action enum Операция с объектом: Sell For rent Exchange Donate
material enum Материал стен: not specified Brick Monolithic Panel Wooden Block Tin other
price int Стоимость объекта
period enum За какой период оплата: in total per month per day per hour
tariff enum Тарифный план: Free Premium
floor int Этаж объекта
floors int Этажность объекта
total_area float Total area (m²)
state enum Статус объявления на сайте: Active Draft Completed
description string (255) Description.
total int Общее количество доступных объявлений
per_page int Количество объявлений на странице (default: 25)
current_page int Номер текущей страницы (default: 1)
last_page int Номер последней страницы

Пример ответа:

200 OK 
{
    "success": true,
    "data": [
        {
            "id": "5351020320056653",
            "type": "Квартира",
            "action": "Купить",
            "material": "Монолитный",
            "price": 10000000,
            "period": "за всё",
            "tariff": "Премиум",
            "floor": 5,
            "floors": 10,
            "total_area": 50.25,
            "state": "Активное",
            "description": "Пример описания, указывается тут."
        },
        {
            "id": "9564625179668665",
            "type": "Квартира",
            "action": "Купить",
            "material": "Монолитный",
            "price": 10000000,
            "period": "за всё",
            "tariff": "Премиум",
            "floor": 5,
            "floors": 10,
            "total_area": 50.25,
            "state": "Активное",
            "description": "Пример описания, указывается тут."
        }
    ],
    "meta": {
        "total": 2,
        "per_page": 5,
        "current_page": 1,
        "last_page": 1
    }
}

5.2 Создание нового объявления

URL: POST https://dvaugla.ru/api/v1/ads

Создает новое объявление о недвижимости.

Параметры запроса

Параметр Тип Обязательное Описание
type enum - Тип объекта: Flat House Parking space Storeroom Garage Territory Office
action enum - Операция с объектом: Sell For rent Exchange Donate
apartment enum - Тип помещения: not specified Flat Apartments Комната Доля доступно только для объектов: Flat
room enum - Rooms: not specified Studio 1 2 3 4 5 6 7 and more Open plan layout доступно только для объектов: Flat House Office
latitude float - Object coordinates: (Latitude)*
longitude float - Object coordinates: (Longitude)*
country string (50) - Country. Значение по умолчанию - Россия.
postal string (6) - Индекс*. Значение по умолчанию - null.
city string (100) - City / Settlement*. Например:"г Москва", "деревня Моносеево", "село Ямкино", "дп Загорянский", "тер. СНТ Росинка". Значение по умолчанию - null.
street string (100) - Street. Например:"ул Центральная усадьба", "Ленинградское шоссе". Значение по умолчанию - null.
house string (60) - House or plot number. Например:"д 6А". Значение по умолчанию - null.
block string (60) - Building Structure. Например:"к 3", "стр 10", "к 16А". Значение по умолчанию - null.
flat string (60) - Apartment number. Например:"кв 349". Значение по умолчанию - null.
owner enum - Ownership: Owner Агент other
owner_more string (50) - Право собственности (уточнение). В случае если в параметре: owner - указано значение: other , то в данном параметре можно уточнить отношение к собственности автора объявления.
srok enum - Tenure: not specified less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years more than 5 years
Specifies how long the property has been owned by the owner.
ready date (YYYY-MM-DD) - Date of possible occupancy, transfer of ownership. Значение по умолчанию - сегодня.
year date (YYYY) - Year of build
material enum - Wall material: not specified Brick Monolithic Panel Wooden Block Tin other доступно только для объектов: Flat House Storeroom Garage Office
material_more string (50) - Материал стен (уточнение). В случае если в параметре: material - указано значение: other , то в данном параметре можно уточнить материал объекта.
floor int - Floor
floors int - Floors of the object
elevator enum - Elevator: not specified absent присутствует доступно только для объектов: Flat House Office
elevator_more int - Лифт (уточнение количества). В случае если в параметре: elevator - указано значение: присутствует , то в данном параметре можно уточнить количество лифтов на объекте.
infra[] array (массив enum значений) - Infrastructure: Polyclinic School Kindergarten Subway Park Yard without cars Playgrounds Parking Shopping mall Bank Cafe Pharmacy Sports club Shop Creative studio Салоны красоты Водоём Picnic area
total_area float Yes Total area (m²)
living_area float - Living area (m²), доступно только для объектов: Flat House
kitchen_area float - Kitchen area (m²), доступно только для объектов: Flat House
height float - Ceiling height (m²), доступно только для объектов: Flat House Storeroom Garage Office
remont enum - Renovation: not specified without renovation cosmetic Euro-renovation major other доступно только для объектов: Flat House Storeroom Garage Office
Cosmetic - minor repairs to freshen up the room.

Euro-renovation is a renovation that gives the premises exclusivity and increases functionality.

Major - may include redevelopment, replacement of electrical wiring and utility lines.
remont_more string (50) - Ремонт (уточнение). В случае если в параметре: remont - указано значение: other , то в данном параметре можно уточнить тип ремонта.
bathroom enum - Bathroom: not specified combined separate outside other доступно только для объектов: Flat House Office
bathroom_more string (50) - Санузел (уточнение). В случае если в параметре: bathroom - указано значение: other , то в данном параметре можно уточнить тип cанузла.
balkon enum - Balcony: not specified absent open glazed loggia french other доступно только для объектов: Flat House Office
balkon_more string (50) - Санузел (уточнение). В случае если в параметре: balkon - указано значение: other , то в данном параметре можно уточнить тип балкона.
power enum - Energy efficiency class: not specified A++ A+ A B C D E F G доступно только для объектов: Flat House Office
office_class enum - Office class: not specified A B C D доступно только для объектов: Office
price int Yes Cost, ₽
period enum - Период оплаты: in total per month per day per hour
commission enum - Комиссия агента (дополнительно): no commission % of the cost fixed
Укажите только ту комиссию, которую необходимо оплатить клиенту/покупателю, дополнительно к основной сумме объекта. Если эту комиссию Вы оплачиваете самостоятельно из стоимости объекта, то не надо её указывать.
commission_more float - Комиссия агента (дополнительно). В случае если в параметре: commission - указано значение: % of the cost fixed , то в данном параметре можно уточнить размер комиссии.
Укажите только ту комиссию, которую необходимо оплатить клиенту/покупателю, дополнительно к основной сумме объекта. Если эту комиссию Вы оплачиваете самостоятельно из стоимости объекта, то не надо её указывать.
by_email boolean - Method of communication: через Email
You can add/change your email address for contacts in your profile.
contact_email string - Email. Email автоматически добавится в раздел Контактной информации, если его там не было раньше.
You can add/change your email address for contacts in your profile.
by_phone boolean - Method of communication: по телефону
You can add/change the contact phone number for contacts with you in your profile.
contact_phone string (12) - Номер телефона, формат: +79xxxxxxxxx. Телефон автоматически добавится в раздел Контактной информации, если его там не было раньше.
You can add/change the contact phone number for contacts with you in your profile.
tariff enum Yes Tariff plan: Free Premium
You can publish 1 ad for free.
Paid ads have higher priority and are displayed first in search queries.
description string (2000) - Description. Размер описания определяется в зависимости от выбранного тарифного плана. Возможности тарифных планов описаны на странице: Tariffs. Если поле с описанием длинное чем доступно в выбранном тарифном плане, то описание будет обрезано, согласно параметрам тарифного плана.
htmlurl string - HTML link to external page of the object (available protocols: https): доступно для тарифных планов: Premium
photo[] array (массив фотографий) Yes Photos. Количество фотографий определяется выбранным тарифным планом. Возможности тарифных планов описаны на странице: Tariffs. Фотографии сверх того, что доступно в выбранном тарифном плане - не сохраняются.
state enum - Ad state: Active Draft Completed
Active - such an ad can be found by everyone during a search. Everyone can view the ad, add it to favorites, etc.

Draft - such an ad cannot be found by searching, the ad cannot be viewed by users. Available for viewing and editing - only by the author of the ad. In the section: "Favorites" - not displayed.

Completed - such an ad cannot be found by searching. Previously added ads are displayed to users in the "Favorites" section - with the note: "removed from publication".
days enum Yes На сколько дней размещается объявление: Для тарифа: Free - доступны значения (дни): 14 Для тарифа: Premium - доступны значения (дни): 30 60 90 120 180 360
bid float Yes Bid.
Указывайте всегда размер ставки для минимального периода. Если требуется разместить объявление на более длительный срок - система сама рассчитает финальную стоимость объявления. Для тарифа: Free - не указывается или указывается: 0.00. Для тарифа: Premium - размер минимальной ставки составляет: 17.00 ₽ на минимальный период 1 дней.

Советы по параметрам адреса объекта:

*для определения местоположения объекта в запросе должны присутствовать как минимум - или пара значений: latitude и longitude или пара значений: postal и city.

Если остальные данные адреса не указаны в запросе - портал постарается определить их самостоятельно. При самостоятельном определении адреса порталом - возможны ошибки, поэтому постарайтесь передать как можно больше данных о расположении объекта. Переданные в запросе параметры адреса - является наиболее приоритетными. Если в запросе в параметрах: postal, city, street, house, block, flat - передано значение: null, то портал - не будет определять самостоятельно данные по этому параметру адреса.

Параметры ответа

Если создание объявления было успешно в ответе в заголовок добавляется поле: Location с URL новой записи

Location: https://dvaugla.ru/api/v1/ads/{id}
Параметр Тип Описание
success boolean (['true','false']) Успешно ли прошёл запрос все проверки
id string (16) id объявления
type string (100) Тип объекта: Flat House Parking space Storeroom Garage Territory Office
action string (100) Операция с объектом: Sell For rent Exchange Donate
apartment string (100) Тип помещения: not specified Flat Apartments Комната Доля доступно только для объектов: Flat
room string (100) Rooms: not specified Studio 1 2 3 4 5 6 7 and more Open plan layout доступно только для объектов: Flat House Office
latitude float Object coordinates: (Latitude).
longitude float Object coordinates: (Longitude).
country string (50) Country. Значение по умолчанию - Россия.
postal string (6) Индекс. Значение по умолчанию - null.
city string (100) City / Settlement. Например:"г Москва", "деревня Моносеево", "село Ямкино", "дп Загорянский", "тер. СНТ Росинка". Значение по умолчанию - null.
street string (100) Street. Например:"ул Центральная усадьба", "Ленинградское шоссе". Значение по умолчанию - null.
house string (60) House or plot number. Например:"д 6А". Значение по умолчанию - null.
block string (60) Building Structure. Например:"к 3", "стр 10", "к 16А". Значение по умолчанию - null.
flat string (60) Apartment number. Например:"кв 349". Значение по умолчанию - null.
owner string (100) Ownership: Owner Агент other
owner_more string (50) Право собственности (уточнение). В случае если в параметре: owner - указано значение: other , то в данном параметре можно уточнить отношение к собственности автора объявления. Значение по умолчанию - null.
srok string (100) Tenure: not specified less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years more than 5 years
Specifies how long the property has been owned by the owner.
ready string (YYYY-MM-DD) Date of possible occupancy, transfer of ownership. Значение по умолчанию - сегодня.
year string (YYYY) Year of build
material string (100) Wall material: not specified Brick Monolithic Panel Wooden Block Tin other доступно только для объектов: Flat House Storeroom Garage Office
material_more string (50) Материал стен (уточнение). В случае если в параметре: material - указано значение: other , то в данном параметре можно уточнить материал объекта. Значение по умолчанию - null.
floor string (10) Floor. Значение по умолчанию - null.
floors string (10) Floors of the object. Значение по умолчанию - null.
elevator string (100) Elevator: not specified absent присутствует доступно только для объектов: Flat House Office
elevator_more int Лифт (уточнение количества). В случае если в параметре: elevator - указано значение: присутствует , то в данном параметре можно уточнить количество лифтов на объекте. Значение по умолчанию - null.
infra[] array (массив string значений) Infrastructure: Polyclinic School Kindergarten Subway Park Yard without cars Playgrounds Parking Shopping mall Bank Cafe Pharmacy Sports club Shop Creative studio Салоны красоты Водоём Picnic area
total_area float Total area (m²)
living_area string (10) Living area (m²), доступно только для объектов: Flat House Значение по умолчанию - null.
kitchen_area string (10) Kitchen area (m²), доступно только для объектов: Flat House Значение по умолчанию - null.
height string (10) Ceiling height (m²), доступно только для объектов: Flat House Storeroom Garage Office Значение по умолчанию - null.
remont string (100) Renovation: not specified without renovation cosmetic Euro-renovation major other доступно только для объектов: Flat House Storeroom Garage Office
Cosmetic - minor repairs to freshen up the room.

Euro-renovation is a renovation that gives the premises exclusivity and increases functionality.

Major - may include redevelopment, replacement of electrical wiring and utility lines.
remont_more string (50) Ремонт (уточнение). В случае если в параметре: remont - указано значение: other , то в данном параметре можно уточнить тип ремонта. Значение по умолчанию - null.
bathroom string (100) Bathroom: not specified combined separate outside other доступно только для объектов: Flat House Office
bathroom_more string (50) Санузел (уточнение). В случае если в параметре: bathroom - указано значение: other , то в данном параметре можно уточнить тип cанузла. Значение по умолчанию - null.
balkon string (100) Balcony: not specified absent open glazed loggia french other доступно только для объектов: Flat House Office
balkon_more string (50) Санузел (уточнение). В случае если в параметре: balkon - указано значение: other , то в данном параметре можно уточнить тип балкона. Значение по умолчанию - null.
power string (50) Energy efficiency class: not specified A++ A+ A B C D E F G доступно только для объектов: Flat House Office
office_class string (50) Office class: not specified A B C D доступно только для объектов: Office
price int Cost, ₽
period string (100) Период оплаты: in total per month per day per hour
commission string (100) Комиссия агента (дополнительно): no commission % of the cost fixed
Укажите только ту комиссию, которую необходимо оплатить клиенту/покупателю, дополнительно к основной сумме объекта. Если эту комиссию Вы оплачиваете самостоятельно из стоимости объекта, то не надо её указывать.
commission_more float Комиссия агента (дополнительно). В случае если в параметре: commission - указано значение: % of the cost fixed , то в данном параметре можно уточнить размер комиссии. Значение по умолчанию - 0.
Укажите только ту комиссию, которую необходимо оплатить клиенту/покупателю, дополнительно к основной сумме объекта. Если эту комиссию Вы оплачиваете самостоятельно из стоимости объекта, то не надо её указывать.
by_email boolean Method of communication: через Email. Значение по умолчанию - false.
You can add/change your email address for contacts in your profile.
contact_email string (100) Email. Email автоматически добавится в раздел Контактной информации, если его там не было раньше. Значение по умолчанию - null.
You can add/change your email address for contacts in your profile.
by_phone boolean Method of communication: по телефону. Значение по умолчанию - false.
You can add/change the contact phone number for contacts with you in your profile.
contact_phone string (12) Номер телефона, формат: +79xxxxxxxxx. Телефон автоматически добавится в раздел Контактной информации, если его там не было раньше. Значение по умолчанию - null.
You can add/change the contact phone number for contacts with you in your profile.
tariff string (100) Tariff plan: Free Premium
You can publish 1 ad for free.
Paid ads have higher priority and are displayed first in search queries.
description string (2000) Description. Размер описания определяется в зависимости от выбранного тарифного плана. Возможности тарифных планов описаны на странице: Tariffs. Если поле с описанием длинное чем доступно в выбранном тарифном плане, то описание будет обрезано, согласно параметрам тарифного плана. Значение по умолчанию - null.
htmlurl string (255) HTML link to external page of the object (available protocols: https): доступно для тарифных планов: Premium Значение по умолчанию - null.
photo[] array (массив фотографий) Photos. Количество фотографий определяется выбранным тарифным планом. Возможности тарифных планов описаны на странице: Tariffs. Фотографии сверх того, что доступно в выбранном тарифном плане - не сохраняются.
state string (100) Ad state: Active Draft Completed
Active - such an ad can be found by everyone during a search. Everyone can view the ad, add it to favorites, etc.

Draft - such an ad cannot be found by searching, the ad cannot be viewed by users. Available for viewing and editing - only by the author of the ad. In the section: "Favorites" - not displayed.

Completed - such an ad cannot be found by searching. Previously added ads are displayed to users in the "Favorites" section - with the note: "removed from publication".
days float На сколько дней размещается объявление: Для тарифа: Free - доступны значения (дни): 14 Для тарифа: Premium - доступны значения (дни): 30 60 90 120 180 360
bid float Размер ставки. Значение по умолчанию - 0.
cost float Итоговая стоимость размещения объявления. Значение по умолчанию - 0.
order_url string(255) Ссылка для оплаты объявления на выбранном тарифном плане.
order_expired datetime Дата истечения срока оплаты ордера. По умолчанию: 24 часа с момента создания объявления. После истечения срока надо создать новую ссылку для оплаты.
created_at datetime Дата создания объявления.

Пример запроса №1 (только обязательные параметры)

https://dvaugla.ru/api/v1/ads
{
    "latitude": 55.836773,
    "longitude": 37.491909,
    "total_area": 50.25,
    "price": 10000000,
    "tariff": "Премиум",
    "days": "60",
    "bid": 17.10
}

Пример ответа №1

201 Created 
{
    "success": true,
    "data": {
        "id": "8426893080997327",
        "type": "Квартира",
        "action": "Продать",
        "apartment": "не указано",
        "room": "не указано",
        "latitude": 55.836773,
        "longitude": 37.491909,
        "country": "Россия",
        "postal": "125212",
        "city": "г Москва",
        "street": "ул Адмирала Макарова",
        "house": "д 6А",
        "block": "к 1",
        "flat": null,
        "owner": "Собственник",
        "owner_more": null,
        "srok": "не указано",
        "ready": "2025-06-16",
        "year": null,
        "material": "не указано",
        "material_more": null,
        "floor": null,
        "floors": null,
        "elevator": "не указано",
        "elevator_more": null,
        "infra": [],
        "total_area": 50.25,
        "living_area": null,
        "kitchen_area": null,
        "height": null,
        "remont": "не указано",
        "remont_more": null,
        "bathroom": "не указано",
        "bathroom_more": null,
        "balkon": "не указано",
        "balkon_more": null,
        "power": "не указано",
        "office_class": null,
        "price": 10000000,
        "period": "за всё",
        "commission": "нет комиссии",
        "commission_more": null,
        "by_email": false,
        "contact_email": null,
        "by_phone": false,
        "contact_phone": null,
        "tariff": "Премиум",
        "description": null,
        "htmlurl": null,
        "photo": [],
        "state": "Активное",
        "days": 60,
        "bid": 17.10,
        "cost": 1026,
        "order_url": "https://yoomoney.ru/checkout/payments/v2/contract?orderId=2ff1eb24-000f-5000-8000-10d828688f8e",
        "order_expired": "2025-06-18T16:31:49+03:00"
        "created_at": "2025-06-17T16:31:49+03:00"
    }
}

Пример запроса №2 (с необязательными параметрами)

https://dvaugla.ru/api/v1/ads
{
    "type": "Квартира",
    "action": "Продать",
    "apartment": "Квартира",
    "room": "1",
    "latitude": 55.836773,
    "longitude": 37.491909,
    "country": "Россия",
    "postal": "125212",
    "city": "г Москва",
    "street": "ул Адмирала Макарова",
    "house": "д 6А",
    "block": "к 1",
    "flat": "кв 349",
    "owner": "другой",
    "owner_more": "Сосед",
    "srok": "меньше 1 года",
    "ready": "2025-06-01",
    "year": "2020",
    "material": "другой",
    "material_more": "Сено",
    "floor": "5",
    "floors": "10",
    "elevator": "присутствует",
    "elevator_more": "4",
    "infra[]": "Поликлиника",
    "infra[]": "Школа",
    "total_area": 50.25,
    "living_area": "30.5",
    "kitchen_area": "10.47",
    "height": "3",
    "remont": "другой",
    "remont_more": "так себе",
    "bathroom": "другой",
    "bathroom_more": "отсутствует",
    "balkon": "другой",
    "balkon_more": "переделан в комнату",
    "power": "A",
    "price": 10000000,
    "period": "за всё",
    "commission": "% от стоимости",
    "commission_more": "5",
    "by_email": "1",
    "contact_email": "test@yandex.ru",
    "by_phone": "1",
    "contact_phone": "+79688668860",
    "tariff": "Премиум",
    "description": "Пример описания, указывается тут.",
    "htmlurl": "https://dvaugla.ru",
    "photo[]": "foto1.png",
    "photo[]": "foto2.jpg",
    "state": "Активное",
    "days": "60",
    "bid": 18
}

Пример ответа №2

201 Created 
{
    "success": true,
    "data": {
        "id": "2010707773194533",
        "type": "Квартира",
        "action": "Продать",
        "apartment": "Квартира",
        "room": "1",
        "latitude": 55.836773,
        "longitude": 37.491909,
        "country": "Россия",
        "postal": "125212",
        "city": "г Москва",
        "street": "ул Адмирала Макарова",
        "house": "д 6А",
        "block": "к 1",
        "flat": "кв 349",
        "owner": "другой",
        "owner_more": "не указано",
        "srok": "меньше 1 года",
        "ready": "2025-06-01",
        "year": "2020",
        "material": "другой",
        "material_more": "Сено",
        "floor": "5",
        "floors": "10",
        "elevator": "присутствует",
        "elevator_more": 4,
        "infra": [
            "Поликлиника",
            "Школа"
        ],
        "total_area": 50.25,
        "living_area": "30.5",
        "kitchen_area": "10.47",
        "height": "3",
        "remont": "другой",
        "remont_more": "так себе",
        "bathroom": "другой",
        "bathroom_more": "отсутствует",
        "balkon": "другой",
        "balkon_more": "переделан в комнату",
        "power": "A",
        "office_class": null,
        "price": 10000000,
        "period": "за всё",
        "commission": "% от стоимости",
        "commission_more": "5",
        "by_email": true,
        "contact_email": "test@yandex.ru",
        "by_phone": true,
        "contact_phone": "+79688668860",
        "tariff": "Премиум",
        "description": "Пример описания, указывается тут.",
        "htmlurl": "https://dvaugla.ru",
        "photo": [
            "ad-images/6854157d72a191160048371456165.png",
            "ad-images/6854157ea9ce31160048371456165.png"
        ],
        "state": "Активное",
        "days": 60,
        "bid": 18,
        "cost": 1080,
        "order_url": "https://yoomoney.ru/checkout/payments/v2/contract?orderId=2ff1eb24-000f-5000-8000-10d828688f8e",
        "order_expired": "2025-06-18T16:29:43+03:00"
        "created_at": "2025-06-17T16:29:43+03:00"
    }
}

5.3 Просмотр объекта

URL: GET https://dvaugla.ru/api/v1/ads/{id}

Возвращает информацию по указанному объекту.

Параметры запроса

Параметр Тип Описание
id string (16) id объявления.
format enum Формат вывода данных. Полный или укороченный формат. short full
with enum Дополнительная информация по объекту:
full - вся доступная информация
type - тип объекта
action - операция с объектом
apartment - тип помещения
room - количество комнат
address - информция об адресе (latitude, longitude, country, postal, city, street, house, block, flat)
owner - информция о собственике
srok - срок владения
material - материал стен
elevator - информация о лифтах
infra - элементы инфраструктуры
remont - информация о ремонте
bathroom - информация о санузле
balkon - информация о балконе
power - класс энергоэффективности
office_class - класс офиса
period - период оплаты
commission - комиссия агента
contact_email - Email для связи
contact_phone - телефон для связи
tariff - тарифный план
description - описание объекта
htmlurl - HTML-ссылка на внешнюю страницу объекта
photo - массив фотографий
state - состояние объявления
user - информация об авторе

Пример запроса

https://dvaugla.ru/api/v1/ads/9373075910006562

Пример запроса с дополнительными полями

https://dvaugla.ru/api/v1/ads/9373075910006562?format=short

Пример запроса с дополнительными полями

https://dvaugla.ru/api/v1/ads/9373075910006562?format=full&with=photo,user

Информация по параметрам статусам объявлений:

Если запрос поступил от автора объявления, то возвращается объявление с любым статусом (поле: state) в противном случае возвращаются объявления только со статусами: Active Completed

Параметры ответа

Параметр Тип Описание
success boolean (['true','false']) Успешно ли прошёл запрос все проверки
id string (16) id объявления
type string (100) Тип объекта: Flat House Parking space Storeroom Garage Territory Office
action string (100) Операция с объектом: Sell For rent Exchange Donate
apartment string (100) Тип помещения: not specified Flat Apartments Комната Доля доступно только для объектов: Flat
room string (100) Rooms: not specified Studio 1 2 3 4 5 6 7 and more Open plan layout доступно только для объектов: Flat House Office
latitude float Object coordinates: (Latitude).
longitude float Object coordinates: (Longitude).
country string (50) Country. Значение по умолчанию - Россия.
postal string (6) Индекс. Значение по умолчанию - null.
city string (100) City / Settlement. Например:"г Москва", "деревня Моносеево", "село Ямкино", "дп Загорянский", "тер. СНТ Росинка". Значение по умолчанию - null.
street string (100) Street. Например:"ул Центральная усадьба", "Ленинградское шоссе". Значение по умолчанию - null.
house string (60) House or plot number. Например:"д 6А". Значение по умолчанию - null.
block string (60) Building Structure. Например:"к 3", "стр 10", "к 16А". Значение по умолчанию - null.
flat string (60) Apartment number. Например:"кв 349". Значение по умолчанию - null.
owner string (100) Ownership: Owner Агент other
owner_more string (50) Право собственности (уточнение). В случае если в параметре: owner - указано значение: other , то в данном параметре можно уточнить отношение к собственности автора объявления. Значение по умолчанию - null.
srok string (100) Tenure: not specified less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years more than 5 years
Specifies how long the property has been owned by the owner.
ready string (YYYY-MM-DD) Date of possible occupancy, transfer of ownership. Значение по умолчанию - сегодня.
year string (YYYY) Year of build
material string (100) Wall material: not specified Brick Monolithic Panel Wooden Block Tin other доступно только для объектов: Flat House Storeroom Garage Office
material_more string (50) Материал стен (уточнение). В случае если в параметре: material - указано значение: other , то в данном параметре можно уточнить материал объекта. Значение по умолчанию - null.
floor string (10) Floor. Значение по умолчанию - null.
floors string (10) Floors of the object. Значение по умолчанию - null.
elevator string (100) Elevator: not specified absent присутствует доступно только для объектов: Flat House Office
elevator_more int Лифт (уточнение количества). В случае если в параметре: elevator - указано значение: присутствует , то в данном параметре можно уточнить количество лифтов на объекте. Значение по умолчанию - null.
infra[] array (массив string значений) Infrastructure: Polyclinic School Kindergarten Subway Park Yard without cars Playgrounds Parking Shopping mall Bank Cafe Pharmacy Sports club Shop Creative studio Салоны красоты Водоём Picnic area
total_area float Total area (m²)
living_area string (10) Living area (m²), доступно только для объектов: Flat House Значение по умолчанию - null.
kitchen_area string (10) Kitchen area (m²), доступно только для объектов: Flat House Значение по умолчанию - null.
height string (10) Ceiling height (m²), доступно только для объектов: Flat House Storeroom Garage Office Значение по умолчанию - null.
remont string (100) Renovation: not specified without renovation cosmetic Euro-renovation major other доступно только для объектов: Flat House Storeroom Garage Office
Cosmetic - minor repairs to freshen up the room.

Euro-renovation is a renovation that gives the premises exclusivity and increases functionality.

Major - may include redevelopment, replacement of electrical wiring and utility lines.
remont_more string (50) Ремонт (уточнение). В случае если в параметре: remont - указано значение: other , то в данном параметре можно уточнить тип ремонта. Значение по умолчанию - null.
bathroom string (100) Bathroom: not specified combined separate outside other доступно только для объектов: Flat House Office
bathroom_more string (50) Санузел (уточнение). В случае если в параметре: bathroom - указано значение: other , то в данном параметре можно уточнить тип cанузла. Значение по умолчанию - null.
balkon string (100) Balcony: not specified absent open glazed loggia french other доступно только для объектов: Flat House Office
balkon_more string (50) Санузел (уточнение). В случае если в параметре: balkon - указано значение: other , то в данном параметре можно уточнить тип балкона. Значение по умолчанию - null.
power string (50) Energy efficiency class: not specified A++ A+ A B C D E F G доступно только для объектов: Flat House Office
office_class string (50) Office class: not specified A B C D доступно только для объектов: Office
price int Cost, ₽
period string (100) Период оплаты: in total per month per day per hour
commission string (100) Комиссия агента (дополнительно): no commission % of the cost fixed
Укажите только ту комиссию, которую необходимо оплатить клиенту/покупателю, дополнительно к основной сумме объекта. Если эту комиссию Вы оплачиваете самостоятельно из стоимости объекта, то не надо её указывать.
commission_more float Комиссия агента (дополнительно). В случае если в параметре: commission - указано значение: % of the cost fixed , то в данном параметре можно уточнить размер комиссии. Значение по умолчанию - 0.
Укажите только ту комиссию, которую необходимо оплатить клиенту/покупателю, дополнительно к основной сумме объекта. Если эту комиссию Вы оплачиваете самостоятельно из стоимости объекта, то не надо её указывать.
by_email boolean Method of communication: через Email. Значение по умолчанию - false.
You can add/change your email address for contacts in your profile.
contact_email string (100) Email. Email автоматически добавится в раздел Контактной информации, если его там не было раньше. Значение по умолчанию - null.
You can add/change your email address for contacts in your profile.
by_phone boolean Method of communication: по телефону. Значение по умолчанию - false.
You can add/change the contact phone number for contacts with you in your profile.
contact_phone string (12) Номер телефона, формат: +79xxxxxxxxx. Телефон автоматически добавится в раздел Контактной информации, если его там не было раньше. Значение по умолчанию - null.
You can add/change the contact phone number for contacts with you in your profile.
tariff string (100) Tariff plan: Free Premium
You can publish 1 ad for free.
Paid ads have higher priority and are displayed first in search queries.
description string (2000) Description. Размер описания определяется в зависимости от выбранного тарифного плана. Возможности тарифных планов описаны на странице: Tariffs. Если поле с описанием длинное чем доступно в выбранном тарифном плане, то описание будет обрезано, согласно параметрам тарифного плана. Значение по умолчанию - null.
htmlurl string (255) HTML link to external page of the object (available protocols: https): доступно для тарифных планов: Premium Значение по умолчанию - null.
photo[] array (массив фотографий) Photos. Количество фотографий определяется выбранным тарифным планом. Возможности тарифных планов описаны на странице: Tariffs. Фотографии сверх того, что доступно в выбранном тарифном плане - не сохраняются.
state string (100) Ad state: Active Draft Completed
Active - such an ad can be found by everyone during a search. Everyone can view the ad, add it to favorites, etc.

Draft - such an ad cannot be found by searching, the ad cannot be viewed by users. Available for viewing and editing - only by the author of the ad. In the section: "Favorites" - not displayed.

Completed - such an ad cannot be found by searching. Previously added ads are displayed to users in the "Favorites" section - with the note: "removed from publication".
days float На сколько дней размещается объявление: Для тарифа: Free - доступны значения (дни): 14 Для тарифа: Premium - доступны значения (дни): 30 60 90 120 180 360
bid float Размер ставки. Значение по умолчанию - 0.
cost float Итоговая стоимость размещения объявления. Значение по умолчанию - 0.
order_url string(255) Ссылка для оплаты объявления на выбранном тарифном плане.
order_expired datetime Дата истечения срока оплаты ордера. По умолчанию: 24 часа с момента создания объявления. После истечения срока надо создать новую ссылку для оплаты.
rating float Рейтинг по 5-бальной системе на основании отзывов. Точность - 2 знака после запятой.
created_at datetime Дата создания объявления.
stoped_at datetime Дата завершения показа объявления.

Пример ответа:

200 OK 
{
    "success": true,
    "data": {
        "id": "7966356998567196",
        "type": "Квартира",
        "action": "Продать",
        "apartment": "Квартира",
        "room": "1",
        "latitude": "55.836773000",
        "longitude": "37.491909000",
        "country": "Россия",
        "postal": "125212",
        "city": "г Москва",
        "street": "ул Адмирала Макарова",
        "house": "д 6А",
        "block": "к 1",
        "flat": "кв 349",
        "owner": "другой",
        "owner_more": "Сосед",
        "srok": "меньше 1 года",
        "ready": "2025-06-01",
        "year": "2020",
        "material": "другой",
        "material_more": "Сено",
        "floor": 5,
        "floors": 10,
        "elevator": "присутствует",
        "elevator_more": 4,
        "infra": [
            "Школа",
            "Поликлиника"
        ],
        "total_area": 50.25,
        "living_area": "30.50",
        "kitchen_area": "10.47",
        "height": "3.00",
        "remont": "другой",
        "remont_more": "так себе",
        "bathroom": "другой",
        "bathroom_more": "отсутствует",
        "balkon": "другой",
        "balkon_more": "переделан в комнату",
        "power": "A",
        "office_class": null,
        "price": 10000000,
        "period": "за всё",
        "commission_more": 5,
        "commission": "% от стоимости",
        "by_email": true,
        "contact_email": "test@yandex.ru",
        "by_phone": true,
        "contact_phone": "+79688668860",
        "tariff": "Премиум",
        "description": "Пример описания, указывается тут.",
        "htmlurl": "https://dvaugla.ru",
        "photo": [
            "http://127.0.0.1:8000/storage/ad-images/686ab7c50b7967966356998567196.png"
        ],
        "state": "Активное",
        "rating": 0,
        "created_at": "2025-07-06T20:52:04+03:00",
        "stoped_at": "2025-08-06T20:52:04+03:00",
        "user": {
            "id": "7247191241678337",
            "name": "Алексей",
            "rating": 0,
            "rating_count": 0
        }
    }
}
Up

Your experience on this site will be improved by allowing cookies. Cookie Consent