# PromoPult API — с чего начать работу

С помощью API promopult.ru можно автоматизировать рутинные операции, выгружать статистику в сторонние системы и решать другие задачи.

# [0.6.6] - 2026-08-14

# Добавлено

  • Новый метод POST /project/seo/{projectId}/keywords/update для пакетного изменения бюджета и целевой страницы слов SEO проекта
  • Новый метод POST /project/ppc/{projectId}/keywords/update для пакетного изменения слов PPC проекта

# [0.6.5] - 2026-08-13

# Изменено

  • В ответах POST /project/ppc, POST /project/ppc/{projectId}/update, GET /project/ppc/{projectId} и GET /projects?type=PPC поле regionId для PPC заменено на regionIds со списком регионов из настроек геотаргетинга проекта
  • В запросах POST /project/ppc и POST /project/ppc/{projectId}/update для PPC поле regionId заменено на regionIds, а само API теперь принимает и возвращает regionIds в формате yandex region id

# [0.6.4] - 2026-08-12

# Добавлено

  • В POST /project/ppc добавлена возможность передавать стартовый бюджет проекта
  • Новый метод POST /project/ppc/{projectId}/update для изменения данных PPC проекта

# Удалено

  • Поле maxBudget из запросов создания и изменения слова PPC проекта и из ответа со словом

Использовать API могут все зарегистрированные пользователи Системы. API является бесплатным.

# Ограничения

На вызовы методов API существуют ограничения:

В случае превышения лимита будет отдан http-код ответа 429.

Также для отдельных методов могут применяться другие ограничения вызовов. Эта информация содержится в описании метода.

# Авторизация

# Как получить токен

Токен для запросов можно получить в профиле пользователя. Токен можно пересоздавать, в этом случае старый токен будет неактивен.

# Использование

Токен передаём в HTTP заголовке X-Auth-Token.

Пример: X-Auth-Token: 1234567890

В случае ошибки авторизации (неправильный токен, неактивный) будет отдан код ответа 401.

# Запросы к API

В качестве формат взаимодействия мы используем JSON.

# Запрос со страницы описания метода через cURL

Пример получения профиля пользователя:

Командная строка:

curl -X GET "https://api.promopult.ru/V0/user"
     -H "Accept: application/json"
     -H "X-Auth-Token: 1234567890"

Вернёт:

{
  "response": {
    "id": 10001,
    "email": "user@example.com",
    "login": "test123",
    "first_name": "Александр",
    "last_name": "Александров",
    "middle_name": "Александрович",
    "phone": "+79991234567",
    "billing": {
      "balance": 0,
      "blocked": 0
    }
  }
}