List 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
  ]
}

GET

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[]

The page of scans.

Show scans[]

string

The scan identifier. Pass it to Get a scan.

object

What was scanned: { kind, value } (e.g. a URL or a text snippet).

string[]

The lenses this scan was scored against.

string

The written read of the clip.

string

ISO 8601 timestamp.

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

Get a scan Lenses

Scans

Concepts

Reference

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response