Партнёрские сети
GET /networks — партнёрские сети, где активны офферы креативов, число объявлений по каждой и фильтр креативов по сети.
GET /public/v1/networksСправочник партнёрских сетей, в которых сейчас активны офферы объявлений из базы. Просмотры не тратит. Порядок — тот же, что в фильтре сетей в библиотеке кабинета.
curl -G https://app.mtwspy.com/public/v1/networks \
-H "Authorization: Bearer mtw_live_ваш_ключ" \
-d q=cashПараметры
| Параметр | Значения |
|---|---|
q | Часть названия сети, без учёта регистра |
has_ads | 1 — только сети, у которых в базе есть объявления |
Ответ
{
"data": [
{
"id": 13,
"name": "Dr.Cash",
"url": "https://dr.cash",
"logo": "https://.../logo.png",
"ads_count": 18342,
"creatives_url": "https://app.mtwspy.com/public/v1/creatives?aff_network=13"
}
],
"meta": { "total": 1 }
}| Поле | Описание |
|---|---|
id | Идентификатор сети — его передают в aff_network |
name | Название. Тоже подходит для aff_network |
url logo | Сайт и логотип сети, могут быть null |
ads_count | Сколько объявлений с оффером, активным в этой сети. Обновляется раз в час; null — счётчик временно недоступен |
creatives_url | Креативы этой сети через API |
Креативы по партнёрской сети
Фильтр aff_network у поиска креативов принимает id или названия
из этого справочника:
curl -G https://app.mtwspy.com/public/v1/creatives \
-H "Authorization: Bearer mtw_live_ваш_ключ" \
-d aff_network=Dr.Cash,13 -d geo=PL -d limit=20| Параметр | Значения |
|---|---|
aff_network | id или названия сетей через запятую — оффер активен хотя бы в одной из них. any — в любой сети |
aff_mode | any (по умолч.) или all — оффер активен во всех перечисленных сетях |
В каждой карточке креатива есть массив aff_networks — сети, где оффер сейчас активен:
"aff_networks": [
{ "id": 13, "name": "Dr.Cash", "url": "https://dr.cash", "logo": "https://.../logo.png" }
]Пустой массив — оффер ни в одной известной сети не найден.
Ошибки
code | HTTP | Когда |
|---|---|---|
invalid_parameter | 422 | В aff_network неизвестное название или неверный aff_mode |
rate_limited | 429 | Слишком часто |