seo/
keyword-difficulty

Сравнивайте сложность органического продвижения до 1 000 ключевых слов на одном рынке и получайте каждое доступное ключевое слово с оценкой от 0 до 100 в нормализованных записях.

Keyword Difficulty API

До 1 000 ключевых слов
Оценка сложности 0–100
Сравнение по рынкам
0,1 кредита за ключевое слово
Готово
Готово

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

README

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

Keyword Difficulty

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

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

  • Пакетная передача ключевых словОценивает от 1 до 1 000 непустых ключевых слов в одной задаче, применяя ко всему пакету один выбранный рынок и язык.
  • Нормализованная метрика сложностиВозвращает каждое доступное ключевое слово с metrics.keyword_difficulty, обычно по шкале от 0 до 100 для прямого сравнения.
  • Полный контекст источникаСохраняет всю возвращенную строку в extra, чтобы клиенты могли изучать дополнительные поля источника, не считая их стабильной нормализованной схемой.

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

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

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

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

  1. Подготовьте от 1 до 1 000 непустых ключевых слов длиной не более 80 символов каждое.
  2. Отправьте keywords вместе с location_code и language_code методом POST на /v1/seo/keyword-difficulty и сохраните возвращенный 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-difficulty" \
  -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 Difficulty API

  • Приоритизация списка ключевых слов: Сравнивайте metrics.keyword_difficulty в подготовленном наборе запросов, чтобы добавить показатель конкуренции в редакционный или исследовательский отбор.
  • Сегментация по уровням сложности: Группируйте возвращенные оценки по внутренним диапазонам, чтобы разделить очереди исследования ключевых слов с низкой и высокой сложностью.
  • Сравнение рынков: Запускайте один и тот же список ключевых слов с контролируемыми значениями location_code и language_code, чтобы сравнивать ожидаемую сложность в разных поисковых контекстах.

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

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

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

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

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

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

Keyword Difficulty API — FAQ

Keyword Difficulty API — это программный интерфейс для сравнения сложности органического продвижения по 1–1 000 переданным ключевым словам на одном поисковом рынке. Он возвращает каждое доступное ключевое слово с нормализованной оценкой сложности от 0 до 100 и полной строкой источника.

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

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

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

Каждое переданное ключевое слово стоит 0,1 кредита SocQ, включая ключевые слова, для которых нет строки результата. Поэтому запрос из песочницы с двумя ключевыми словами оценивается в 0,2 кредита.