> ## Documentation Index
> Fetch the complete documentation index at: https://api.thesapientcompany.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Sapient is the brain-response API. Predict how real human brains respond to your content.

Send a piece of content (a video or audio URL) and Sapient predicts how a human brain responds to it, **second by second**. You submit to one endpoint, `POST /api/v1/scans`, get a `queued` scan back, then poll it (or receive it on a webhook). The completed scan is a per-second timeline scored across four **lenses**: attention, memory, buy/not buy intent, and manipulation, each grounded in real brain-network activity.

## Quickstart

<CodeGroup>
  ```bash cURL theme={null}
  curl https://www.thesapientcompany.com/api/v1/scans \
    -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
    -H "Content-Type: application/json" \
    -d '{ "input": { "type": "video", "video_url": "https://yourcdn.com/ad.mp4" } }'
  ```

  ```javascript Node theme={null}
  const res = await fetch("https://www.thesapientcompany.com/api/v1/scans", {
    method: "POST",
    headers: {
      Authorization: "Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: { type: "video", video_url: "https://yourcdn.com/ad.mp4" },
    }),
  });
  const scan = await res.json();
  ```

  ```python Python theme={null}
  import requests

  res = requests.post(
      "https://www.thesapientcompany.com/api/v1/scans",
      headers={"Authorization": "Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
      json={"input": {"type": "video", "video_url": "https://yourcdn.com/ad.mp4"}},
  )
  scan = res.json()
  ```
</CodeGroup>

## Next steps

<Columns cols={3}>
  <Card title="Authentication" href="/authentication">
    Create an `sk_live_` key and authenticate every request.
  </Card>

  <Card title="Create a scan" href="/api-reference/create-scan">
    Submit content to `POST /api/v1/scans` and get a scan back.
  </Card>

  <Card title="Pricing" href="/api-reference/pricing">
    \$2.50 per Qualia scan (the active model; Mary is temporarily unavailable). First \$2.50 each month is free.
  </Card>
</Columns>