seo/
search-intent

Clasifique hasta 1,000 palabras clave enviadas según su intención de búsqueda, con etiquetas primarias y secundarias y sus probabilidades en registros de palabras clave normalizados.

Search Intent API

Entrada de palabras clave por lote
Cuatro etiquetas de intención
Intención primaria y secundaria
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

Search Intent

La intención de búsqueda describe una consulta mediante etiquetas informacionales, navegacionales, comerciales o transaccionales, junto con señales de probabilidad primaria y secundaria. Estas clasificaciones sirven para etiquetar inventarios de palabras clave, revisar intenciones mixtas, alinear briefs de contenido y dirigir listas de palabras clave preparadas hacia los flujos de investigación.

Funcionalidades de la Search Intent API

  • Clasificación por lote según el idiomaClasifica hasta 1,000 palabras clave enviadas en un idioma seleccionado, y usa inglés cuando no se indica ningún idioma.
  • Señales de intención primaria y secundariaDevuelve la intención más probable y su probabilidad, junto con otras intenciones posibles y sus probabilidades.
  • Registros normalizados y completosPermite leer los campos normalizados keyword y search_intent, mientras conserva keyword_intent y secondary_keyword_intents en extra.

Parámetros de la Search Intent API

ParámetrosObligatorioDescripción
keywordsObligatorioLista obligatoria de 1 a 1,000 palabras clave no vacías, cada una de un máximo de 80 caracteres.
location_codeOpcionalCódigo de ubicación positivo del mercado de búsqueda, opcional.
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 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_limitOpcionalTope de resultados opcional, de 1 a 2,000.

Cómo usar la Search Intent API

Envíe una lista de palabras clave con la configuración opcional de mercado, idioma y límite de resultados, y luego lea los registros de intención normalizados de 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 y los campos opcionales de mercado, idioma o results_limit a /v1/seo/search-intent 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/search-intent" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["how to research keywords","buy seo software"],"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 Search Intent API

  • Etiquetado de inventarios de palabras clave: Use cada palabra clave y su intención primaria para agregar etiquetas de intención uniformes a un inventario de palabras clave ya preparado.
  • Revisión de intenciones mixtas: Compare las etiquetas primarias y secundarias con sus probabilidades para identificar las palabras clave que pueden representar más de un objetivo de búsqueda.
  • Dirección hacia flujos de investigación: Agrupe las palabras clave enviadas por intención informacional, navegacional, comercial o transaccional antes de dirigirlas hacia flujos de investigación separados.

Consejos de expertos para la Search Intent API

  • Quite las entradas vacías y duplicadas antes de enviar un lote, para que la facturación por cantidad de entradas refleje las palabras clave que desea clasificar.
  • Mantenga uniformes los campos de mercado e idioma al comparar lotes.
  • Revise las probabilidades de la intención secundaria cuando una palabra clave tenga intención mixta, en lugar de tratar la etiqueta primaria como un hecho universal.
  • Admita que falten clasificaciones y lea extra al auditar los objetos originales keyword_intent y secondary_keyword_intents.

Además de la Search Intent 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.
  • 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.
  • Related Keywords API — Sigue rutas de búsquedas relacionadas a partir de una consulta semilla con controles de profundidad, mediciones de palabras clave disponibles, contexto de intención y filas de origen completas.

Explorar otras plataformas

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

Search Intent API — FAQ

Search Intent API es una interfaz programática que clasifica hasta 1,000 palabras clave enviadas en un idioma seleccionado. Devuelve etiquetas de intención primaria y secundaria normalizadas, con sus probabilidades, para cada palabra clave disponible.

Las cuatro etiquetas son informacional, navegacional, comercial y transaccional.

Envíe keywords, defina opcionalmente location_code o location_name, elija language_code o language y use results_limit de 1 a 2,000 cuando sea necesario.

Envíe de 1 a 1,000 palabras clave no vacías, con una longitud máxima de 80 caracteres por palabra clave.

Es el nivel de confianza dentro de la clasificación de intención, no una probabilidad de compra ni una tasa de conversión. Por eso, las palabras clave de intención mixta pueden incluir clasificaciones secundarias relevantes.

No. Algunas palabras clave enviadas pueden no producir una clasificación, así que relacione los registros devueltos por palabra clave y maneje las filas ausentes.

Cada palabra clave enviada cuesta 0.1 créditos de SocQ.