AI Model Insights

Partes agregadas do relatório AI Model Insights da aplicação. Os três endpoints filtram por executed_at (não created_at) e partilham uma estrutura de ator padrão: { type, id, competitor_id, name, domain }, com domínios simples (sem esquema).

GET`/reports/ai_model_insights/summary`

Contagens e quotas de menções por modelo, contagens e quotas de citações, sentimento líquido da marca com contagens brutas de positivo/negativo, totais e quotas de visibilidade ponderada, além de matrizes de intervenientes para cada um.

Parâmetros:

project_idobrigatório
rangepredefinição 28
from
to
granularityday|week|month
collection_id
country_code
language_code
prompt_type
brand_kindutilize non_brand para corresponder ao separador Overview do AI Model Insights na aplicação e para comparações justas entre marca e concorrente
competitorsCSV de IDs de concorrentes; IDs desconhecidos → ERR_INVALID_PARAM

GET`/reports/ai_model_insights/position_distribution`

Comparação da distribuição de posições utilizada no relatório AI Model Insights: uma ou duas séries de marcas com totais agrupados por intervalo (Posição 1, Posição 2-3, Posição 4-7, Posição 8+) e séries temporais prontas para gráficos por intervalo.

Parâmetros:

project_idobrigatório
range
from
to
granularity
collection_id
country_code
language_code
prompt_type
brand_kindutilize non_brand para uma comparação direta justa, a predefinição na aplicação
modelrestringir a um modelo
brand1
brand2IDs de concorrentes para as marcas de comparação; omita brand1 para comparar com a marca do projeto

GET`/reports/ai_model_insights/ai_overview_results`

Dados agregados de disponibilidade de resultados do Google AI Overview: total de respostas do AI Overview, respostas com resultados (no_result = false), taxa de resultados, dados de tendência prontos para gráficos e uma tabela paginada de taxa de resultados por prompt.

Parâmetros:

project_idobrigatório
range
from
tofiltra por executed_at
collection_id
country_code
language_code
prompt_type
brand_kind
granularity
page
per_page

Exemplos de código

Download: OpenAPI Swagger Postman

Perguntar à IA: Abrir no ChatGPT Abrir no Claude Ver como Markdown

Linguagem

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());

AI Model Insights

GET/reports/ai_model_insights/summary

GET/reports/ai_model_insights/position_distribution

GET/reports/ai_model_insights/ai_overview_results

GET`/reports/ai_model_insights/summary`

GET`/reports/ai_model_insights/position_distribution`

GET`/reports/ai_model_insights/ai_overview_results`