# Sonder Docs

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

- [Sonder API](https://docs.yousonder.com/index.md): Read an author's Sonder videos, views, viral days and view milestones from your own product.
- [Quickstart](https://docs.yousonder.com/quickstart.md): Get an API key and make your first call.
- [Authentication](https://docs.yousonder.com/authentication.md): Every request uses an API key the author creates in Sonder.
- [How a video goes viral](https://docs.yousonder.com/concepts/viral.md): The exact rule Sonder uses, relative to each author's own videos.
- [View milestones](https://docs.yousonder.com/concepts/milestones.md): The view counts Sonder marks for every video.
- [Data freshness and coverage](https://docs.yousonder.com/concepts/data-freshness.md): How current the numbers are, and which videos Sonder can see.
- [Poll for viral days](https://docs.yousonder.com/guides/polling.md): Keep a chart and a notification feed in step with Sonder, a few calls every few hours.
- [One-click connect](https://docs.yousonder.com/guides/one-click-connect.md): Let authors connect Sonder with an Allow button instead of pasting a key.
- [Errors](https://docs.yousonder.com/errors.md): Every error has a status, a stable code and a plain-English message.
- [Rate limits](https://docs.yousonder.com/rate-limits.md): 60 requests a minute per key.
- [Changelog](https://docs.yousonder.com/changelog.md): Changes to the Sonder API.
- [API reference](https://docs.yousonder.com/api-reference/introduction.md): Base URL, authentication and conventions for every endpoint.
- [Get the account](https://docs.yousonder.com/api-reference/account/get-the-account.md): Who this API key belongs to. Call it when an author pastes their key, to confirm it works and show whose account is connected.
- [List books](https://docs.yousonder.com/api-reference/books/list-books.md): Every book on the author's account, newest first, with how many of its videos have been posted through Sonder.
- [List videos](https://docs.yousonder.com/api-reference/videos/list-videos.md): Videos the author has posted through Sonder, newest first. Each carries its total views across platforms, a breakdown per platform, whether and when it went viral, and the view milestones it has reached.
- [Get a video](https://docs.yousonder.com/api-reference/videos/get-a-video.md)
- [Get daily views](https://docs.yousonder.com/api-reference/stats/get-daily-views.md): Views gained each day, per video or per book, with a flag for the day each video went viral. Days are UTC. Only videos that gained views (or went viral) in the range are included, so a quiet week returns an empty list.
- [List events](https://docs.yousonder.com/api-reference/events/list-events.md): Every time one of the author's videos went viral or passed a view milestone, oldest first. To poll, save `next_cursor` and pass it as `after` next time: you get only what happened since.
- [Exchange a code for a key](https://docs.yousonder.com/api-reference/connect/exchange-a-code-for-a-key.md): Step 3 of one-click connect. Trade the `code` Sonder sent back to your `redirect_uri` for an API key. Codes last 10 minutes and work once. Authenticate with your client ID and secret (HTTP Basic or in the body). Errors follow OAuth 2.0: `{ "error", "error_description" }`.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)