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
]
}
Scans
List scans
Page through your org’s scan history.
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
integer
default:"25"
How many scans to return. Clamped to
1–100.integer
default:"0"
How many scans to skip, for paging through the history.
Response
string
Always
list.number
Total scans in your org’s history.
number
The applied page size.
number
The applied offset.
object[]
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
]
}