curl https://www.thesapientcompany.com/api/v1/intelligence \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl "https://www.thesapientcompany.com/api/v1/intelligence?q=attention" \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"scan_count": 4,
"lens_averages": { "attention": 67, "purchase_intent": 60, "manipulation": 48 },
"avg_lens_curves": {
"attention": [76, 76, 76, 76, 76, 76, 75, 75, 75, 74 /* … one value per second */],
"purchase_intent": [63, 63, 63, 63, 62, 63, 63, 63, 63, 63 /* … */],
"manipulation": [52, 52, 52, 52, 52, 51, 51, 52, 51, 51 /* … */]
},
"recurring_drop_seconds": [
{ "second": 58, "lens": "attention", "count": 4 },
{ "second": 5, "lens": "manipulation", "count": 3 },
{ "second": 12, "lens": "purchase_intent", "count": 2 }
// … ranked by count
],
"query": "attention",
"recall": [
{
"scan_id": "mary_run_mq7ahu4h_bbihywp3",
"kind": "moment",
"lens": "attention",
"second": 56,
"text": "Attention slipped here (59) as the clip wound down.",
"score": 0.3056,
"created_at": "2026-06-09T23:50:57.599Z"
}
// … up to 8 hits
]
}
Concepts
Intelligence
Your org’s accumulated cross-scan patterns and semantic recall.
GET
/
v1
/
intelligence
curl https://www.thesapientcompany.com/api/v1/intelligence \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl "https://www.thesapientcompany.com/api/v1/intelligence?q=attention" \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"scan_count": 4,
"lens_averages": { "attention": 67, "purchase_intent": 60, "manipulation": 48 },
"avg_lens_curves": {
"attention": [76, 76, 76, 76, 76, 76, 75, 75, 75, 74 /* … one value per second */],
"purchase_intent": [63, 63, 63, 63, 62, 63, 63, 63, 63, 63 /* … */],
"manipulation": [52, 52, 52, 52, 52, 51, 51, 52, 51, 51 /* … */]
},
"recurring_drop_seconds": [
{ "second": 58, "lens": "attention", "count": 4 },
{ "second": 5, "lens": "manipulation", "count": 3 },
{ "second": 12, "lens": "purchase_intent", "count": 2 }
// … ranked by count
],
"query": "attention",
"recall": [
{
"scan_id": "mary_run_mq7ahu4h_bbihywp3",
"kind": "moment",
"lens": "attention",
"second": 56,
"text": "Attention slipped here (59) as the clip wound down.",
"score": 0.3056,
"created_at": "2026-06-09T23:50:57.599Z"
}
// … up to 8 hits
]
}
Every completed scan is stored to your org’s long-term memory. Intelligence rolls that history up into cross-scan patterns: your own per-lens averages, the average per-second curve for each lens, and the seconds where your content repeatedly drops. Add a
q= query and it also runs semantic recall across your stored scans, returning the most relevant moments.
Everything here is strictly org-isolated: the rollup reads only your org’s scans, and recall searches only your org’s memory.
Query Parameters
string
A natural-language query. When present, the response includes a
recall array of the most semantically relevant stored moments. Omit it for just the rollup.Response
number
How many completed scans are in your org’s memory.
object
Your org’s own benchmark: the average
0–100 score per lens across all your scans.object
For each lens, the average score at each second across your scans: your typical per-second shape.
object[]
The seconds where your content repeatedly weakens, ranked by how often. Each entry is
{ second, lens, count }.string
Echoes
q when supplied.object[]
Present when
q is supplied. The most relevant stored moments.curl https://www.thesapientcompany.com/api/v1/intelligence \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl "https://www.thesapientcompany.com/api/v1/intelligence?q=attention" \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"scan_count": 4,
"lens_averages": { "attention": 67, "purchase_intent": 60, "manipulation": 48 },
"avg_lens_curves": {
"attention": [76, 76, 76, 76, 76, 76, 75, 75, 75, 74 /* … one value per second */],
"purchase_intent": [63, 63, 63, 63, 62, 63, 63, 63, 63, 63 /* … */],
"manipulation": [52, 52, 52, 52, 52, 51, 51, 52, 51, 51 /* … */]
},
"recurring_drop_seconds": [
{ "second": 58, "lens": "attention", "count": 4 },
{ "second": 5, "lens": "manipulation", "count": 3 },
{ "second": 12, "lens": "purchase_intent", "count": 2 }
// … ranked by count
],
"query": "attention",
"recall": [
{
"scan_id": "mary_run_mq7ahu4h_bbihywp3",
"kind": "moment",
"lens": "attention",
"second": 56,
"text": "Attention slipped here (59) as the clip wound down.",
"score": 0.3056,
"created_at": "2026-06-09T23:50:57.599Z"
}
// … up to 8 hits
]
}