seo/
keywords-for-site

Получайте идеи ключевых слов, релевантные одному домену сайта: объем поиска, CPC, конкуренция в платном поиске, помесячная частотность и полный контекст в нормализованных записях.

Keywords for Site API

Релевантность домену
Метрики спроса
Нормализованные записи ключевых слов
0,1 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Keywords for Site

Записи Keywords for Site связывают тематику сайта с релевантными поисковыми запросами, объемом поиска, CPC, конкуренцией в платном поиске, помесячным спросом и категориями. Эти связи между ключевыми словами и метриками помогают находить темы, исследовать конкурентов, составлять списки кандидатов и сравнивать домены между собой.

Возможности Keywords for Site API

  • Поиск релевантных запросов по доменуИспользуйте один домен сайта, чтобы получить идеи ключевых слов, связанные с его тематикой, а не начинать с исходной фразы.
  • Метрики спроса и платного поискаОценивайте каждое возвращенное ключевое слово по нормализованным объему поиска, CPC, конкуренции в платном поиске, уровню конкуренции и помесячным наблюдениям.
  • Полный контекст ключевого словаИзучайте в extra всю возвращенную строку, где остаются доступны необязательные категории, сложность, намерение, тренды и другие атрибуты, не вынесенные на верхний уровень.

Параметры Keywords for Site API

ПараметрыОбязательныйОписание
targetОбязательныйОбязательный домен сайта, который служит источником тематики. В песочнице по умолчанию используется microsoft.com.
location_codeНеобязательныйНеобязательный положительный код локации поискового рынка. Песочница по умолчанию отправляет 2840.
location_nameНеобязательныйНеобязательное название поискового рынка вместо location_code. Если оно заполнено, оно имеет приоритет над location_code.
language_codeНеобязательныйНеобязательный код языка поиска длиной от 2 до 10 символов. Песочница по умолчанию отправляет en.
languageНеобязательныйНеобязательное название языка поиска вместо language_code. Если оно заполнено, оно имеет приоритет над language_code.
results_limitНеобязательныйЗапрошенный верхний предел результатов источника от 1 до 1 000. Песочница отправляет 5, как в примере из документации; если значение не указано, бэкенд использует 100.

Как использовать Keywords for Site API

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

  1. Выберите один домен в target, положительный location_code, language_code и results_limit от 1 до 1 000.
  2. Отправьте данные методом POST на /v1/seo/keywords-for-site и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и следуйте next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Keywords for Site API

  • Поиск тем сайта: Используйте возвращенные ключевые слова и категории, чтобы определить поисковые темы, связанные с известным сайтом.
  • Исследование ключевых слов конкурентов: Передайте домен конкурента и сочетайте релевантные запросы с объемом поиска, CPC и конкуренцией в платном поиске, чтобы собрать исследовательский набор.
  • Сравнение тематики разных доменов: Запускайте задачи по сайтам по отдельности и сравнивайте возвращенные наборы ключевых слов, категории и метрики спроса.

Практические советы по Keywords for Site API

  • Удаляйте http:// и https:// из target перед отправкой домена, чтобы избежать недопустимого формата target.
  • При сравнении запусков задавайте рынок и язык явно, а не полагайтесь на поведение поставщика для незаполненных полей.
  • Выбирайте results_limit как наибольший полезный набор результатов за один раз: у этого эндпоинта нет offset для запроса более позднего окна результатов.
  • Считайте отсутствующие метрики недоступными, а не нулевыми, и проверяйте extra, если нужного атрибута нет среди нормализованных полей.
  • Если задача требует фактических позиций или URL в выдаче, а не идей ключевых слов по релевантности, используйте Ranked Keywords.

Помимо Keywords for Site API, используйте эти API, когда нужен другой тип публичных данных SEO.

  • Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
  • Keyword Search Volume API — Измеряйте известные ключевые слова: доступная частотность, CPC, конкуренция в платной выдаче и история частотности по месяцам.
  • Ranked Keywords API — Находите ключевые слова, по которым ранжируется домен, поддомен или страница: соответствующие URL, позиции, поисковые метрики, интент и полные исходные элементы.
  • Relevant Pages API — Составляйте перечень проиндексированных страниц одного домена с распределением позиций в органической и платной выдаче, расчетным трафиком и оценкой стоимости.

Другие платформы

Объединяйте данные SEO с публичными данными других поддерживаемых соцсетей.

Keywords for Site API — FAQ

Keywords for Site API — это программный интерфейс для получения идей ключевых слов по одному домену сайта. Он возвращает нормализованные ключевые слова с объемом поиска, CPC, конкуренцией в платном поиске, помесячной частотностью и полным возвращенным контекстом; релевантность не означает наличия позиций в выдаче.

Передайте один домен, например example.com, без http:// или https://. Эндпоинт принимает один сайт на задачу.

Нет. Возвращенные запросы — это кандидаты по релевантности, а не доказательство того, что сайт по ним ранжируется. Используйте Ranked Keywords, если нужны позиции и соответствующие URL.

Нет. results_limit принимает значения от 1 до 1 000 и задает максимум строк для одной задачи, но у публичных входных данных нет offset для запроса более позднего окна результатов.

Каждое возвращенное ключевое слово стоит 0,1 кредита SocQ. За задачу без возвращенных строк плата за результаты не взимается.