seo/
keyword-suggestions

Расширяйте один исходный запрос на выбранном поисковом рынке до long-tail запросов и получайте подходящие ключевые слова, доступные метрики спроса, помесячную историю и полные строки источника.

Keyword Suggestions API

Совпадение с исходной фразой
Long-tail запросы
Окна со смещением
0,1 кредита за результат
Готово
Готово

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

README

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

Keyword Suggestions

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

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

  • Полнотекстовое расширение исходной фразыВозвращает поисковые запросы, сохраняющие переданные исходные слова, допуская добавления до, после или внутри фразы и другой порядок слов.
  • Объекты замеров ключевых словСохраняет доступные объем поиска, CPC, конкуренцию в платном поиске, помесячную историю и данные о сложности в исходных данных каждой записи.
  • Контекст поискового намеренияПоказывает доступные сведения об основном и дополнительном намерении для каждого найденного ключевого слова, не выдавая их за рекомендацию по продвижению.
  • Управляемые окна результатовПринимает верхний предел результатов от 1 до 1 000 и смещение строк, отсчитываемое от нуля, чтобы получить более позднее окно источника.

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

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

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

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

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

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

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

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

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

  • Используйте конкретную исходную фразу, если нужны точно совпадающие long-tail варианты; выбирайте эндпоинт семантических ключевых слов, если запросы не обязаны содержать исходные слова.
  • Считайте offset числом строк, а не номером страницы, и увеличивайте его на размер окна источника, которое нужно пропустить.
  • Записывайте query, location_code, language_code, results_limit и offset вместе, потому что порядок в источнике со временем может меняться даже между одинаковыми запросами.
  • Сначала читайте keyword и search_intent из нормализованных полей, а затем проверяйте extra.keyword_info и extra.keyword_properties на наличие объектов прямых замеров, не вынесенных на верхний уровень.
  • Удаляйте дубли повторяющихся окон по ключевому слову вместе с рынком и языком и допускайте отсутствие любой необязательной метрики или вложенного объекта.

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

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

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

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

Keyword Suggestions API — FAQ

Keyword Suggestions API — это программный интерфейс для поиска long-tail запросов по одному исходному запросу, коду рынка и коду языка. Он возвращает подходящие ключевые слова, доступные данные о спросе и конкуренции, помесячную историю, контекст намерения и полные строки источника.

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

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

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

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