Introduction
Currents tells you where audience attention is moving inside a category, early enough to bid on it.
You register a category. We watch it continuously and return a set of topics — each one carrying the direction it is moving, the terms you can bid on, what the audience sounds like around it, and the videos that prove it. The set is rebuilt every 24 hours.
The shape of it
Code
A category you have just registered is warming: we have not watched it long
enough to say anything honest yet. That takes about a day, and the response tells
you the moment it will be ready.
Once it is ready, every fetch returns the current edition, and prepared_at and
next_update_at bound the one you are holding.
pet care and fitness clothing are prepared ahead of time and skip that wait,
so you can read a full response on your first call.
Every topic gets a direction
attention_index and momentum_index are both 0-100, and both are speeds rather
than rankings: how fast a topic's videos earn views against comparable YouTube
videos of the same format and age, and how hard that is accelerating. Higher is
faster. The same score means the same thing in every category, and it moves when
the category moves — so you can track one topic across editions and compare topics
across categories you have never bought in before.
trajectory is the band momentum_index falls in: surging, building,
established, softening or single_channel. The thresholds are fixed, so a
quiet category reads quiet instead of being flattered, and a category where
everything is moving is allowed to say so.
One guard sits on top of it. single_channel means the movement is one
channel's output rather than an audience shifting — reported as building it would
be lying to you, and you would bid on it.
Start with the quickstart.