seo/
keyword-difficulty

Compare la dificultad de posicionamiento orgánico de hasta 1,000 palabras clave en un mercado, con cada palabra clave disponible y su puntaje de 0–100 en registros normalizados.

Keyword Difficulty API

Hasta 1,000 palabras clave
Puntaje de dificultad de 0–100
Comparación por mercado
0.1 créditos por palabra clave
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Keyword Difficulty

Los puntajes de dificultad de la palabra clave expresan la competencia relativa estimada para posicionarse de forma orgánica en un término de búsqueda, y los valores más altos indican mayor dificultad. Estas señales a nivel de palabra clave sirven para priorizar, segmentar grupos de investigación y comparar una lista de términos ya preparada.

Funcionalidades de la Keyword Difficulty API

  • Entrada de palabras clave por loteEvalúa de 1 a 1,000 palabras clave no vacías en una sola tarea, aplicando al lote el mismo mercado e idioma seleccionados.
  • Métrica de dificultad normalizadaDevuelve cada palabra clave disponible con metrics.keyword_difficulty, normalmente expresada en una escala de 0–100 para compararla de forma directa.
  • Contexto completo de la fuenteConserva en extra la fila completa devuelta, para que los clientes puedan revisar campos adicionales de la fuente sin tratarlos como un esquema normalizado estable.

Parámetros de la Keyword Difficulty API

ParámetrosObligatorioDescripción
keywordsObligatorioLista obligatoria de 1 a 1,000 palabras clave no vacías, con un máximo de 80 caracteres por elemento.
location_codeOpcionalCódigo numérico positivo del mercado de búsqueda. El Playground usa 2840 (Estados Unidos) de forma predeterminada.
location_nameOpcionalNombre del mercado de búsqueda, opcional, como alternativa a location_code. Si se completa, tiene prioridad sobre location_code.
language_codeOpcionalCódigo del idioma de búsqueda, de 2 a 10 caracteres, aplicado a todo el lote. El Playground usa en de forma predeterminada.
languageOpcionalNombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code.
results_limitOpcionalLímite de resultados opcional, de 1 a 2,000.

Cómo usar la Keyword Difficulty API

Envíe una lista acotada de palabras clave con la configuración de mercado basada en códigos y luego lea los puntajes normalizados disponibles en la tarea asíncrona completada.

  1. Prepare de 1 a 1,000 palabras clave no vacías, cada una de un máximo de 80 caracteres.
  2. Envíe por POST keywords junto con location_code y language_code a /v1/seo/keyword-difficulty y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y luego siga next_cursor mientras has_more sea 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

Casos de uso de la Keyword Difficulty API

  • Priorización de listas de palabras clave: Compare metrics.keyword_difficulty en un conjunto de términos ya preparado para agregar una señal de competencia a la selección editorial o de investigación.
  • Segmentación por rangos de dificultad: Agrupe los puntajes devueltos en rangos definidos internamente para organizar las colas de investigación de palabras clave de menor y mayor dificultad.
  • Comparación entre mercados: Ejecute la misma lista de palabras clave con valores controlados de location_code y language_code para comparar la dificultad estimada entre contextos de búsqueda.

Consejos de expertos para la Keyword Difficulty API

  • Elimine las palabras clave duplicadas antes del envío para que los términos repetidos no generen cargos repetidos por entrada.
  • Mantenga sin cambios location_code y language_code al comparar puntajes dentro de un mismo conjunto de investigación.
  • Omita results_limit, porque este lote se controla con la lista keywords y no con un límite de resultados devueltos.
  • Relacione los resultados por palabra clave y no por posición en la lista, porque los términos no disponibles pueden omitirse de los registros devueltos.
  • Distinga un puntaje numérico de 0 de la ausencia del valor keyword_difficulty al construir rangos de puntaje.

Además de la Keyword Difficulty API, use estas APIs cuando necesite otro tipo de datos públicos de SEO.

  • Google Organic SERP API — Obtiene una página de resultados de Google en vivo por consulta y mercado, con destinos normalizados, posiciones, tipos de elemento y detalles completos de los resultados.
  • Keyword Overview API — Enriquece un lote de palabras clave enviado con el contexto disponible de demanda, competencia de pago, dificultad, búsquedas mensuales e intención.
  • Keyword Search Volume API — Mide palabras clave conocidas con el volumen de búsqueda, el CPC, la competencia de pago y el historial mensual de búsquedas disponibles.
  • Keywords for Site API — Genera palabras clave relevantes para un sitio web, con las mediciones de demanda disponibles, historial mensual, contexto de mercado y filas de origen completas.
  • Keyword Suggestions API — Amplía una consulta semilla en términos de cola larga coincidentes, con las mediciones de demanda disponibles, historial mensual, contexto de intención y filas de origen completas.
  • Search Intent API — Clasifica la intención de búsqueda principal y secundaria de un lote de palabras clave enviado, conservando las probabilidades de origen y los registros completos.

Explorar otras plataformas

Combine los datos de SEO con datos públicos de otras plataformas sociales compatibles.

Keyword Difficulty API — FAQ

Keyword Difficulty API es una interfaz programática que compara la dificultad de posicionamiento orgánico de entre 1 y 1,000 palabras clave enviadas en un mercado de búsqueda. Devuelve cada palabra clave disponible con un puntaje de dificultad normalizado de 0–100 y la fila completa de la fuente.

Una tarea acepta de 1 a 1,000 cadenas de palabras clave no vacías, de hasta 80 caracteres cada una. La lista keywords define el tamaño del lote.

No necesariamente. Una palabra clave puede omitirse o quedar sin métrica de dificultad cuando no es posible calcular un puntaje, por lo que los clientes no deben suponer una fila devuelta por cada entrada.

No. El puntaje es una estimación comparativa de la dificultad de posicionamiento orgánico en el mercado seleccionado, no una probabilidad de posicionamiento, un pronóstico de tráfico ni una recomendación específica para un sitio.

Cada palabra clave enviada cuesta 0.1 créditos de SocQ, incluidas las palabras clave para las que no hay una fila de resultados disponible. Por lo tanto, una solicitud de dos palabras clave en el Playground se estima en 0.2 créditos.