offers

Получить объявления

С помощью метода можно получить объявления по агентству, отфильтровав объявления по статусу, источнику и списку сотрудников.

Предположим, агентству нужно получить все свои объявления: уже снятые с публикации и опубликованные на текущий момент. При этом необходимо видеть только те объявления, которые были созданы агентом вручную, а не загружены через XML-фид. Объявления должны быть отфильтрованы по id агента, который опубликовал их.

Пример:

curl -X GET -H 'Authorization: Bearer <ACCESS TOKEN>' https://public-api.cian.ru/v2/get-my-offers?source=manual&statuses=inactive&statuses=published&page=1&pageSize=10

Возможно получить только те объявления, которые были созданы определенными агентами (id 106815 и 106816). Для этого в параметры запроса нужно передать еще поле usersIds c идентификаторами сотрудников.

Пример:

curl -X GET -H 'Authorization: Bearer <ACCESS TOKEN>' https://public-api.cian.ru/v2/get-my-offers?source=manual&statuses=inactive&statuses=published&usersIds=106815&usersIds=106816&page=1&pageSize=10

Все параметры, кроме page и pageSize, не являются обязательными для заполнения.

get/v2/get-my-offers

Request

  • Base URL: https://public-api.cian.ru
  • URL: https://public-api.cian.ru/v2/get-my-offers
  • Auth: none declared

Query parameters

pageinteger required

Номер страницы выдачи

pageSizeinteger required

Размер страницы выдачи

source'manual' | 'upload'

manual: Ручное upload: Импорт

Источник объявления

statusesstring[]

published: Опубликован inactive: Неактивен refusedByModerator: Отклонен модератором removedByModerator: Удален модератором

Статусы

usersIdsinteger[]

Список пользователей (сабов)

Response

OK

operationIdstring uuid required

ID запроса

Changes

No recorded changes to this operation across all 1 revision of this API.