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 000 непустых ключевых слов длиной не более 80 символов каждое.
- Отправьте keywords и любые необязательные поля рынка, языка или results_limit методом POST на /v1/seo/search-intent и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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.
Связанные API
Помимо 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 — Проходите по цепочкам связанных запросов от одного исходного запроса с контролем глубины, доступными метриками ключевых слов, интентом и полными исходными строками.
- 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