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
Отправьте один исходный запрос с глубиной связи, настройками рынка и ограниченным окном результатов, а затем читайте связанные записи из завершенной асинхронной задачи.
- Выберите один непустой query, location_code, language_code, depth от 0 до 4, results_limit от 1 до 1 000 и offset не меньше 0.
- Отправьте данные методом POST на /v1/seo/related-keywords и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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.
Связанные API
Помимо 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 — Определяйте основной и дополнительный поисковый интент для пакета ключевых слов с сохранением исходных вероятностей и полных записей.
- Keywords for Site API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API