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

# Sonder API

> Read an author's Sonder videos, views, viral days and view milestones from your own product.

Sonder turns non-fiction books into short-form videos and posts them to TikTok, Instagram, YouTube and Facebook. The Sonder API lets a tool the author already uses see how those videos are doing: how many views each one got, on which day, and the moment one went viral.

Publisher Champ uses it to mark an author's viral days on their sales chart, so a spike in book sales can be traced back to the video that caused it.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first call in two minutes with an author's API key.
  </Card>

  <Card title="How a video goes viral" icon="chart-line-up" href="/concepts/viral">
    The exact rule Sonder uses, and why it's relative to each author.
  </Card>

  <Card title="Poll for viral days" icon="arrows-rotate" href="/guides/polling">
    Keep a chart or a notification feed in step with Sonder.
  </Card>

  <Card title="One-click connect" icon="plug" href="/guides/one-click-connect">
    Let authors connect with an Allow button instead of pasting a key.
  </Card>
</CardGroup>

## What you can read

| Endpoint                                                 | What it returns                                                                   |
| -------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [`GET /account`](/api-reference/account/get-the-account) | Who the key belongs to and which social accounts they post to.                    |
| [`GET /books`](/api-reference/books/list-books)          | The author's books.                                                               |
| [`GET /videos`](/api-reference/videos/list-videos)       | Posted videos with total views, views per platform, viral status and milestones.  |
| [`GET /stats`](/api-reference/stats/get-daily-views)     | Views gained each day, per video or per book, with the day each video went viral. |
| [`GET /events`](/api-reference/events/list-events)       | Every viral moment and view milestone, in order, for polling.                     |

The API only reads. It can't change an author's account, make videos or post anything.

## The basics

* **Base URL:** `https://api.yousonder.com/v1`
* **Authentication:** `Authorization: Bearer sonder_live_…`, a key the author creates in Sonder. See [Authentication](/authentication).
* **One author per key.** A key sees that author's data and nothing else.
* **JSON everywhere.** Field names are `snake_case`, times are ISO 8601 in UTC, and dates are `YYYY-MM-DD` in UTC.
* **Views refresh every hour.** Poll every 1–4 hours; polling more often won't give you newer numbers. See [Data freshness](/concepts/data-freshness).