Skip to main content
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.

Quickstart

Make your first call in two minutes with an author’s API key.

How a video goes viral

The exact rule Sonder uses, and why it’s relative to each author.

Poll for viral days

Keep a chart or a notification feed in step with Sonder.

One-click connect

Let authors connect with an Allow button instead of pasting a key.

​
What you can read

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.
  • 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.