Как начать работать с API click.ru

Коротко: API click.ru позволяет автоматизировать рутинные операции: управлять аккаунтами, выгружать статистику, пополнять баланс и настраивать кампании. Всё это — через код, без ручного входа в интерфейс. API бесплатно для всех зарегистрированных пользователей. Ключ доступа (токен) вы получаете в личном кабинете.

Зачем подключать API

Если вы ведёте рекламу вручную через интерфейс, каждый клик и каждое изменение отнимают время. А если клиентов несколько? А если нужно собрать отчётность за месяц по десятку кампаний? В какой-то момент рутина начинает съедать часы, которые можно было бы потратить на стратегию.

API click.ru забирает эту рутину на себя. Вместо того чтобы входить в кабинет и нажимать кнопки, вы один раз пишете код, и он делает всё сам:

● Создаёт рекламные кабинеты для новых клиентов.
● Собирает статистику за любой период и выгружает её в вашу CRM или Google-таблицу.
● Пополняет баланс, когда деньги на исходе.
● Запускает или останавливает кампании по расписанию.

Это как если бы у вас появился личный ассистент, который работает 24/7, не ошибается и не просит кофе.

Как начать работу с API

Подключение занимает 5 минут и не требует сложных настроек.

Шаг 1. Получите токен

Токен — это ваш цифровой ключ, который даёт программе доступ к вашему аккаунту.

1. Зайдите в свой профиль на click.ru.

2. В разделе «API Token» нажмите «Создать».

3. Скопируйте его. 
Важно: храните токен в секрете, как пароль. Если произошла утечка данных — тут же создайте новый, старый перестанет работать.

Шаг 2. Настройте авторизацию в запросах

Все запросы к API отправляются на сервер https://api.click.ru. Токен нужно передавать в HTTP-заголовке X-Auth-Token.
Если вы авторизованы под мастер-аккаунтом и хотите выполнить действие от имени одного из своих пользователей, добавьте заголовок X-Auth-UserId с его ID.

Шаг 3. Изучите документацию и сделайте первый запрос

Полная документация со всеми методами доступна в формате Swagger. Там же можно протестировать любой запрос прямо из браузера.

Пример простого запроса через cURL (получение профиля пользователя):

bash

curl -X GET "https://api.click.ru/V0/user" \
     -H "Accept: application/json" \
     -H "X-Auth-Token: ВАШ_ТОКЕН"

Если всё сделано правильно, API вернёт ваши данные (id, email, логин) в формате JSON.

Шаг 4. Используйте API-прокси для работы с рекламными системами

Особенность click.ru в том, что через наше API можно отправлять запросы напрямую в рекламные системы, к примеру, Яндекс.Директ, Google Ads, VK Ads. Вам не нужно разбираться в их сложных протоколах авторизации. Просто отправляете запрос на наши прокси-эндпоинты (например, /api_proxy/yandex_direct), и мы сами передадим его в нужную систему с нужными правами.

Важно знать

● Лимиты: есть ограничение на частоту вызовов — не более 5 запросов в секунду и 3600 запросов в час. Если превысите, сервер вернёт ошибку с кодом 429. Некоторые методы могут иметь свои лимиты — смотрите в описании.

● Мастер-аккаунт и пользовательские аккаунты: Мастер-аккаунт может делать запросы от имени всех своих пользователей (с помощью заголовка X-Auth-UserId). Это удобно для агентств: один код управляет всеми клиентами.

● Ошибки: Всегда обрабатывайте ответы API. В случае ошибки вы получите понятный код (401 — неверный токен, 404 — не найден аккаунт и т.д.). Полный список ошибок — по ссылке.

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

Частые вопросы

— API действительно бесплатный?
Да, API click.ru полностью бесплатен для всех зарегистрированных пользователей.

— Я авторизован под мастер-аккаунтом. Могу ли я управлять балансами пользователей?
Да, через раздел payments. Вы можете создавать счета, пополнять аккаунты пользователей и получать список их платежей.

— Мне нужно собрать статистику за прошлый месяц по всем кампаниям клиента. Это сложно?
Нет. Один запрос к эндпоинту /stat с нужными параметрами вернёт вам все данные. Мы поддерживаем выгрузку в разных разрезах — по дням, кампаниям, площадкам.

Связанные статьи

● Документация API (Swagger) — полное описание всех методов и параметров.
● Список ошибок API — коды ошибок и их расшифровка.
● Что такое мастер-аккаунт и пользовательские аккаунты — базовая архитектура click.ru для агентств.
● Как настроить автопополнение баланса — альтернатива API для тех, кто не хочет писать код.

Остались вопросы?

Напишите в поддержку — ответим в среднем за 1 минуту, работаем без выходных: чат на сайте · Telegram · support@click.ru