Keyword Search Volume
Los registros de volumen de búsqueda de palabras clave asocian términos de búsqueda conocidos con la demanda estimada, el CPC, la competencia de pago y las observaciones mensuales de un contexto de búsqueda seleccionado o mundial. Estas mediciones sirven para comparar la demanda, revisar la estacionalidad, investigar el mercado de pago y enriquecer listas de términos.
Funcionalidades de la Keyword Search Volume API
- Medición por lote de palabras clave conocidasMide de 1 a 1,000 palabras clave preparadas en una sola solicitud, con cada entrada limitada a 80 caracteres.
- Campos de demanda de búsquedaDevuelve los valores de search_volume y las observaciones de monthly_searches disponibles para cada palabra clave que tenga datos de medición.
- Contexto del mercado de pagoMantiene vinculados al término medido el CPC, la competencia, el nivel de competencia, el índice de competencia y los campos opcionales de puja disponibles.
- Registros normalizados con contexto de la fuenteIncluye los campos de demanda estables en metrics y conserva en extra la fila completa devuelta, con los metadatos opcionales de mercado y puja.
Parámetros de la Keyword Search Volume API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
keywords | Obligatorio | Lista obligatoria de 1 a 1,000 palabras clave conocidas y 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, opcional. El Playground envía 2840 (Estados Unidos) de forma explícita; deje este campo vacío junto con language_code para usar el alcance mundial del backend. |
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, opcional, de 2 a 10 caracteres. El Playground envía en de forma explícita; deje este campo vacío junto con location_code para usar el alcance mundial del backend. |
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 Search Volume API
Envíe una lista acotada de palabras clave conocidas con la configuración opcional de mercado e idioma y luego lea los campos de demanda normalizados en los registros de resultados asíncronos.
- Prepare de 1 a 1,000 palabras clave conocidas y no vacías, cada una de un máximo de 80 caracteres.
- Envíe keywords por POST a /v1/seo/keyword-search-volume; incluya location_code y language_code para una solicitud reproducible específica de un mercado 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 siga next_cursor mientras has_more sea true; revise extra para ver los campos de la fuente que no se incluyen en los campos normalizados.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
-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 Search Volume API
- Comparación de demanda en una lista preparada: Relacione los valores de search_volume a una lista de términos conocida y compare la demanda estimada dentro de un contexto de búsqueda uniforme.
- Revisión de estacionalidad mensual: Use las observaciones de year, month y search_volume para examinar los cambios de la demanda medida a lo largo del tiempo.
- Investigación del panorama de búsqueda de pago: Compare el CPC, la competencia, el índice de competencia y el contexto opcional de puja entre las palabras clave medidas.
Consejos de expertos para la Keyword Search Volume API
- Agrupe los términos preparados en un lote acotado cuando corresponda, porque el cargo fijo de 24 créditos se aplica a la solicitud y no a cada fila devuelta.
- Mantenga location_code y language_code explícitos y sin cambios al comparar lotes; omita ambos solo cuando se busque el alcance mundial.
- No envíe results_limit, porque la lista keywords controla el lote de esta operación y la operación no tiene un control de límite documentado.
- Relacione las filas devueltas por palabra clave y trate los registros ausentes o los campos nulos como datos no disponibles y no como una demanda cero confirmada.
- Interprete el CPC y la competencia como señales de búsqueda de pago y no como dificultad de posicionamiento orgánico, y tenga en cuenta que las variantes cercanas pueden compartir un volumen agregado.
APIs relacionadas
Además de la Keyword Search Volume 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 Difficulty API — Compara la dificultad de posicionamiento orgánico de un lote de palabras clave enviado, y devuelve cada palabra clave disponible con su puntuación normalizada.
- 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.
- 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.
- Ranked Keywords API — Encuentra las palabras clave para las que se posiciona un dominio, subdominio o página, con las URLs correspondientes, posiciones, mediciones de búsqueda, intención y elementos de origen completos.
- Related Keywords API
- Relevant Pages API
- Search Intent 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