Keywords for Site
Los registros de Keywords for Site conectan el tema de un sitio web con términos de búsqueda relevantes, el volumen de búsqueda, el CPC, la competencia de pago, la demanda mensual y el contexto de categoría. Estas relaciones entre palabras clave y métricas sirven para descubrir temas, investigar a la competencia, armar listas de candidatas y comparar dominios entre sí.
Funcionalidades de la Keywords for Site API
- Descubrimiento de relevancia a partir del dominioUse el dominio de un sitio web para obtener ideas de palabras clave asociadas a su tema, en lugar de partir de una frase semilla.
- Métricas de demanda y búsqueda de pagoEvalúa cada palabra clave devuelta mediante el volumen de búsqueda, el CPC, la competencia de pago, el nivel de competencia y las observaciones mensuales de búsqueda, todo normalizado.
- Contexto completo de la palabra clavePermite revisar en extra la fila completa devuelta, donde siguen accesibles las categorías opcionales, la dificultad, la intención, los campos de tendencia y otros atributos que no se incluyen en los campos normalizados.
Parámetros de la Keywords for Site API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
target | Obligatorio | Dominio de sitio web obligatorio que se usa como fuente del tema. El Playground usa microsoft.com de forma predeterminada. |
location_code | Opcional | Código de ubicación del mercado de búsqueda, positivo y opcional. El Playground envía 2840 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, opcional, de 2 a 10 caracteres. El Playground envía 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 | Tope de resultados de la fuente solicitado, de 1 a 1,000. El Playground envía 5 para coincidir con el ejemplo de la documentación; el backend usa 100 cuando se omite. |
Cómo usar la Keywords for Site API
Envíe un dominio con la configuración de mercado, idioma y límite de resultados, y luego lea los registros de palabras clave normalizados de la tarea completada.
- Elija un dominio como target, un location_code positivo, un language_code y un results_limit de 1 a 1,000.
- Envíe el contenido por POST a /v1/seo/keywords-for-site 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 siga en true.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Keywords for Site API
- Descubrimiento de temas de un sitio web: Use las palabras clave y las categorías devueltas para identificar los temas de búsqueda asociados a un sitio web conocido.
- Investigación de palabras clave de la competencia: Envíe el dominio de un competidor y combine los términos relevantes con el volumen de búsqueda, el CPC y la competencia de pago para armar un conjunto de investigación.
- Comparación de temas entre dominios: Ejecute cada sitio web por separado y compare los conjuntos de palabras clave, las categorías y las métricas de demanda devueltos.
Consejos de expertos para la Keywords for Site API
- Quite http:// y https:// de target antes de enviar el dominio, para evitar un formato de target no válido.
- Defina el mercado y el idioma de forma explícita al comparar ejecuciones, en lugar de depender del comportamiento del proveedor para los campos omitidos.
- Elija como results_limit el mayor conjunto de resultados útil en una sola solicitud, porque este endpoint no tiene offset para pedir una ventana de resultados posterior.
- Trate las métricas ausentes como no disponibles y no como cero, y revise extra cuando un atributo necesario no esté presente en los campos normalizados.
- Use Ranked Keywords en su lugar cuando la tarea requiera posiciones observadas o URL posicionadas y no ideas de palabras clave basadas en relevancia.
APIs relacionadas
Además de la Keywords for Site 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.
- 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.
- 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.
- Relevant Pages API — Inventaría las páginas indexadas de un dominio, con distribuciones de posicionamiento orgánico y de pago, tráfico modelado y contexto de costo estimado.
- Keyword Suggestions API
- Related Keywords 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