seo/
keywords-for-site

Genere ideas de palabras clave relevantes para el dominio de un sitio web, con volumen de búsqueda, CPC, competencia de pago, búsquedas mensuales y el contexto completo en registros normalizados.

Keywords for Site API

Relevancia por dominio
Métricas de demanda de palabras clave
Registros de palabras clave normalizados
0.1 créditos por resultado
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

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ámetrosObligatorioDescripción
targetObligatorioDominio de sitio web obligatorio que se usa como fuente del tema. El Playground usa microsoft.com de forma predeterminada.
location_codeOpcionalCódigo de ubicación del mercado de búsqueda, positivo y opcional. El Playground envía 2840 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, opcional, de 2 a 10 caracteres. El Playground envía 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_limitOpcionalTope 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.

  1. Elija un dominio como target, un location_code positivo, un language_code y un results_limit de 1 a 1,000.
  2. Envíe el contenido por POST a /v1/seo/keywords-for-site 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 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 true

Casos 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.

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.

Explorar otras plataformas

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

Keywords for Site API — FAQ

Keywords for Site API es una interfaz programática que genera ideas de palabras clave a partir del dominio de un sitio web. Devuelve palabras clave normalizadas con volumen de búsqueda, CPC, competencia de pago, búsquedas mensuales y el contexto completo devuelto; la relevancia no establece un posicionamiento.

Envíe un dominio como example.com sin http:// ni https://. El endpoint acepta un sitio web como target por tarea.

No. Los términos devueltos son candidatos por relevancia, no una prueba de que el sitio web se posicione con ellos. Use Ranked Keywords cuando se requieran posiciones y las URL correspondientes.

No. results_limit acepta de 1 a 1,000 y fija el máximo de filas de una tarea, pero la entrada pública no tiene un offset para pedir una ventana de resultados posterior.

Cada palabra clave devuelta cuesta 0.1 créditos de SocQ. Una tarea sin filas devueltas no genera cargo por resultados.