API вебмастеров — поиск команд и досье по пикселю, домену, фанпейджу

GET /webmasters и GET /webmasters/{code} — поиск арбитражных команд по коду, домену, пикселю, фанпейджу и гео, досье вебмастера и лента его креативов.

Вебмастер — это арбитражная команда, которую MTWSPY выделяет по общим пикселям, доменам, фанпейджам и лендингам. У каждой есть код вида WM-ABCD-1234, тот же, что в разделе Вебмастеры кабинета.

Метод	Путь	Назначение
`GET`	`/webmasters`	Поиск вебмастеров по фильтрам
`GET`	`/webmasters/{code}`	Досье вебмастера
`GET`	`/creatives?webmaster={code}`	Креативы вебмастера

Бесплатно

Поиск и досье просмотры не тратят. Полные карточки объявлений вебмастера отдаёт /creatives?webmaster= — как обычный поиск креативов.

Поиск вебмастеров

GET /public/v1/webmasters

curl -G https://app.mtwspy.com/public/v1/webmasters \
  -H "Authorization: Bearer mtw_live_ваш_ключ" \
  -d vertical=nutra -d geo=MX,CL -d min_active=20 -d sort=active

Параметры

Все необязательные. Списки — через запятую, внутри списка работает «любое из».

Параметр	Значения
`q`	Общий поиск: код, баер, домен, пиксель, путь лендинга, тег, название фанпейджа. Число от 6 цифр ищется и как id фанпейджа. Ссылку можно вставить целиком. Минимум 2 символа
`code`	Точный код `WM-ABCD-1234`
`domain`	Домен или его часть
`pixel`	Пиксель, по началу значения
`landing`	Путь лендинга, например `/flexo/mx`
`tag`	Тег из ссылок команды
`fanpage`	id фанпейджа (цифры) или часть названия
`geo`	ISO-2 через запятую: `MX,CL`
`vertical`	`nutra`, `crypto`, `gambling`, `dating`
`days`	`7`, `30`, `90` — был активен за последние N дней
`min_ads` `min_active` `min_hooked`	Не меньше стольких объявлений: всего / активных / «зацепивших»
`favorites`	`1` — только избранные вебмастера владельца ключа
`sort`	`ads` (по умолч.), `active`, `hooked`, `domains`, `pages`, `pixels`, `last`
`page`	Номер страницы, 1–20

На странице 24 вебмастера, глубже 20-й страницы листать нельзя — сузьте поиск фильтрами.

Ответ

{
  "data": [
    {
      "code": "WM-KQZT-4821",
      "verticals": ["nutra"],
      "counters": {
        "ads": 1240, "active": 312, "hooked": 41, "hooked_basis": "reach",
        "pages": 58, "domains": 17, "pixels": 9
      },
      "geos": ["MX", "CL", "PE"],
      "first_seen": "2026-03-14",
      "last_seen": "2026-11-08",
      "previews": ["https://.../preview/....jpg"],
      "is_favorite": false,
      "library_url": "https://app.mtwspy.com/library?webmaster=WM-KQZT-4821",
      "dossier_url": "https://app.mtwspy.com/public/v1/webmasters/WM-KQZT-4821",
      "creatives_url": "https://app.mtwspy.com/public/v1/creatives?webmaster=WM-KQZT-4821"
    }
  ],
  "meta": { "total": 37, "page": 1, "per_page": 24, "max_page": 2, "has_more": true, "sort": "active", "charged": 0 }
}

Поле	Описание
`counters.hooked`	Объявления, которые «зацепили»: по охвату или по числу перезаливов (`hooked_basis`)
`previews`	До трёх превью свежих креативов
`library_url`	Лента креативов вебмастера в кабинете MTWSPY
`dossier_url`	Досье через API
`creatives_url`	Креативы вебмастера через API

Пиксели, домены и фанпейджи в списке не отдаются — они есть в досье.

Досье вебмастера

GET /public/v1/webmasters/{code}

curl https://app.mtwspy.com/public/v1/webmasters/WM-KQZT-4821 \
  -H "Authorization: Bearer mtw_live_ваш_ключ"

Работает и query-форма: GET /public/v1/webmaster?code=WM-KQZT-4821.

Ответ

{
  "data": {
    "code": "WM-KQZT-4821",
    "verticals": ["nutra"],
    "first_seen": "2026-03-14",
    "last_seen": "2026-11-08",
    "counters": {
      "ads": 1240, "active": 312, "stopped": 928, "hooked": 41, "hooked_basis": "reach",
      "pages": 58, "buyers": 4, "domains": 17, "pixels": 9
    },
    "history": {
      "from": "2026-10-11", "to": "2026-11-09", "new_ads": 186,
      "days": [{ "date": "2026-10-11", "active": 280, "new": 5 }]
    },
    "geo": [{ "country": "MX", "ads": 610, "share": 49.2 }],
    "pixels": [{ "value": "1234567890123456", "ads": 402 }],
    "domains": [{ "value": "salud-hoy.shop", "ads": 233 }],
    "fanpages": [{ "id": "104512345678901", "name": "Salud Natural", "ads": 96 }],
    "buyers": [{ "name": "alex", "ads": 700 }],
    "landing_paths": [{ "path": "/flexo/mx", "ads": 120 }],
    "webmaster_ads": {
      "total": 1240,
      "items": [
        {
          "id": 48211773,
          "preview": "https://.../preview/....jpg",
          "format": "video",
          "geo": "MX",
          "published_at": "2026-11-07T00:00:00+03:00",
          "is_active": true
        }
      ]
    },
    "library_url": "https://app.mtwspy.com/library?webmaster=WM-KQZT-4821",
    "dossier_url": "https://app.mtwspy.com/public/v1/webmasters/WM-KQZT-4821",
    "creatives_url": "https://app.mtwspy.com/public/v1/creatives?webmaster=WM-KQZT-4821",
    "is_favorite": false
  },
  "meta": { "charged": 0 }
}

Блок	Что внутри
`counters`	Объявления всего / активные / остановленные / «зацепившие», фанпейджи, баеры, домены, пиксели
`history`	По дням за 30 дней: сколько объявлений было активно и сколько появилось новых
`geo`	Страны по числу объявлений и доля каждой, %
`pixels` `domains`	До 50 самых частых, с числом объявлений
`fanpages`	До 50 фанпейджей: id, название, число объявлений
`buyers`	До 15 баеров команды
`landing_paths`	До 50 путей лендингов. У гемблинг-команд пустой
`webmaster_ads`	`total` и 12 последних объявлений в коротком виде
`library_url`	Лента всех креативов вебмастера в кабинете

В webmaster_ads нет текста, домена и лендинга. Полная карточка — по id через /creatives/{id} или всей лентой через creatives_url.

Досье кэшируется на 15 минут.

Креативы вебмастера

Параметр webmaster есть у поиска креативов и сочетается с любыми фильтрами:

curl -G https://app.mtwspy.com/public/v1/creatives \
  -H "Authorization: Bearer mtw_live_ваш_ключ" \
  -d webmaster=WM-KQZT-4821 -d sort=reach -d limit=20

Гемблинг при этом не скрывается. В каждой карточке креатива есть блок webmaster с кодом и теми же ссылками — по нему можно перейти от креатива к команде.

Лимиты

Что	Лимит
Поиск	Общий rate-limit ключа, 24 на странице, не глубже 20 страниц
Досье	10 в минуту и 200 за сутки на аккаунт. Запросы несуществующих кодов тоже считаются

Ошибки

`code`	HTTP	Когда
`invalid_parameter`	422	Код не в формате `WM-ABCD-1234`, неизвестная вертикаль или сортировка, `page` вне 1–20
`not_found`	404	Вебмастер не найден
`rate_limited`	429	Больше 10 досье в минуту или общий rate-limit
`daily_limit_reached`	429	200 досье за сутки

Вебмастера

Поиск вебмастеров

Параметры

Ответ

Досье вебмастера

Ответ

Креативы вебмастера

Лимиты

Ошибки

On this page