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ámetros | Obligatorio | Descripción |
|---|---|---|
keywords | Obligatorio | Lista obligatoria de 1 a 1,000 palabras clave no vacías, cada una de un máximo de 80 caracteres. |
location_code | Opcional | Código de ubicación positivo del mercado de búsqueda, opcional. |
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 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 | Tope 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.
- 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 y los campos opcionales de mercado, idioma o results_limit a /v1/seo/search-intent 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/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 trueCasos 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.
APIs relacionadas
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.
- Keywords for Site API
- Ranked 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