curl --request GET \
--url https://api.heralded.ai/v1/brands/{brand_id}/scores \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.heralded.ai/v1/brands/{brand_id}/scores"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.heralded.ai/v1/brands/{brand_id}/scores', 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.heralded.ai/v1/brands/{brand_id}/scores",
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.heralded.ai/v1/brands/{brand_id}/scores"
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.heralded.ai/v1/brands/{brand_id}/scores")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.heralded.ai/v1/brands/{brand_id}/scores")
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{
"cards": [
{
"change": {
"baseline": "<string>",
"delta": 123,
"state": "up"
},
"key": "<string>",
"series": {
"introduced_at_run": 123,
"metric": "<string>",
"points": [
{
"break_label": "<string>",
"breaks": [],
"completed_at": "<string>",
"degraded": false,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"measured_domain": "<string>",
"prompts_changed": false,
"run_number": 123,
"value": 123
}
]
},
"value": 123
}
],
"engine": {
"answers": 123,
"cadence_note": "<string>",
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"competitors": [
{
"answers": 0,
"brand_key": "<string>",
"brand_name": "<string>",
"domain": "<string>",
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"is_you": true,
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"trend": {
"delta": 123,
"label": "<string>",
"state": "up"
}
}
],
"competitors_limit": 123,
"competitors_offset": 123,
"competitors_total": 123,
"display_name": "<string>",
"engine_id": "<string>",
"figures": {
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
}
},
"filters": {
"engine": "perplexity",
"intent": "educational",
"prompt": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"segment": "<string>",
"topic": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "organic"
},
"marks": [
{
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
}
],
"period": {
"excluded_reports": 123,
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"preset": "1w",
"reports": 123
},
"prompts": 123,
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
},
"score_label": "<string>",
"score_trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"sentence": "<string>",
"sources": [
{
"citation_share_pct": 123,
"citations": 123,
"domain": "<string>",
"group": "own",
"names_you": true,
"ownership": "own",
"read_pages_naming_you": 123,
"relationship_label": "<string>",
"type_label": "<string>"
}
],
"strongest_prompts": [
{
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"prompt_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
},
"text": "<string>"
}
],
"tiles": [
{
"answer_count": 123,
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
}
],
"weakest_prompts": [
{
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"prompt_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
},
"text": "<string>"
}
]
},
"engines": {
"filters": {
"engine": "perplexity",
"intent": "educational",
"prompt": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"segment": "<string>",
"topic": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "organic"
},
"limit": 123,
"menus": {
"intents": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"segments": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"topics": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"types": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
]
},
"offset": 123,
"period": {
"excluded_reports": 123,
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"preset": "1w",
"reports": 123
},
"rows": [
{
"answers": 123,
"cadence_note": "<string>",
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"display_name": "<string>",
"engine_id": "<string>",
"figures": {
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
}
},
"marks": [
{
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
}
],
"prompts": 123,
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
}
}
],
"sentence": "<string>",
"total": 123
},
"groups": [
{
"group": {
"brand_name": "<string>",
"competitor": "<string>",
"engine": "<string>",
"intent": "<string>",
"is_you": false,
"prompt": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"segment": "<string>",
"topic": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>"
},
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
}
}
],
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"menus": {
"intents": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"segments": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"topics": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"types": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
]
},
"meta": {
"data_as_of": {
"completed_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"query": {}
},
"next_cursor": "<string>",
"pane_headline": {
"describes_you": {
"n": 123,
"praised": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"high": 123,
"low": 123,
"n": 123,
"value": 123
},
"understood": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"high": 123,
"low": 123,
"n": 123,
"value": 123
}
},
"heralded_score": {
"answers": 123,
"band": "<string>",
"bands": [
{
"high": 123,
"label": "<string>",
"low": 123
}
],
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"high": 123,
"low": 123,
"value": 123
},
"mentioned": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"cohort": "run",
"high": 123,
"k": 123,
"low": 123,
"n": 123,
"rank": 123,
"rank_of": 123,
"value": 123
},
"recommended": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"cohort": "run",
"high": 123,
"k": 123,
"low": 123,
"n": 123,
"rank": 123,
"rank_of": 123,
"value": 123
}
},
"pane_prompts": [
{
"cells": [
{
"answer_read_id": "<string>",
"cited": true,
"engine_id": "<string>",
"icon_states": {
"mentioned": "yes",
"praised": "yes",
"recommended": "yes",
"understood": "yes"
},
"mentioned": true,
"praised": true,
"recommended": true,
"sentiment": "<string>",
"strength": "<string>",
"strength_label": "<string>",
"understood": 123
}
],
"intent": "<string>",
"key": "<string>",
"prompt_type": "<string>",
"query_id": "<string>",
"search_volume": 123,
"text": "<string>"
}
],
"pane_rivals": [
{
"axes": [
{
"axis": "<string>",
"denominator": 123,
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"high": 123,
"label": "<string>",
"low": 123,
"measured": true,
"numerator": 123,
"value": 123
}
],
"brand_key": "<string>",
"brand_name": "<string>",
"domain": "<string>",
"heralded_score": 123,
"is_subject": true,
"mentioned": 123,
"recommended": 123
}
],
"panes": [
{
"actions": [
{
"assignee": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"initials": "<string>",
"name": "<string>"
},
"blocked_owner": "<string>",
"check_again_on": "2023-12-25",
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"credit_cost": 123,
"delivered_at": "2023-11-07T05:31:56Z",
"demand": "<string>",
"detail": "<string>",
"dispatchable": true,
"draft_in_flight": "drafting",
"expected_impact_pts": 123,
"gate": "approval",
"group": "new",
"holder": "you",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"impact_scale": "<string>",
"intent_bucket": "<string>",
"job": {
"act_label": "<string>",
"control": "dispatch",
"current": "<string>",
"kind": "<string>",
"next_step": "<string>",
"primary_label": "<string>",
"runs_steps": true,
"stages": [
{
"doer": "heralded",
"done_at": "2023-11-07T05:31:56Z",
"key": "<string>",
"label": "<string>",
"line": "<string>"
}
],
"step": {
"hold_at_gate": true,
"label": "<string>"
},
"stopped_at": "<string>"
},
"kind": "<string>",
"looks_resolved_evidence": {},
"member": "writer",
"not_seen_since_run": 123,
"note": {
"how_well_know": "<string>",
"short_form": "<string>",
"what_i_need_from_you": "<string>",
"what_ill_do": "<string>",
"whats_happening": "<string>",
"why_it_matters": "<string>"
},
"outcome": "verified_up",
"paid_off_at": "2023-11-07T05:31:56Z",
"placed_position": 123,
"platform": false,
"preview": "<string>",
"primary_verb": "dispatch",
"progress": {
"done": 123,
"total": 123,
"unit": "<string>"
},
"prompt_movement": "<string>",
"prompt_slot_cost": 123,
"repeat": "daily",
"return_group": "new",
"route": "home",
"run_state": "scheduled",
"scheduled_at": "2023-11-07T05:31:56Z",
"scheduled_for": "2023-12-25",
"secondary_verbs": [
"dispatch"
],
"segment": "<string>",
"settled_at": "2023-11-07T05:31:56Z",
"setup_link": {
"href": "<string>",
"label": "<string>"
},
"stage": "observe",
"started_at": "2023-11-07T05:31:56Z",
"state": "new",
"target_entity": "<string>",
"target_type": "<string>",
"title": "<string>",
"tracked_domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_at": "2023-11-07T05:31:56Z",
"verified_impact_pts": 123
}
],
"answers_link": {
"href": "<string>"
},
"axis": "<string>",
"by_engine": [
{
"axis": "",
"denominator": 123,
"display": "<string>",
"engine_id": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"numerator": 123,
"value": 123
}
],
"by_intent": [
{
"axis": "",
"denominator": 123,
"display": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"intent": "<string>",
"numerator": 123,
"prompts": 123,
"value": 123
}
],
"engines": [
{
"answers_link": {
"href": "<string>"
},
"engine_id": "<string>",
"measures": [
{
"denominator": 123,
"display": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"key": "<string>",
"kind": "pct",
"label": "<string>",
"numerator": 123,
"value": 123
}
],
"prompt_order": [
"<string>"
],
"state": "<string>",
"trend": [
{
"at": "<string>",
"break_label": "<string>",
"breaks": [],
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"measured_domain": "<string>",
"prompts_changed": false,
"value": 123
}
]
}
],
"figure": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"intents": [
{
"intent": "<string>",
"mentioned": 123,
"prompt_order": [
"<string>"
],
"prompts": 123,
"prompts_total": 123,
"recommended": 123,
"search_volume": 123
}
],
"label": "<string>",
"measures": [
{
"denominator": 123,
"display": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"key": "<string>",
"kind": "pct",
"label": "<string>",
"numerator": 123,
"value": 123
}
],
"negative_quotes": [
{
"answer_read_id": "<string>",
"engine_id": "<string>",
"prompt_text": "<string>",
"quote": "<string>"
}
],
"recommended": {
"prompts_total": 123,
"who_wins": [
{
"answers": 123,
"brand_key": "<string>",
"brand_name": "<string>",
"decided_answers": 123,
"is_subject": true,
"named": 123,
"picked": 123,
"picked_answers": 123,
"prompts_won": 123
}
]
},
"state": "",
"tone_split": {
"named": 123,
"negative": 123,
"neutral": 123,
"positive": 123
},
"trend": [
{
"at": "<string>",
"break_label": "<string>",
"breaks": [],
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"measured_domain": "<string>",
"prompts_changed": false,
"value": 123
}
],
"trend_note": "<string>"
}
],
"period": {
"excluded_reports": 123,
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"preset": "1w",
"reports": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
}
}{
"code": "invalid_cursor",
"detail": "The cursor is invalid or belongs to a different query.",
"instance": "example-request-id",
"status": 400,
"title": "Bad Request",
"type": "about:blank"
}{
"code": "invalid_token",
"detail": "The Authorization header carries no API key Heralded knows: it is missing, mistyped, revoked or expired.",
"instance": "example-request-id",
"status": 401,
"title": "Unauthorized",
"type": "about:blank"
}{
"code": "not_found",
"detail": "Nothing here that this API key can read.",
"instance": "example-request-id",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}{
"code": "workspace_archived",
"detail": "The API key's organization is archived.",
"instance": "example-request-id",
"status": 409,
"title": "Conflict",
"type": "about:blank"
}{
"code": "invalid_request",
"detail": "The request's parameters are invalid; `errors` names each one.",
"errors": [
{
"loc": [
"query",
"limit"
],
"msg": "Input should be less than or equal to 100",
"type": "less_than_equal"
}
],
"instance": "example-request-id",
"status": 422,
"title": "Unprocessable Content",
"type": "about:blank"
}{
"code": "rate_limited",
"detail": "This caller is past its requests for the minute. Retry after the seconds in Retry-After.",
"instance": "example-request-id",
"rate_limit": {
"limit": 120,
"remaining": 0,
"reset": 60,
"window": 60
},
"status": 429,
"title": "Too Many Requests",
"type": "about:blank"
}Get Scores
All five figures over the selected period, with ranges, states, change and trends,
over the answers the engine, type, intent, topic, segment and prompt filters keep, and
per group under group_by. include also returns the Engines table or pane.
curl --request GET \
--url https://api.heralded.ai/v1/brands/{brand_id}/scores \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.heralded.ai/v1/brands/{brand_id}/scores"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.heralded.ai/v1/brands/{brand_id}/scores', 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.heralded.ai/v1/brands/{brand_id}/scores",
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.heralded.ai/v1/brands/{brand_id}/scores"
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.heralded.ai/v1/brands/{brand_id}/scores")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.heralded.ai/v1/brands/{brand_id}/scores")
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{
"cards": [
{
"change": {
"baseline": "<string>",
"delta": 123,
"state": "up"
},
"key": "<string>",
"series": {
"introduced_at_run": 123,
"metric": "<string>",
"points": [
{
"break_label": "<string>",
"breaks": [],
"completed_at": "<string>",
"degraded": false,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"measured_domain": "<string>",
"prompts_changed": false,
"run_number": 123,
"value": 123
}
]
},
"value": 123
}
],
"engine": {
"answers": 123,
"cadence_note": "<string>",
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"competitors": [
{
"answers": 0,
"brand_key": "<string>",
"brand_name": "<string>",
"domain": "<string>",
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"is_you": true,
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"trend": {
"delta": 123,
"label": "<string>",
"state": "up"
}
}
],
"competitors_limit": 123,
"competitors_offset": 123,
"competitors_total": 123,
"display_name": "<string>",
"engine_id": "<string>",
"figures": {
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
}
},
"filters": {
"engine": "perplexity",
"intent": "educational",
"prompt": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"segment": "<string>",
"topic": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "organic"
},
"marks": [
{
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
}
],
"period": {
"excluded_reports": 123,
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"preset": "1w",
"reports": 123
},
"prompts": 123,
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
},
"score_label": "<string>",
"score_trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"sentence": "<string>",
"sources": [
{
"citation_share_pct": 123,
"citations": 123,
"domain": "<string>",
"group": "own",
"names_you": true,
"ownership": "own",
"read_pages_naming_you": 123,
"relationship_label": "<string>",
"type_label": "<string>"
}
],
"strongest_prompts": [
{
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"prompt_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
},
"text": "<string>"
}
],
"tiles": [
{
"answer_count": 123,
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
}
],
"weakest_prompts": [
{
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"prompt_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
},
"text": "<string>"
}
]
},
"engines": {
"filters": {
"engine": "perplexity",
"intent": "educational",
"prompt": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"segment": "<string>",
"topic": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "organic"
},
"limit": 123,
"menus": {
"intents": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"segments": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"topics": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"types": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
]
},
"offset": 123,
"period": {
"excluded_reports": 123,
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"preset": "1w",
"reports": 123
},
"rows": [
{
"answers": 123,
"cadence_note": "<string>",
"change": {
"delta": 123,
"label": "<string>",
"state": "up"
},
"display_name": "<string>",
"engine_id": "<string>",
"figures": {
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
}
},
"marks": [
{
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
}
],
"prompts": 123,
"score": {
"answer_read_id": "<string>",
"answers": 123,
"band": "<string>",
"key": "<string>",
"label": "<string>",
"state": "measured",
"tooltip": "<string>",
"value": 123
}
}
],
"sentence": "<string>",
"total": 123
},
"groups": [
{
"group": {
"brand_name": "<string>",
"competitor": "<string>",
"engine": "<string>",
"intent": "<string>",
"is_you": false,
"prompt": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"segment": "<string>",
"topic": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>"
},
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
}
}
],
"heralded_score": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"mentioned": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"menus": {
"intents": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"segments": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"topics": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
],
"types": [
{
"count": 123,
"label": "<string>",
"value": "<string>"
}
]
},
"meta": {
"data_as_of": {
"completed_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"query": {}
},
"next_cursor": "<string>",
"pane_headline": {
"describes_you": {
"n": 123,
"praised": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"high": 123,
"low": 123,
"n": 123,
"value": 123
},
"understood": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"high": 123,
"low": 123,
"n": 123,
"value": 123
}
},
"heralded_score": {
"answers": 123,
"band": "<string>",
"bands": [
{
"high": 123,
"label": "<string>",
"low": 123
}
],
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"high": 123,
"low": 123,
"value": 123
},
"mentioned": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"cohort": "run",
"high": 123,
"k": 123,
"low": 123,
"n": 123,
"rank": 123,
"rank_of": 123,
"value": 123
},
"recommended": {
"change": {
"delta": 123,
"high": 123,
"low": 123,
"real": true
},
"cohort": "run",
"high": 123,
"k": 123,
"low": 123,
"n": 123,
"rank": 123,
"rank_of": 123,
"value": 123
}
},
"pane_prompts": [
{
"cells": [
{
"answer_read_id": "<string>",
"cited": true,
"engine_id": "<string>",
"icon_states": {
"mentioned": "yes",
"praised": "yes",
"recommended": "yes",
"understood": "yes"
},
"mentioned": true,
"praised": true,
"recommended": true,
"sentiment": "<string>",
"strength": "<string>",
"strength_label": "<string>",
"understood": 123
}
],
"intent": "<string>",
"key": "<string>",
"prompt_type": "<string>",
"query_id": "<string>",
"search_volume": 123,
"text": "<string>"
}
],
"pane_rivals": [
{
"axes": [
{
"axis": "<string>",
"denominator": 123,
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"high": 123,
"label": "<string>",
"low": 123,
"measured": true,
"numerator": 123,
"value": 123
}
],
"brand_key": "<string>",
"brand_name": "<string>",
"domain": "<string>",
"heralded_score": 123,
"is_subject": true,
"mentioned": 123,
"recommended": 123
}
],
"panes": [
{
"actions": [
{
"assignee": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"initials": "<string>",
"name": "<string>"
},
"blocked_owner": "<string>",
"check_again_on": "2023-12-25",
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"credit_cost": 123,
"delivered_at": "2023-11-07T05:31:56Z",
"demand": "<string>",
"detail": "<string>",
"dispatchable": true,
"draft_in_flight": "drafting",
"expected_impact_pts": 123,
"gate": "approval",
"group": "new",
"holder": "you",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"impact_scale": "<string>",
"intent_bucket": "<string>",
"job": {
"act_label": "<string>",
"control": "dispatch",
"current": "<string>",
"kind": "<string>",
"next_step": "<string>",
"primary_label": "<string>",
"runs_steps": true,
"stages": [
{
"doer": "heralded",
"done_at": "2023-11-07T05:31:56Z",
"key": "<string>",
"label": "<string>",
"line": "<string>"
}
],
"step": {
"hold_at_gate": true,
"label": "<string>"
},
"stopped_at": "<string>"
},
"kind": "<string>",
"looks_resolved_evidence": {},
"member": "writer",
"not_seen_since_run": 123,
"note": {
"how_well_know": "<string>",
"short_form": "<string>",
"what_i_need_from_you": "<string>",
"what_ill_do": "<string>",
"whats_happening": "<string>",
"why_it_matters": "<string>"
},
"outcome": "verified_up",
"paid_off_at": "2023-11-07T05:31:56Z",
"placed_position": 123,
"platform": false,
"preview": "<string>",
"primary_verb": "dispatch",
"progress": {
"done": 123,
"total": 123,
"unit": "<string>"
},
"prompt_movement": "<string>",
"prompt_slot_cost": 123,
"repeat": "daily",
"return_group": "new",
"route": "home",
"run_state": "scheduled",
"scheduled_at": "2023-11-07T05:31:56Z",
"scheduled_for": "2023-12-25",
"secondary_verbs": [
"dispatch"
],
"segment": "<string>",
"settled_at": "2023-11-07T05:31:56Z",
"setup_link": {
"href": "<string>",
"label": "<string>"
},
"stage": "observe",
"started_at": "2023-11-07T05:31:56Z",
"state": "new",
"target_entity": "<string>",
"target_type": "<string>",
"title": "<string>",
"tracked_domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_at": "2023-11-07T05:31:56Z",
"verified_impact_pts": 123
}
],
"answers_link": {
"href": "<string>"
},
"axis": "<string>",
"by_engine": [
{
"axis": "",
"denominator": 123,
"display": "<string>",
"engine_id": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"numerator": 123,
"value": 123
}
],
"by_intent": [
{
"axis": "",
"denominator": 123,
"display": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"intent": "<string>",
"numerator": 123,
"prompts": 123,
"value": 123
}
],
"engines": [
{
"answers_link": {
"href": "<string>"
},
"engine_id": "<string>",
"measures": [
{
"denominator": 123,
"display": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"key": "<string>",
"kind": "pct",
"label": "<string>",
"numerator": 123,
"value": 123
}
],
"prompt_order": [
"<string>"
],
"state": "<string>",
"trend": [
{
"at": "<string>",
"break_label": "<string>",
"breaks": [],
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"measured_domain": "<string>",
"prompts_changed": false,
"value": 123
}
]
}
],
"figure": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"breaks": [
{
"added": [],
"part": "engines",
"removed": [],
"value": "<string>"
}
],
"high": 123,
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"low": 123,
"scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "measured",
"value": 123
}
],
"value": 123
},
"intents": [
{
"intent": "<string>",
"mentioned": 123,
"prompt_order": [
"<string>"
],
"prompts": 123,
"prompts_total": 123,
"recommended": 123,
"search_volume": 123
}
],
"label": "<string>",
"measures": [
{
"denominator": 123,
"display": "<string>",
"figure": {
"denominator": 123,
"explorer_filter": {},
"numerator": 123,
"pct": 123,
"unit_label": "<string>"
},
"key": "<string>",
"kind": "pct",
"label": "<string>",
"numerator": 123,
"value": 123
}
],
"negative_quotes": [
{
"answer_read_id": "<string>",
"engine_id": "<string>",
"prompt_text": "<string>",
"quote": "<string>"
}
],
"recommended": {
"prompts_total": 123,
"who_wins": [
{
"answers": 123,
"brand_key": "<string>",
"brand_name": "<string>",
"decided_answers": 123,
"is_subject": true,
"named": 123,
"picked": 123,
"picked_answers": 123,
"prompts_won": 123
}
]
},
"state": "",
"tone_split": {
"named": 123,
"negative": 123,
"neutral": 123,
"positive": 123
},
"trend": [
{
"at": "<string>",
"break_label": "<string>",
"breaks": [],
"key": {
"answer_pack_version": 123,
"engines": [
"<string>"
],
"markets": {},
"passes": 123,
"score_version": "<string>"
},
"measured_domain": "<string>",
"prompts_changed": false,
"value": 123
}
],
"trend_note": "<string>"
}
],
"period": {
"excluded_reports": 123,
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"preset": "1w",
"reports": 123
},
"praised": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"recommended": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
},
"understood": {
"answers": 123,
"change": {
"baseline": {
"first_answer_at": "2023-11-07T05:31:56Z",
"last_answer_at": "2023-11-07T05:31:56Z",
"reports": 123
},
"cells_unpaired": 123,
"delta": 123,
"direction": "up",
"high": 123,
"low": 123,
"real": true
},
"denominator": 123,
"high": 123,
"low": 123,
"numerator": 123,
"state": "measured",
"trend": [
{
"answers": 123,
"at": "2023-11-07T05:31:56Z",
"break_label": "<string>",
"high": 123,
"low": 123,
"state": "measured",
"value": 123
}
],
"value": 123
}
}{
"code": "invalid_cursor",
"detail": "The cursor is invalid or belongs to a different query.",
"instance": "example-request-id",
"status": 400,
"title": "Bad Request",
"type": "about:blank"
}{
"code": "invalid_token",
"detail": "The Authorization header carries no API key Heralded knows: it is missing, mistyped, revoked or expired.",
"instance": "example-request-id",
"status": 401,
"title": "Unauthorized",
"type": "about:blank"
}{
"code": "not_found",
"detail": "Nothing here that this API key can read.",
"instance": "example-request-id",
"status": 404,
"title": "Not Found",
"type": "about:blank"
}{
"code": "workspace_archived",
"detail": "The API key's organization is archived.",
"instance": "example-request-id",
"status": 409,
"title": "Conflict",
"type": "about:blank"
}{
"code": "invalid_request",
"detail": "The request's parameters are invalid; `errors` names each one.",
"errors": [
{
"loc": [
"query",
"limit"
],
"msg": "Input should be less than or equal to 100",
"type": "less_than_equal"
}
],
"instance": "example-request-id",
"status": 422,
"title": "Unprocessable Content",
"type": "about:blank"
}{
"code": "rate_limited",
"detail": "This caller is past its requests for the minute. Retry after the seconds in Retry-After.",
"instance": "example-request-id",
"rate_limit": {
"limit": 120,
"remaining": 0,
"reset": 60,
"window": 60
},
"status": 429,
"title": "Too Many Requests",
"type": "about:blank"
}Authorizations
An API key, sent as Authorization: Bearer hrld_....
Path Parameters
Query Parameters
Include only scans up to this completed scan id.
1 <= x <= 100x >= 04096perplexity, gemini, openai, google_aio, ai_mode, copilot, claude organic, brand_specific, competitor_comparison educational, problem, comparison, transactional 1w, 4w, 12w, all Also state the figures per engine, intent, prompt type, topic, segment, prompt or competitor, under the same period and filters.
engine, intent, type, topic, segment, prompt, competitor Also return the Engines table, or one engine's pane with the engine filter.
engines, engine engine, score, trend, mentioned, recommended, understood, praised, answers asc, desc named, not_named 100Response
Successful Response
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
What the toolbar's four menus offer, counted over every tracked prompt rather than over the page (PR-4). A menu built from one page of ten would hide the segment the eleventh row is in.
Show child attributes
Show child attributes
Normalized query and newest included scan.
Show child attributes
Show child attributes
Pass as cursor with the same query to read the next page; null at the end.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes