API для рекламодателей и расширения

Базовый URL: https://seoedit.ru/api/v1

Авторизация: заголовок Authorization: Bearer seoedit_… или X-Api-Token.

Публично

• GET /brand — white-label (название, логотип, цвета, валюта, URL API)
• GET /pricing — тарифы, минимальные цены и требования к отчётам по категориям заданий
• GET /integrations/payout-gateway — спецификация P2P-шлюза автовыплат (webhook + callback); SDK: README, PHP
• GET /app/bootstrap, GET /openapi.json — мобильный клиент
• GET /contests, GET /news — публичные конкурсы и новости

Лимиты: публичные эндпоинты — 60 запр./мин с IP; с токеном — 120 запр./мин на аккаунт. Заголовки X-RateLimit-Limit, X-RateLimit-Remaining, при 429 — Retry-After.

Аккаунт (с токеном)

• GET /me — профиль, режим кабинета, лимиты API

Рекламодатель

• GET /balance — баланс рекламодателя
• GET /stats — сводная статистика кампаний (потрачено, активные)
• GET /stats/overview — расширенная сводка (модерация 30 дн., паузы, timeseries 7 дн.)
• GET /stats/overview/export?format=csv|json — экспорт сводки
• GET /stats/timeseries?days=30 — расходы по дням (задания, сёрфинг, YouTube, тизеры)
• GET /stats/timeseries/export?days=30&format=csv — экспорт timeseries
• GET /reports, GET /reports/export?format=csv|json — отчёты исполнителей (экспорт до 5000 строк)
• GET /tasks/{id}/reports/export — экспорт отчётов по заданию
• GET /surf/visits, GET /surf/visits/export, GET /surf/{id}/visits/export — визиты сёрфинга
• GET /youtube/views, GET /youtube/views/export, GET /youtube/{id}/views/export — просмотры YouTube
• GET /teasers/clicks, GET /teasers/clicks/export, GET /teasers/{id}/clicks/export — клики по тизерам
• GET /deposits, GET /deposits/{id} — статус пополнений
• GET /webhook, PUT /webhook — URL и секрет webhook (deposit.*, report.*, campaigns.auto_paused)
• GET /tasks/{id}/stats, GET /surf/{id}/stats, GET /youtube/{id}/stats, GET /teasers/{id}/stats — детальная статистика кампании
• GET /tasks/form-presets?category=registration — типовые поля формы для категории
• POST /tasks/bulk-actions — массовые действия publish, pause, resume, stop (до 50 task_ids)
• POST /tasks/bulk — массовое создание до 50 заданий (tasks[], флаг publish)
• GET /task-templates, POST /task-templates, DELETE /task-templates/{id}, POST /task-templates/{id}/create-task — шаблоны заданий
• GET /campaign-templates?type=surf|youtube|teaser, POST /campaign-templates, POST /campaign-templates/{id}/create-campaign — шаблоны сёрфинга, YouTube, тизеров
• POST /campaigns/bulk-actions — массовые publish/pause/resume/stop для кампаний (type + до 50 ids)
• GET /tasks, POST /tasks, GET /tasks/{id}, POST /tasks/{id}/publish, POST /tasks/{id}/pause, POST /tasks/{id}/resume, POST /tasks/{id}/stop — задания (поле form_fields, target_countries, флаг publish)
• GET /surf, POST /surf, POST /surf/{id}/publish, POST /surf/{id}/pause, POST /surf/{id}/resume, POST /surf/{id}/stop — сёрфинг
• GET /youtube, POST /youtube, POST /youtube/{id}/publish, POST /youtube/{id}/pause, POST /youtube/{id}/resume, POST /youtube/{id}/stop — YouTube
• GET /teasers, POST /teasers, POST /teasers/{id}/publish, POST /teasers/{id}/pause, POST /teasers/{id}/resume, POST /teasers/{id}/stop — тизеры
• GET /rutube, POST /rutube, publish/pause/resume/stop — Rutube
• GET /banners, POST /banners, publish/pause/resume/stop — баннеры в расширении
• GET /cabinet, POST /cabinet, publish/stop — реклама в кабинете исполнителей
• GET /traffic-mix, POST /traffic-mix, publish/pause/resume/stop — трафик-микс
• GET /create-options — витрина типов заданий и трафика (task_presets, task_categories, promotion)
• GET /ads — сводный каталог объявлений рекламодателя
• POST /tasks/{id}/promote/vip, …/bump, …/pin — VIP, поднятие, закрепление
• GET /extension/banner, POST /extension/banner/impressions/{id}/complete — баннеры в расширении

Исполнитель

• GET /worker/balance — баланс исполнителя
• GET /worker/stats — заработок (сегодня / 7 / 30 дней), уровень, EXP, бонус к выплатам
• GET /worker/tasks, GET /worker/tasks/{id} — каталог активных заданий (?category=, ?limit=)
• GET /worker/tasks/categories — список категорий
• GET /worker/reports — ваши отчёты
• POST /worker/tasks/{id}/reports — отправить отчёт (proof_text, proof_url, form_answers)
• GET /worker/withdrawals, GET /worker/withdrawals/{id}, POST /worker/withdrawals — заявки на вывод (amount, payout_details или payout_profile_id)
• GET /worker/payout-profiles, POST /worker/payout-profiles, DELETE /worker/payout-profiles/{id} — сохранённые реквизиты
• GET /referrals/stats — реферальная статистика (код, ссылка, число рефералов по уровням, начисления)
• GET /worker/social-accounts, POST /worker/social-accounts, DELETE /worker/social-accounts/{id} — привязка соцсетей исполнителя

Расширение (исполнитель)

• GET /extension/config — публичные настройки (без токена)
• GET /extension/teaser — следующий тизер и старт таймера
• POST /extension/teaser/clicks/{id}/complete — завершить просмотр

Токены создаются в кабинете: рекламодатель → API, исполнитель → API / расширение.