seo/
keyword-search-volume

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

Keyword Search Volume API

Замеры известных ключевых слов
До 1 000 ключевых слов
Помесячная история спроса
24 кредита за запрос
Готово
Готово

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

README

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

Keyword Search Volume

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

Возможности Keyword Search Volume API

  • Пакетный замер известных ключевых словИзмеряет от 1 до 1 000 подготовленных ключевых слов в одном запросе; длина каждого значения ограничена 80 символами.
  • Поля поискового спросаВозвращает доступные значения search_volume и наблюдения monthly_searches для каждого ключевого слова, по которому есть данные замера.
  • Контекст платного рынкаСвязывает доступные CPC, конкуренцию, уровень конкуренции, индекс конкуренции и необязательные поля ставок с измеренным запросом.
  • Нормализованные записи с контекстом источникаВыносит стабильные поля спроса в metrics и сохраняет всю возвращенную строку в extra для необязательных метаданных рынка и ставок.

Параметры Keyword Search Volume API

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

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

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

  1. Подготовьте от 1 до 1 000 непустых известных ключевых слов длиной не более 80 символов каждое.
  2. Отправьте keywords методом POST на /v1/seo/keyword-search-volume; добавьте location_code и language_code для воспроизводимого запроса по конкретному рынку и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и следуйте next_cursor, пока has_more равно true; поля источника, не вынесенные на верхний уровень, ищите в extra.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -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 Search Volume API

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

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

  • При необходимости объединяйте подготовленные запросы в ограниченный пакет: фиксированная плата в 24 кредита начисляется за запрос, а не за каждую возвращенную строку.
  • Указывайте location_code и language_code явно и не меняйте их при сравнении пакетов; опускайте оба поля, только если нужен общемировой охват.
  • Не передавайте results_limit: пакет этой операции определяется массивом keywords, а задокументированного лимита у нее нет.
  • Сопоставляйте возвращенные строки по ключевому слову и считайте отсутствующие записи или поля со значением null недоступными данными, а не подтвержденным нулевым спросом.
  • Рассматривайте CPC и конкуренцию как показатели платного поиска, а не как сложность органического продвижения, и учитывайте близкие варианты запросов, которые могут иметь общий агрегированный объем.

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

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

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

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

Keyword Search Volume API — FAQ

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

Обязательный массив keywords принимает от 1 до 1 000 непустых строк длиной до 80 символов каждая. location_code и language_code необязательны; если рынок и язык не указаны, бэкенд использует общемировой охват.

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

Нет. CPC, competition, competition_level, competition_index и поля ставок описывают контекст платного поиска; этот эндпоинт не рассчитывает органическую сложность ключевых слов.

Каждый отправленный запрос стоит фиксированные 24 кредита SocQ независимо от числа ключевых слов или возвращенных строк в допустимом пакете.