seo/
search-intent

Классифицируйте до 1 000 переданных ключевых слов по поисковому намерению и получайте основные и дополнительные метки с вероятностями в нормализованных записях.

Search Intent API

Пакетная передача ключевых слов
Четыре типа намерения
Основное и дополнительное намерение
0,1 кредита за ключевое слово
Готово
Готово

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

README

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

Search Intent

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

Возможности Search Intent API

  • Пакетная классификация с учетом языкаКлассифицирует до 1 000 переданных ключевых слов на одном выбранном языке; если язык не указан, используется английский.
  • Основное и дополнительные намеренияВозвращает наиболее вероятное намерение и его вероятность вместе с другими вероятными намерениями и их вероятностями.
  • Нормализованные и полные записиЧитайте нормализованные поля keyword и search_intent, а keyword_intent и secondary_keyword_intents сохраняются в extra.

Параметры Search Intent API

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

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

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

  1. Подготовьте от 1 до 1 000 непустых ключевых слов длиной не более 80 символов каждое.
  2. Отправьте keywords и любые необязательные поля рынка, языка или results_limit методом POST на /v1/seo/search-intent и сохраните возвращенный 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/search-intent" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["how to research keywords","buy seo software"],"language_code":"en"}'

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

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

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

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

  • Удаляйте пустые и повторяющиеся значения перед отправкой пакета, чтобы оплата по числу входных значений соответствовала ключевым словам, которые вы действительно хотите классифицировать.
  • При сравнении пакетов не меняйте поля рынка и языка.
  • Если у ключевого слова смешанное намерение, изучайте вероятности дополнительных намерений, а не считайте основную метку универсальным фактом.
  • Учитывайте, что классификации может не быть, и читайте extra, когда проверяете исходные объекты keyword_intent и secondary_keyword_intents.

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

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

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

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

Search Intent API — FAQ

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

Используются четыре метки: informational, navigational, commercial и transactional.

Передайте keywords, при необходимости укажите location_code или location_name, выберите language_code или language и при необходимости задайте results_limit от 1 до 2 000.

Отправьте от 1 до 1 000 непустых ключевых слов длиной не более 80 символов каждое.

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

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

Каждое переданное ключевое слово стоит 0,1 кредита SocQ.