API Для Маркетологов v1.0

Последнее обновление: 14 сентября, 2025.

Документация API Marketer v1.0

Добро пожаловать в документацию API Marketer. Наш API разработан для программного получения информации о ваших кампаниях, статистики и удобного управления вашими трекинг-ссылками.

Базовый URL:

https://onlysudo.com

Аутентификация

Все запросы к нашему API должны быть аутентифицированы с помощью действующего API ключа. Мы предоставляем один метод аутентификации:

Заголовок Authorization (Рекомендуется): Передавайте ваш API ключ в заголовке Authorization вашего HTTP-запроса.

Authorization: [Ваш API ключ]

Чтобы получить ваш API ключ, перейдите в интерфейс API и нажмите синюю кнопку «Generate a new key» (Сгенерировать новый ключ).

API-эндпоинты

Все эндпоинты используют метод POST и следуют базовому пути /api/marketer?do=....

1. Получение списка активных кампаний

Получает список всех активных кампаний, связанных с вашим аккаунтом.

Эндпоинт: /api/marketer?do=campaigns
Метод: POST
Заголовок Authorization:
Authorization: [Ваш API ключ] (строка, опционально): Ваш API ключ.
Пример тела запроса: JSON
```
{
  "limit": 10,
  "offset": 0
}
```

Пример ответа: JSON

{
  "status": "success",
  "data": [
    {
      "id": 123,
      "name": "test",
      "url": "test",
      "type": "free_trial",
      "onlyfans_url": "test",
      "onlyfans_id": 123123,
      "onlyfans_account": {
        "name": "test",
        "username": "test",
        "about": "test",
        "avatar": {
          "original": "https://test.com/avatar_url.jpg",
          "thumbnail": "https://test.com/avatar_url.jpg",
          "thumbnail_640": "https://test.com/avatar_url.jpg"
        },
        "demo_content": [],
        "regular_price": 0,
        "promotions": [],
        "blocked_countries": [],
        "subscribers_count": 0,
        "likes_count": 0,
        "posts_count": 0,
        "photos_count": 0,
        "videos_count": 0,
        "performer_top": 0
      },
      "visits": 400,
      "subscribers": 40000,
      "subscribers_today": 4000,
      "income": 1000000,
      "income_today": 1000,
      "revenue": 4000,
      "date_create": 1672527600,
      "date_update": 1672527600,
      "tags": [
        "test"
      ]
    }
  ]
}

2. Получение списка транзакций

Получает список всех транзакций (конверсий, лидов и т.д.) по вашим кампаниям.

Эндпоинт: /api/marketer?do=transactions
Метод: POST
Заголовок Authorization:
Authorization: [Ваш API ключ] (строка, опционально): Ваш API ключ.

Пример ответа: JSON

{
  "status": "success",
  "data": [
    {
      "id": 0,
      "campaign_id": 0,
      "subscriber_id": 0,
      "onlyfans_id": 0,
      "type": "tip",
      "amount": 0,
      "revenue": 0,
      "is_undo": false,
      "date": 0
    }
  ]
}

3. Получение списка подписчиков

Получает список подписчиков, сгенерированных в рамках ваших кампаний, обычно для офферов по привлечению лидов.

Эндпоинт: /api/marketer?do=subscribers
Метод: POST
Заголовок Authorization:
Authorization: [Ваш API ключ] (строка, опционально): Ваш API ключ.

Пример ответа: JSON

{
  "status": "success",
  "data": [
    {
      "id": 0,
      "campaign_id": 0,
      "onlyfans_id": 0,
      "name": "test",
      "url": "test",
      "revenue": 0,
      "date_subscribe": 0
    }
  ]
}

4. Генерация продвинутой трекинг-ссылки для OnlyFans

Этот эндпоинт предназначен для продвинутых медиабайеров с тестовыми бюджетами в $2-5k. Он предоставляет специализированную трекинг-ссылку для кампаний на OnlyFans, обеспечивая детальный контроль над отслеживанием постбэков.

Функционал позволяет:

Получать постбэки с OnlyFans на вашу трекинг-платформу.
Точное управление click_id для корректной атрибуции.
Оптимизацию ваших кампаний на основе данных.

Для получения подробных инструкций по внедрению, использованию макросов и лучших практик, пожалуйста, свяжитесь с вашим менеджером.