Currents
Getting started

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
POST /v1/categories register a category GET /v1/categories list the categories you hold GET /v1/categories/{category} read its topics DELETE /v1/categories/{category} stop tracking it

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.

Last modified on