Proporcionado por DataForSEO
Obtén métricas de menciones de IA para un objetivo con DataForSEO
Consulta el número de menciones y el volumen de búsqueda de IA de una o más palabras clave o dominios en Google AI Overviews y las respuestas de ChatGPT como un único objeto de desglose: totales por ubicación, idioma y plataforma; los dominios de origen y los dominios de resultados de búsqueda citados con mayor frecuencia; las entidades de marca y categorías de marca mencionadas con mayor frecuencia; y el total general. Una solicitud por llamada, con el precio de la tarifa propia del proveedor; un conjunto de resultados vacío se informa como sin resultados. La ubicación predeterminada es Estados Unidos (location_code 2840); las respuestas de ChatGPT existen para Estados Unidos únicamente en inglés, y se rechaza una ubicación que no esté en la lista de ubicaciones de LLM Mentions de DataForSEO.
Cómo ejecutarlo
Paso 1Configurar
Una vez: pega esto en el chat de tu agente. Skill instala el CLI e inicia sesión por sí solo. Si tu agente no puede usar un shell, conéctalo mediante MCP en su lugar.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/ai_optimization/llm_mentions/target_metrics/live on Glasser.glasser run -p dataforseo -e '/v3/ai_optimization/llm_mentions/target_metrics/live' -i '{"target":[{"keyword":"bmw","search_scope":["answer"]}],"language_code":"en","location_code":2840}' --endpoint-version 1Usa la versión de endpoint 1. Comprueba el precio actual antes de ejecutar. Instala e inicia sesión primero en Comenzar.
Una vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Ejecútalo y copia este mismo bloque para volver a enviarlo:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/ai_optimization/llm_mentions/target_metrics/live","input":{"target":[{"keyword":"bmw","search_scope":["answer"]}],"language_code":"en","location_code":2840},"endpoint_version":1}'Reutiliza la misma Idempotency-Key para volver a enviarlo: el segundo envío es una lectura del primer Run. Una clave nueva crea un Run y un Charge nuevos. Usa la versión de endpoint 1; comprueba el precio actual antes de ejecutar.
Paso 2Prueba una tarea de ejemplo específica
Cuando necesites informar sobre la visibilidad de una marca en respuestas de IA, puedes buscar menciones de tu marca en los datos disponibles y recopilar las pruebas que las respalden.
Copia este prompt en tu agente para revisar pruebas para tu informe de visibilidad en IA.
Use dataforseo:/v3/ai_optimization/llm_mentions/target_metrics/live on Glasser.
Find evidence of my brand in the returned AI visibility data for my monitoring report.Estructura del endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"location_code",
"language_code",
"target"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"target": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"pattern": "^(?!https?:\\/\\/)(?!www\\.)[a-z0-9.-]+$",
"maxLength": 63,
"minLength": 1
},
"search_scope": {
"type": "array",
"items": {
"enum": [
"any",
"sources",
"search_results"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
},
"search_filter": {
"enum": [
"include",
"exclude"
],
"type": "string"
},
"include_subdomains": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"maxLength": 250,
"minLength": 1
},
"match_type": {
"enum": [
"word_match",
"partial_match"
],
"type": "string"
},
"search_scope": {
"type": "array",
"items": {
"enum": [
"any",
"question",
"answer",
"brand_entities",
"fan_out_queries"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1
},
"search_filter": {
"enum": [
"include",
"exclude"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 10,
"minItems": 1
},
"platform": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"location_code": {
"type": "integer"
},
"internal_list_limit": {
"type": "integer"
}
},
"additionalProperties": false
}{
"target": [
{
"keyword": "bmw",
"search_scope": [
"answer"
]
}
],
"language_code": "en",
"location_code": 2840
}Este endpoint no publica ningún esquema de salida. Recibes el cuerpo de respuesta propio del proveedor de datos, sin cambios — no garantizamos una estructura que no podemos asegurar.
Cómo funcionan los precios
| Datos devueltos o sin coincidencias | El mismo precio con o sin datos coincidentes. | $0.101 |
|---|---|---|
| Error del proveedor de datos | El proveedor de datos no pudo responder. | $0.00 |
| Tiempo de espera agotado | El Run superó su límite de tiempo. | $0.00 |
| Error interno | Un error interno impidió completar la operación. | $0.00 |