SerpWatch
Меню

Запросы проекта

Метод API SerpWatch: все запросы проекта с группами, тегами, целевыми URL и частотой.

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

Возвращает все запросы проекта. id запроса связывает его с позициями и снимками выдачи.

Параметры

ПараметрГдеЧто значит
idв путиid проекта

Ответ

ПолеЧто значит
idid запроса
textтекст запроса
groupназвание группы или null
tagsсписок тегов
target_urlцелевая страница или null
frequencyбазовая частота Wordstat или null
frequency_exactчастота «!точной формы» или null
[
  {
    "id": 501,
    "text": "ремонт акпп калининград",
    "group": "АКПП",
    "tags": [
      "приоритет"
    ],
    "target_url": "https://site.ru/akpp",
    "frequency": 880,
    "frequency_exact": 120
  }
]

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects/12/keywords"

Python

import requests

r = requests.get("https://serpwatch.ru/api/v1/projects/12/keywords",
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

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

  • Сопоставить keyword_id из позиций с текстом запроса
  • Выгрузить ядро с группами и частотой