Документация ad1 API BETA
GET https://ad1.media/api/offer/
Возвращает список офферов.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| is_exclusive | bool | Только эксклюзивные офферы |
| is_mobile | bool | Только мобильные офферы |
| is_mobile_optimised | bool | Только оптимизированные для мобильных офферы |
| is_new_promo | bool | Только офферы, у которых есть новые промоматериалы |
| is_new_stock | bool | Только офферы, у которых есть новые акции |
| is_active_stock | bool | Только офферы, у которых есть активные акции |
| show_stopped | bool | Показывать остановленные офферы или нет |
| geo | int или array(int) | Показывать офферы, доступные для переданных регионов |
| categories | int или array(int) | Офферы из переданных категорий |
Пример запроса
GET https://ad1.media/api/offer/?
api_key=wrong_account_type
&show_stopped=1
&is_mobile_optimised=1
&categories=9,14
&geo=1702
&per_page=10
Описание ответа
Поле ответа objects содержит список офферов, удовлетворяющих заданному фильтру. Необходимо использовать пагинацию.
| Поле | Описание |
|---|---|
| id | ID оффера |
| is_approved | Одобрен ли оффер к работе |
| is_stopped | Остановлен ли оффер (на паузе) |
| name | Имя оффера |
| description | Короткое описание |
| description_short | Полное описание оффера |
| rules | Правила работы с оффером, заданные рекламодателем. Объект, состоящий из полей short и full, содержащие, соответственно, краткие и развернутые правила. |
| is_deeplink | Разрешены ли диплинки |
| is_new | Является ли оффер новым (недавно добавленным в систему) |
| is_new_promo | Содержит ли оффер недавно добавленные промоматериалы |
| is_new_stock | Содержит ли оффер недавно начатые акции |
| is_exclusive | Является ли оффер эксклюзивным |
| is_phone_tracking | Отслеживаются ли лиды по телефону |
| rating | Рейтинг оффера, от 1 до 10 |
| url_homepage | Домашнаяя страница оффера |
| url_redirect | Страница перехода |
| url_name | Название страницы перехода |
| utm_mask | Маска utm для перехода на сайт рекламодателя |
| images | Картинки оффера, обычно оффер имеет три картинки размеров small, middle и big. Передается поле size, содержащее размеры, и также поле img со ссылкой на картинку |
| cookie_ttl_days | Время жизни cookies (количество дней) |
| date_created | Дата создания оффера |
| date_start | Дата начала работы оффера |
| date_end | Дата конца работы оффера |
| date_updated | Дата, когда оффер был последний раз обновлен |
| is_mobile | Оффер является мобильным (игра для моб. уст-ва, программа для моб. уст-ва, etc) |
| is_mobile_optimised | Оффер оптимизирован для мобильного траффика |
| is_recommended | Является ли оффер рекомендованным |
| support | Контактная информация службы поддержки |
| avg_delivery_time | Среднее время доставки товара, заявленное рекламодателем |
| is_private | Оффер приватный (доступен только для некоторых вебмастеров) |
| geo_codes | Гео оффера в формате ISO (пусто — без ограничений) |