offers

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

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

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

Пример:

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

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

Пример:

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

Параметры не являются обязательными для заполнения. В случае отправки пустого запроса в ответе будут указаны все когда-либо существовавшие объявления агентства.

get/v1/get-my-offers

Request

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

Query parameters

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.