AI Model Insights

Aggregate parts of the in-app AI Model Insights report. All three endpoints filter by executed_at (not created_at) and share a standard actor shape: { type, id, competitor_id, name, domain } with bare (scheme-less) domains.

GET`/reports/ai_model_insights/summary`

Per-model mention counts and shares, citation counts and shares, brand net sentiment with raw positive/negative counts, weighted visibility totals and shares, plus actor matrices for each.

Params:

project_idrequired
rangedefault 28
from
to
granularityday|week|month
collection_id
country_code
language_code
prompt_type
brand_kinduse non_brand to match the in-app AI Model Insights Overview tab and for fair brand-vs-competitor comparisons
competitorsCSV of competitor IDs; unknown IDs → ERR_INVALID_PARAM

GET`/reports/ai_model_insights/position_distribution`

Position-distribution comparison used in the AI Model Insights report: one or two brand series with bucketed totals (Position 1, Position 2-3, Position 4-7, Position 8+) and chart-ready time series per bucket.

Params:

project_idrequired
range
from
to
granularity
collection_id
country_code
language_code
prompt_type
brand_kinduse non_brand for a fair head-to-head, the in-app default
modelrestrict to one model
brand1
brand2competitor IDs for the comparison brands; omit brand1 to compare the project brand

GET`/reports/ai_model_insights/ai_overview_results`

Aggregate Google AI Overview result-availability data: total AI Overview responses, responses with results (no_result = false), result rate, chart-ready trend data, and a paginated by-prompt result-rate table.

Params:

project_idrequired
range
from
tofilters by executed_at
collection_id
country_code
language_code
prompt_type
brand_kind
granularity
page
per_page

Code Examples

Download: OpenAPI Swagger Postman

Ask AI: Open in ChatGPT Open in Claude View as Markdown

Language

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