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ámetros | Obligatorio | Descripción |
|---|---|---|
keywords | Obligatorio | Lista obligatoria de 1 a 1,000 palabras clave no vacías, con un máximo de 80 caracteres por elemento. |
location_code | Opcional | Código numérico positivo del mercado de búsqueda. El Playground usa 2840 (Estados Unidos) de forma predeterminada. |
location_name | Opcional | Nombre del mercado de búsqueda, opcional, como alternativa a location_code. Si se completa, tiene prioridad sobre location_code. |
language_code | Opcional | Código del idioma de búsqueda, de 2 a 10 caracteres, aplicado a todo el lote. El Playground usa en de forma predeterminada. |
language | Opcional | Nombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code. |
results_limit | Opcional | Lí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.
- Prepare de 1 a 1,000 palabras clave no vacías, cada una de un máximo de 80 caracteres.
- Envíe por POST keywords junto con location_code y language_code a /v1/seo/keyword-difficulty y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.
- Ranked Keywords API
- Related 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