Добавление запросов

Метод API SerpWatch: добавить запросы в проект пачкой, сразу в нужную группу.

POST/api/v1/projects/{id}/keywords

Добавляет до 5 000 запросов за вызов. Дубли (без учёта регистра) пропускаются, лишние пробелы убираются. Если указать группу, которой нет, она будет создана. Новые запросы учитываются в лимите тарифа.

Параметры

Параметр	Где	Что значит
`id`	в пути	id проекта
`keywords`	в теле, обязательно	список запросов
`group`	в теле	название группы

Тело запроса

{
  "keywords": [
    "замена масла в акпп",
    "ремонт вариатора"
  ],
  "group": "АКПП"
}

Ответ

Поле	Что значит
`added`	сколько запросов добавлено

{
  "added": 2
}

Примеры

curl

curl -X POST -H "Authorization: Bearer sw_ваш_токен" -H "Content-Type: application/json" \
  -d '{"keywords": ["замена масла в акпп", "ремонт вариатора"], "group": "АКПП"}' \
  https://serpwatch.ru/api/v1/projects/12/keywords

Python

import requests

r = requests.post("https://serpwatch.ru/api/v1/projects/12/keywords", json={"keywords": ["замена масла в акпп", "ремонт вариатора"], "group": "АКПП"},
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

403 — гостевой доступ только для просмотра; 402 — не хватает лимита запросов по тарифу. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

Для чего пригодится

Автоматически добавлять запросы из своей CRM или таблицы
Переносить семантику из другого сервиса