seo/
related-keywords

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

Related Keywords API

Граф связанных поисков
Управление глубиной
Замеры ключевых слов
0,1 кредита за результат
Готово
README

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

Related Keywords

Связанные ключевые слова — это запросы, соединенные через граф связанных поисковых запросов, с показателями глубины, спроса, CPC, конкуренции, сложности и намерения. Такие связи и замеры помогают находить смежные темы, расширять тематические карты и сравнивать кандидатов.

Возможности Related Keywords API

  • Расширение по графу связанных поисковПроходит прямые или рекурсивные связи запросов от одного исходного запроса с глубиной от 0 до 4 и не требует, чтобы запросы содержали исходную фразу.
  • Объекты замеров ключевых словВозвращает доступные объем поиска, CPC, конкуренцию в платном поиске, помесячную историю, сложность и намерение для каждого связанного запроса.
  • Сохраненный контекст связейХранит глубину в источнике, цепочки связанных ключевых слов, полный keyword_data и другие изменчивые поля в extra для подробного анализа графа.

Параметры Related Keywords API

ПараметрыОбязательныйОписание
queryОбязательныйОбязательное непустое исходное ключевое слово или фраза. Одна задача принимает один запрос.
location_codeНеобязательныйНеобязательный положительный числовой код поискового рынка.
location_nameНеобязательныйНеобязательное название поискового рынка вместо location_code. Если оно заполнено, оно имеет приоритет над location_code.
language_codeНеобязательныйНеобязательный код языка поиска длиной от 2 до 10 символов.
languageНеобязательныйНеобязательное название языка поиска вместо language_code. Если оно заполнено, оно имеет приоритет над language_code.
depthНеобязательныйГлубина связи от 0 до 4. Значение по умолчанию 1 возвращает напрямую связанные запросы.
results_limitНеобязательныйЗапрошенный максимум от 1 до 1 000 связанных ключевых слов. Строк может вернуться меньше.
offsetНеобязательныйЧисло строк источника (отсчет от нуля), которые нужно пропустить перед сбором запрошенного окна результатов.

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

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

  1. Выберите один непустой query, location_code, language_code, depth от 0 до 4, results_limit от 1 до 1 000 и offset не меньше 0.
  2. Отправьте данные методом POST на /v1/seo/related-keywords и сохраните возвращенный 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/related-keywords" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","depth":1,"results_limit":100}'

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

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

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

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

  • Начинайте с depth 1 для прямых связей; увеличивайте глубину, только если более широкий граф оправдывает больший и, возможно, менее точный пул кандидатов.
  • Используйте Keyword Suggestions, если каждый возвращенный запрос должен сохранять исходные слова: связанные запросы могут быть сформулированы иначе.
  • Не меняйте query, location_code, language_code и depth при сравнении окон результатов, чтобы контекст связей и рынка оставался сопоставимым.
  • Считайте offset числом строк, а не номером страницы, и увеличивайте его на число строк источника, которые нужно пропустить.
  • Сначала читайте keyword, metrics, monthly_searches и search_intent из нормализованных полей, а затем проверяйте extra на наличие глубины в источнике и цепочек связей.
  • Не делайте вывод об одинаковом намерении из близости в графе и допускайте отсутствие необязательных замеров и изменчивых полей extra.

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

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

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

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

Related Keywords API — FAQ

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

depth принимает значения от 0 до 4: 0 — сам переданный исходный запрос, 1 — прямые связи, а большие значения расширяют поиск рекурсивно. Большая глубина может дать более широкий пул кандидатов с менее прямыми связями.

Нет. Связанные поиски могут возвращать другие формулировки, поэтому, если нужны long-tail варианты с исходной фразой, используйте Keyword Suggestions.

Нормализованные записи могут содержать текст ключевого слова, объем поиска, CPC, конкуренцию в платном поиске, сложность ключевого слова, помесячную частотность и данные о намерении. Глубина связи в источнике, цепочки связей и полный объект keyword_data остаются в extra.

results_limit — верхний предел от 1 до 1 000, а offset — число предшествующих строк источника, которые нужно пропустить. offset не является номером страницы, а источник может вернуть меньше строк, чем запрошено.

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