LLM Mentions
Una mención en un LLM es una pregunta que Google AI Overviews o ChatGPT responde citando un dominio o usando una palabra clave, guardada junto con la respuesta completa, las páginas citadas, el modelo que la generó y cuántas veces se hace la pregunta cada mes y, en ChatGPT, con las marcas nombradas y las búsquedas adicionales que realizó. Leídas en conjunto, estas respuestas muestran en qué preguntas una marca llega a los usuarios de IA, en qué fuentes se apoyan los modelos y dónde se describe mal un producto, lo que sirve para auditorías de GEO, planificación de contenido y comparación con la competencia.
Funcionalidades de la LLM Mentions API
- Un dominio o una palabra clave como punto de partidatarget busca respuestas que citan un dominio como notion.so y query busca respuestas que mencionan una palabra clave o un nombre de marca, para seguir tanto su sitio como la forma en que se habla de su categoría.
- La respuesta tal como la lee el usuarioanswer guarda la respuesta entera en Markdown, con títulos, listas y enlaces en línea, para citar o revisar lo que dijo el modelo.
- Cada página citadasources incluye por cada página citada su posición, título, URL, dominio, nombre del sitio y extracto, y así muestra qué contenidos formaron la respuesta.
- La demanda detrás de cada preguntaai_search_volume estima cuántas veces al mes se hace la pregunta, para distinguir menciones en preguntas muy buscadas de las que aparecen en preguntas poco frecuentes.
- Marcas, resultados web y búsquedas adicionales en ChatGPTCon platform chat_gpt, brands enumera las marcas nombradas en orden, search_results muestra las páginas que consultó ChatGPT y fan_out_queries recoge las búsquedas extra que hizo.
- Cuándo se registró cada respuestafirst_seen_at y last_seen_at fechan cada respuesta y ayudan a separar las respuestas consolidadas de las recientes.
Parámetros de la LLM Mentions API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
target | Obligatorio (al menos uno) | Dominio que se sigue en las respuestas de IA, como hubspot.com, sin ruta de página. Envíe target o query. |
query | Obligatorio (al menos uno) | Palabra clave o nombre de marca que se sigue en las respuestas de IA, como crm software, de hasta 250 caracteres. Envíe target o query. |
platform | Opcional | google lee Google AI Overviews y es el valor predeterminado; chat_gpt lee respuestas de ChatGPT para Estados Unidos en inglés. |
location_code | Opcional | Código de ubicación del mercado. Predeterminado 2840 (Estados Unidos), el mercado que cubren las respuestas de chat_gpt. |
location_name | Opcional | Nombre del mercado como alternativa a location_code. Si se completa, se usa en lugar de location_code. |
language_code | Opcional | Código de idioma de las respuestas. Predeterminado en, el idioma de las respuestas de chat_gpt. |
language | Opcional | Nombre del idioma como alternativa a language_code. Si se completa, se usa en lugar de language_code. |
results_limit | Opcional | Número máximo de respuestas, de 1 a 1000. Predeterminado 100. |
Cómo usar la LLM Mentions API
Envíe un dominio o una palabra clave y lea una fila por respuesta de IA.
- Envíe {"target": "notion.so", "platform": "google", "results_limit": 100} con POST a /v1/ai-search/llm-mentions.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las respuestas en results.items y pida la siguiente página con results.next_cursor mientras has_more sea true.
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}'Casos de uso de la LLM Mentions API
- Auditar la presencia de un dominio en respuestas de IA: Use su dominio como target, ordene por ai_search_volume y lea answer y sources para ver qué preguntas muy buscadas lo citan y cómo lo describen.
- Detectar las páginas en las que confía la IA dentro de una categoría: Use una palabra clave de la categoría en query y cuente dominios y URL de sources para armar una lista de artículos a los que proponer colaboraciones o superar.
- Comparar marcas dentro de las respuestas de ChatGPT: Con platform chat_gpt, consulte su marca y la competencia y compare brands, incluida la posición de cada una, en las mismas preguntas.
- Planificar contenido desde los ángulos ausentes: Reúna question y fan_out_queries de las respuestas donde no aparece su marca y conviértalos en briefs de páginas que los modelos puedan citar.
Consejos de expertos para la LLM Mentions API
- Consulte una marca de las dos formas, el dominio en target y el nombre en query, porque las citas de un sitio y las menciones de un nombre devuelven respuestas distintas.
- Obtenga las respuestas que necesite en una sola solicitud con un results_limit más alto, ya que la base de 40 créditos se cobra en cada solicitud.
- Guarde el id de cada fila y compare last_seen_at en la siguiente ejecución para distinguir respuestas nuevas de las ya revisadas.
APIs relacionadas
Además de la LLM Mentions API, use estas APIs cuando necesite otro tipo de datos públicos de AI Search.
- AI Search Visibility API — Mide con qué frecuencia las respuestas de IA mencionan un dominio o una palabra clave, con volumen de búsqueda en IA, dominios más citados y, en ChatGPT, las marcas que aparecen al lado.
- LLM Top Sources API — Ordena los 10 dominios o páginas que AI Overviews y ChatGPT citan más sobre una palabra clave o un dominio, por menciones y volumen de búsqueda en IA.
- Google AI Mode API — Obtiene la respuesta completa de Google AI Mode para una búsqueda en Markdown, con cada fuente citada, para cualquier país e idioma.