seo/
keyword-overview

Обогащайте до 1 000 известных ключевых слов на одном рынке доступными данными об объеме поиска, CPC, конкуренции в платном поиске, сложности, месячных трендах и намерении в нормализованных записях.

Keyword Overview API

Сводные метрики ключевых слов
До 1 000 ключевых слов
Спрос и конкуренция
0,15 кредита за ключевое слово
Готово
Готово

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

README

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

Keyword Overview

Сводные записи по ключевым словам объединяют поисковый спрос, конкуренцию в платном поиске, органическую сложность, помесячные наблюдения и классифицированное намерение для известных поисковых запросов. Эти взаимодополняющие показатели помогают обогащать списки запросов, сравнивать возможности, сегментировать исследования и анализировать спрос с учетом времени.

Возможности Keyword Overview API

  • Пакет известных ключевых словОценивает от 1 до 1 000 подготовленных ключевых слов в контексте одного выбранного поискового рынка и языка.
  • Поля спроса и платного поискаСохраняет доступные объем поиска, CPC, конкуренцию, уровень конкуренции, индекс конкуренции и помесячные наблюдения для сравнения спроса и платного рынка.
  • Органическая сложность и намерениеДобавляет доступные данные о сложности ключевого слова и поисковом намерении к полям спроса, чтобы разные показатели оставались связаны с одним запросом.
  • Полная строка сводкиХранит keyword_info, keyword_properties, метаданные результатов поиска и другие возвращенные объекты в extra, если они есть.

Параметры Keyword Overview API

ПараметрыОбязательныйОписание
keywordsОбязательныйОбязательный список от 1 до 1 000 известных непустых ключевых слов длиной не более 80 символов каждое.
location_codeНеобязательныйПоложительный числовой код поискового рынка. В песочнице по умолчанию используется 2840 — США.
location_nameНеобязательныйНеобязательное название поискового рынка вместо location_code. Если оно заполнено, оно имеет приоритет над location_code.
language_codeНеобязательныйКод языка поиска длиной от 2 до 10 символов, применяемый ко всему пакету. В песочнице по умолчанию используется en.
languageНеобязательныйНеобязательное название языка поиска вместо language_code. Если оно заполнено, оно имеет приоритет над language_code.
results_limitНеобязательныйНеобязательный лимит результатов от 1 до 2 000.

Как использовать Keyword Overview API

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

  1. Подготовьте от 1 до 1 000 непустых известных ключевых слов длиной не более 80 символов каждое.
  2. Отправьте keywords вместе с location_code и language_code методом POST на /v1/seo/keyword-overview и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и проверяйте extra.keyword_info или extra.keyword_properties, чтобы найти поля источника, не вынесенные на верхний уровень; следуйте next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'

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

Сценарии использования Keyword Overview API

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

Практические советы по Keyword Overview API

  • Удаляйте дубли ключевых слов перед отправкой, потому что плата рассчитывается по числу входных значений.
  • Не меняйте location_code и language_code при сравнении запросов, чтобы выбранный поисковый контекст оставался одинаковым.
  • Не указывайте results_limit: этот пакет определяется массивом keywords, а у операции сводки нет задокументированного лимита результатов.
  • Читайте extra.keyword_info и extra.keyword_properties, чтобы получить полную сводку: не каждое значение источника выносится в нормализованное поле верхнего уровня.
  • Считайте отсутствующие поля недоступными данными, а не числовым нулем, и сопоставляйте возвращенные записи по ключевому слову, а не по позиции в массиве.
  • Рассматривайте CPC и конкуренцию как показатели платного поиска, а keyword_difficulty — как оценку органической конкуренции.

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

  • Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Search Volume API — Измеряйте известные ключевые слова: доступная частотность, CPC, конкуренция в платной выдаче и история частотности по месяцам.
  • Keywords for Site API — Подбирайте ключевые слова, релевантные одному сайту, с доступными данными о спросе, помесячной историей, контекстом рынка и полными исходными строками.
  • Related Keywords API — Проходите по цепочкам связанных запросов от одного исходного запроса с контролем глубины, доступными метриками ключевых слов, интентом и полными исходными строками.
  • Search Intent API — Определяйте основной и дополнительный поисковый интент для пакета ключевых слов с сохранением исходных вероятностей и полных записей.

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

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

Keyword Overview API — FAQ

Keyword Overview API — это программный интерфейс для обогащения от 1 до 1 000 известных ключевых слов на одном поисковом рынке. Для каждого ключевого слова с данными он возвращает доступные поля спроса, конкуренции в платном поиске, органической сложности, помесячного поиска, намерения и полную строку источника.

Пакет определяется обязательным массивом keywords: от 1 до 1 000 непустых строк длиной до 80 символов каждая. location_code и language_code задают поисковый контекст, который использует песочница.

Сначала читайте нормализованные metrics, monthly_searches и search_intent, а затем проверяйте extra.keyword_info и extra.keyword_properties на наличие полей источника, не вынесенных на верхний уровень. Ключи внутри extra остаются необязательными и могут меняться.

Нет. CPC и конкуренция описывают показатели платного поиска, а keyword_difficulty оценивает конкуренцию за органические позиции; используйте каждое поле для своего сравнения.

Каждое переданное ключевое слово стоит 0,15 кредита SocQ, включая входные значения, для которых не возвращается строка. Поэтому запрос песочницы по умолчанию с двумя ключевыми словами оценивается в 0,3 кредита.