Skip to main content
GET
/
v1
/
intelligence
curl https://www.thesapientcompany.com/api/v1/intelligence \
  -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

​
q
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

​
scan_count
number
How many completed scans are in your org’s memory.
​
lens_averages
object
Your org’s own benchmark: the average 0–100 score per lens across all your scans.
​
avg_lens_curves
object
For each lens, the average score at each second across your scans: your typical per-second shape.
​
recurring_drop_seconds
object[]
The seconds where your content repeatedly weakens, ranked by how often. Each entry is { second, lens, count }.
​
query
string
Echoes q when supplied.
​
recall
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"

{
  "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
  ]
}