Búsqueda con IAGEOMenciones en LLMGoogle AI ModeGuía de API

API de búsqueda con IA: siga las menciones en LLM, la visibilidad en IA y las respuestas de Google AI Mode

Cuatro nuevos endpoints de AI Search de SocQ devuelven las respuestas de AI Overviews y ChatGPT que citan un dominio, la cuota de voz en IA, las fuentes más citadas y las respuestas completas de Google AI Mode.

SocQActualizado el 19 de noviembre de 20269 min de lectura

Si trabaja en optimización para motores generativos (GEO), necesita datos sobre lo que dicen las respuestas de la IA: qué preguntas citan su dominio, con qué frecuencia aparece su marca junto a la competencia, en qué sitios confía la IA para su categoría y qué escribe AI Mode de Google para una búsqueda. El 2026-11-17 SocQ añadió cuatro endpoints para esto en la nueva plataforma AI Search. Esta guía explica qué devuelve cada uno, la solicitud, el precio y cuándo usarlo.

Respuesta rápida: envíe un dominio (target) o una palabra clave (query) a POST /v1/ai-search/llm-mentions, /llm-brand-metrics o /llm-top-mentioned para leer respuestas de AI Overviews o ChatGPT. Envíe una búsqueda a POST /v1/ai-search/google-ai-mode para obtener una respuesta de AI Mode con sus fuentes. Consulte GET /v1/tasks/{task_id} para obtener los resultados.

1 crédito de SocQ = $0.005.

EndpointQué devuelvePrecio
LLM Mentions APIUna fila por cada respuesta de IA que cita un dominio o menciona una palabra clave: la pregunta, la respuesta completa en Markdown, las fuentes citadas y el volumen de búsqueda en IA40 créditos ($0.20) por solicitud + 0.5 créditos ($0.0025) por respuesta
AI Search Visibility APIEl total de respuestas de IA que mencionan un dominio o una palabra clave y, después, desgloses por dominios citados, dominios de los resultados web y (en ChatGPT) marcas y categorías de marca40 créditos ($0.20) por solicitud + 0.5 créditos ($0.0025) por fila
LLM Top Sources APILos diez dominios o páginas que más citan las respuestas de IA para una palabra clave o un dominio, ordenados por menciones40 créditos ($0.20) por solicitud + 0.5 créditos ($0.0025) por dominio o página clasificados
Google AI Mode APILa respuesta completa de Google AI Mode para una búsqueda, en Markdown, con todas las fuentes citadas2 créditos ($0.01) por solicitud

En los tres endpoints de LLM, la tarifa base de 40 créditos se aplica también cuando no se encuentra nada.

Autenticación y flujo de tareas asíncronas

Todas las solicitudes de SocQ se autentican con una clave de API en el encabezado Authorization, y se usa el mismo encabezado para el envío, el estado de la tarea y la lectura de resultados:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cada recopilación se ejecuta como una tarea en segundo plano:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La respuesta del envío contiene data.task_id y data.status. Consulte el endpoint de tareas con ese ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Cuando status es succeeded, la respuesta incluye la primera página de registros normalizados en data.results.items. limit es 50 por defecto y admite hasta 500. Si has_more es true, pase results.next_cursor como cursor para leer la página siguiente. Mientras una tarea está en queued, running o failed, el endpoint devuelve los metadatos de la tarea sin results.

Un callback_url opcional en el cuerpo del envío hace que SocQ envíe un único POST con un resumen de la tarea cuando esta termina; lea los registros con GET /v1/tasks/{task_id}. Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo ID de tarea en lugar de pagar por un duplicado. 402 significa créditos insuficientes; 429 significa que la clave alcanzó un límite de frecuencia o de créditos.

LLM Mentions API: las respuestas que le citan

La LLM Mentions API enumera las preguntas en las que Google AI Overviews o ChatGPT citan su dominio, o en las que su marca o palabra clave aparece en la respuesta. Indique un dominio en target o una palabra clave en query, no ambos. platform es google (AI Overviews, el valor por defecto) o chat_gpt, que se sigue para Estados Unidos en inglés. results_limit es 100 por defecto y acepta de 1 a 1,000.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "notion.so",
    "platform": "google",
    "results_limit": 100
  }'

Cada fila es una pregunta con su respuesta. Los campos que más usará:

  • question y answer: la pregunta y la respuesta completa en Markdown.
  • ai_search_volume: número estimado de veces al mes que se hace la pregunta.
  • sources: páginas citadas con position, title, url, domain, source y text.
  • search_results y brands: resultados web que consultó la IA y marcas que nombró (solo ChatGPT).
  • fan_out_queries: búsquedas de seguimiento que ejecutó la IA.
  • first_seen_at y last_seen_at: cuándo se registró la respuesta por primera y por última vez.

Úsela para auditar su cobertura GEO, encontrar las páginas en las que confía la IA en su nicho o detectar respuestas que describen mal su producto. 100 respuestas cuestan 90 créditos ($0.45). Consulte la documentación de LLM Mentions para ver todos los campos.

AI Search Visibility API: cuota de voz en las respuestas de IA

