AI Model Insights

Partes agregadas del informe AI Model Insights de la aplicación. Los tres endpoints filtran por executed_at (no por created_at) y comparten una estructura de actor estándar: { type, id, competitor_id, name, domain }, con dominios simples (sin esquema).

GET`/reports/ai_model_insights/summary`

Recuentos y cuotas de menciones por modelo, recuentos y cuotas de citaciones, sentimiento neto de la marca con recuentos brutos de positivos y negativos, totales y cuotas de visibilidad ponderada, además de las matrices de actores para cada modelo.

Parámetros:

project_idobligatorio
rangepor defecto 28
from
to
granularityday|week|month
collection_id
country_code
language_code
prompt_type
brand_kindusa non_brand para coincidir con la pestaña Resumen de AI Model Insights en la app y para comparaciones justas de marca frente a competidor
competitorsCSV de IDs de competidores; los IDs desconocidos → ERR_INVALID_PARAM

GET`/reports/ai_model_insights/position_distribution`

Comparativa de distribución de posiciones utilizada en el informe AI Model Insights: una o dos series de marcas con totales por intervalos (Posición 1, Posición 2-3, Posición 4-7, Posición 8+) y series temporales listas para gráficos por intervalo.

Parámetros:

project_idobligatorio
range
from
to
granularity
collection_id
country_code
language_code
prompt_type
brand_kindusa non_brand para una comparación justa, el valor predeterminado en la app
modelrestringe a un único modelo
brand1
brand2IDs de competidores para las marcas de la comparación; omite brand1 para comparar la marca del proyecto

GET`/reports/ai_model_insights/ai_overview_results`

Datos agregados de disponibilidad de resultados de Google AI Overview: total de respuestas de AI Overview, respuestas con resultados (no_result = false), tasa de resultados, datos de tendencia listos para gráficos y una tabla paginada de tasa de resultados por prompt.

Parámetros:

project_idobligatorio
range
from
tofiltra por executed_at
collection_id
country_code
language_code
prompt_type
brand_kind
granularity
page
per_page

Ejemplos de código

Download: OpenAPI Swagger Postman

Preguntar a la IA: Abrir en ChatGPT Abrir en Claude Ver como Markdown

Idioma

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28"

const response = await fetch("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/summary?project_id=PROJECT_ID&range=28"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28"

const response = await fetch("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/position_distribution?project_id=PROJECT_ID&range=28"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50"

const response = await fetch("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/reports/ai_model_insights/ai_overview_results?project_id=PROJECT_ID&range=28&per_page=50"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());