Skip to main content
GET
/
v1
/
scans
curl "https://www.thesapientcompany.com/api/v1/scans?limit=3" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "object": "list",
  "total": 4,
  "limit": 3,
  "offset": 0,
  "scans": [
    {
      "scan_id": "mary_run_mq7aht79_hrac1kka",
      "input": { "kind": "url", "value": "https://www.instagram.com/reel/DZX0pkERJsE/" },
      "lenses": ["attention", "purchase_intent", "manipulation"],
      "summary": "Across the clip, attention averaged a solid 68, the pull toward buying sat at 60, and emotional persuasion stayed in the middle range at 48 …",
      "created_at": "2026-06-10T00:35:18.756+00:00"
    },
    {
      "scan_id": "mary_run_mq7ahvvn_789mregx",
      "input": { "kind": "url", "value": "https://www.instagram.com/reel/DZF8MpCJz1y/" },
      "lenses": ["attention", "purchase_intent", "manipulation"],
      "summary": "Across the clip, attention averaged 67, the pull toward buying averaged 60, and the emotional persuasion level averaged 48 …",
      "created_at": "2026-06-09T23:51:07.782+00:00"
    }
    // … up to `limit` scans
  ]
}
Return your org’s scans, newest first. Each entry is a lightweight summary: scan_id, input, lenses, the written summary, and created_at. To read the full per-second timeline for any one of them, fetch it with Get a scan. Scans are strictly org-scoped: you only ever see your own org’s history.

​
Query Parameters

​
limit
integer
default:"25"
How many scans to return. Clamped to 1–100.
​
offset
integer
default:"0"
How many scans to skip, for paging through the history.

​
Response

​
object
string
Always list.
​
total
number
Total scans in your org’s history.
​
limit
number
The applied page size.
​
offset
number
The applied offset.
​
scans
object[]
The page of scans.
curl "https://www.thesapientcompany.com/api/v1/scans?limit=3" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "object": "list",
  "total": 4,
  "limit": 3,
  "offset": 0,
  "scans": [
    {
      "scan_id": "mary_run_mq7aht79_hrac1kka",
      "input": { "kind": "url", "value": "https://www.instagram.com/reel/DZX0pkERJsE/" },
      "lenses": ["attention", "purchase_intent", "manipulation"],
      "summary": "Across the clip, attention averaged a solid 68, the pull toward buying sat at 60, and emotional persuasion stayed in the middle range at 48 …",
      "created_at": "2026-06-10T00:35:18.756+00:00"
    },
    {
      "scan_id": "mary_run_mq7ahvvn_789mregx",
      "input": { "kind": "url", "value": "https://www.instagram.com/reel/DZF8MpCJz1y/" },
      "lenses": ["attention", "purchase_intent", "manipulation"],
      "summary": "Across the clip, attention averaged 67, the pull toward buying averaged 60, and the emotional persuasion level averaged 48 …",
      "created_at": "2026-06-09T23:51:07.782+00:00"
    }
    // … up to `limit` scans
  ]
}