La AI Search Visibility API es un informe de cuota de voz. La primera fila es el número total de respuestas de IA que mencionan su dominio o palabra clave y el volumen mensual de búsqueda en IA que hay detrás. Después vienen hasta 10 filas por cada desglose: los dominios que más citan las respuestas, los dominios de los resultados web que consultó la IA y, en chat_gpt, las marcas y categorías de marca nombradas en esas mismas respuestas.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-brand-metrics" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "hubspot.com",
    "platform": "chat_gpt"
  }'

Cada fila tiene una dimension (total, source_domain, search_result_domain, brand o brand_category), un name, un rank dentro de su dimensión, mentions_count y ai_search_volume. Ejecútela para su marca y dos competidores y compare a quién recomienda la IA. Un informe de ChatGPT con el total y cuatro desgloses completos tiene 41 filas, es decir, 60.5 créditos ($0.3025). Referencia de campos: documentación de AI Search Visibility.

LLM Top Sources API: los sitios que cita la IA sobre un tema

La LLM Top Sources API responde a otra pregunta: ¿qué sitios cita la IA cuando la gente pregunta por su categoría? Indique una palabra clave en query o un dominio en target. Establezca content_type en domains (el valor por defecto) o pages. results_limit es 10 por defecto, que también es el máximo.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-top-mentioned" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "crm software",
    "platform": "google",
    "content_type": "domains"
  }'

Las filas usan la misma estructura de métricas que AI Search Visibility, con dimension en domain o page. La vista por páginas es una lista ya preparada para campañas de PR digital. Diez filas clasificadas cuestan 45 créditos ($0.225). Detalles: documentación de LLM Top Sources.

Google AI Mode API: una respuesta completa con fuentes

AI Mode es la pestaña conversacional de la Búsqueda de Google que redacta una respuesta completa en lugar de enumerar enlaces. La Google AI Mode API recibe una query y devuelve esa respuesta en Markdown, junto con una lista sin duplicados de las fuentes que cita. Los valores por defecto son Estados Unidos (location_code 2840) e inglés (language_code en); cámbielos para comparar respuestas entre países e idiomas.

curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best crm for startups",
    "location_code": 2840,
    "language_code": "en"
  }'

Cada solicitud devuelve una fila con query, answer, references (posición, título, URL, dominio, fuente y extracto), location_code, language_code y la url de la página de AI Mode. A 2 créditos ($0.01) por búsqueda, es una forma económica de comprobar si sus páginas están entre las fuentes de las búsquedas que le interesan. Consulte la documentación de Google AI Mode.

Qué endpoint usar

  • "¿Qué respuestas de IA nos mencionan y qué dicen?" Use LLM Mentions.
  • "¿Qué visibilidad tenemos en las respuestas de IA frente a la competencia?" Use AI Search Visibility, una vez por dominio.
  • "¿A qué sitios deberíamos dirigirnos para que la IA nos cite?" Use LLM Top Sources con content_type: "pages".
  • "¿Qué dice Google AI Mode para esta búsqueda exacta, en este mercado?" Use Google AI Mode.

Un orden habitual es LLM Top Sources para la categoría, AI Search Visibility para usted y sus competidores y, después, LLM Mentions para leer las respuestas que hay detrás de las cifras. Para posiciones clásicas, consulte la plataforma SEO.

Preguntas frecuentes

¿Qué es una API de búsqueda con IA?

Una API que devuelve lo que dicen los motores de respuesta con IA en lugar de una lista de enlaces. La versión de SocQ cubre las respuestas de AI Overviews y ChatGPT que mencionan un dominio o una palabra clave, métricas de visibilidad, las fuentes más citadas y las respuestas completas de Google AI Mode.

¿Qué plataformas de IA se cubren?

Los tres endpoints de LLM aceptan platform con el valor google (AI Overviews, el valor por defecto) o chat_gpt. ChatGPT se sigue para Estados Unidos en inglés. Las filas de marcas y categorías de marca, los resultados web de la IA y las listas de marcas solo aparecen con chat_gpt.

¿Puedo enviar un dominio y una palabra clave en la misma solicitud?

No. LLM Mentions, AI Search Visibility y LLM Top Sources aceptan target (un dominio) o query (una palabra clave), no ambos. Haga dos solicitudes si necesita las dos vistas.

¿Se cobra cuando no se encuentra ninguna respuesta de IA?

Sí: en los tres endpoints de LLM, la tarifa base de 40 créditos se aplica aunque no se encuentre nada; los créditos por resultado solo se aplican a las filas devueltas. Google AI Mode cuesta 2 créditos por solicitud.

¿Cuánto cuesta una auditoría GEO típica?

Una solicitud de LLM Top Sources (45 créditos), tres informes de visibilidad en ChatGPT (hasta 60.5 créditos cada uno) y una solicitud de LLM Mentions de 100 respuestas (90 créditos) suman como máximo 316.5 créditos, unos $1.58. Los precios pueden cambiar, así que revise primero las páginas de los endpoints.

AI SEARCH API

Probar el flujo de trabajo con una URL pública de AI Search

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de AI Search