Наверх

Документация 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/?
      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 (пусто — без ограничений)