Reports
Get Prompt Results
See the answer collected for each prompt, the brand metrics calculated from it, and how the results changed over time. Filter by platform, region, or date.
GET
/
v1
/
sites
/
{siteId}
/
reports
/
prompt-results
Get Prompt Results
curl --request GET \
--url https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"date": "2026-07-01",
"scanId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"promptId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "Which platform helps teams with AI discoverability?",
"category": "research",
"platform": {
"id": "chatgpt_app",
"name": "ChatGPT",
"method": "web"
},
"region": "NZ",
"responseText": "Onsomble helps teams measure and improve how their brand appears in AI answers.",
"metrics": [
{
"brand": "Acme",
"type": "brand",
"visibility": 62.5,
"shareOfVoice": 41.2,
"sentiment": 62,
"mentionCount": 3
}
]
}
],
"trends": [
{
"promptId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "Which platform helps teams with AI discoverability?",
"platform": {
"id": "chatgpt_app",
"name": "ChatGPT",
"method": "web"
},
"region": "NZ",
"points": [
{
"date": "2026-07-01",
"scanId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"metrics": [
{
"brand": "Acme",
"type": "brand",
"visibility": 62.5,
"shareOfVoice": 41.2,
"sentiment": 62,
"mentionCount": 3
}
]
}
]
}
],
"filters": {
"platform": [
"chatgpt_app",
"chatgpt_api"
],
"region": [
"NZ",
"AU"
],
"startDate": "2026-07-01",
"endDate": "2026-07-31"
}
}Authorizations
An API key created in Settings → Account → API Keys.
Path Parameters
Query Parameters
Repeat to select AI platforms and collection methods, for example ?platform=chatgpt_app&platform=chatgpt_api. Omit to include every platform.
Available options:
claude_api, chatgpt_api, gemini_api, perplexity_sonar_pro, chatgpt_app, gemini_app, google_ai_summaries_app, google_ai_mode_app, microsoft_copilot_app, perplexity_app Example:
["chatgpt_app", "chatgpt_api"]
Repeat to select regions, for example ?region=NZ®ion=AU. Omit to include all regions.
Example:
["NZ", "AU"]
Inclusive ISO calendar-date lower bound. Omit to include all earlier report data.
Example:
"2026-07-01"
Inclusive ISO calendar-date upper bound. Omit to include all later report data.
Example:
"2026-07-31"
⌘I
Get Prompt Results
curl --request GET \
--url https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.onsomble.ai/v1/sites/{siteId}/reports/prompt-results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"date": "2026-07-01",
"scanId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"promptId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "Which platform helps teams with AI discoverability?",
"category": "research",
"platform": {
"id": "chatgpt_app",
"name": "ChatGPT",
"method": "web"
},
"region": "NZ",
"responseText": "Onsomble helps teams measure and improve how their brand appears in AI answers.",
"metrics": [
{
"brand": "Acme",
"type": "brand",
"visibility": 62.5,
"shareOfVoice": 41.2,
"sentiment": 62,
"mentionCount": 3
}
]
}
],
"trends": [
{
"promptId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "Which platform helps teams with AI discoverability?",
"platform": {
"id": "chatgpt_app",
"name": "ChatGPT",
"method": "web"
},
"region": "NZ",
"points": [
{
"date": "2026-07-01",
"scanId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"metrics": [
{
"brand": "Acme",
"type": "brand",
"visibility": 62.5,
"shareOfVoice": 41.2,
"sentiment": 62,
"mentionCount": 3
}
]
}
]
}
],
"filters": {
"platform": [
"chatgpt_app",
"chatgpt_api"
],
"region": [
"NZ",
"AU"
],
"startDate": "2026-07-01",
"endDate": "2026-07-31"
}
}