Currents
Category Feed

SubscriptionAccepted

category
​string · required
status
​string · enum · required
Enum values:
warming
ready
archived
​

Problem

type
​string · required
title
​string · required
status
​integer · required
detail
​string · required
instance
​string · required
​

Present when the failure was recorded on our side. Quote it and we can read the failure that produced this response.

SubscribeRequest

category
​string · minLength: 1 · maxLength: 100 · required
​

SubscriptionSummary

category
​string · required
status
​string · enum · required
Enum values:
warming
ready
archived
subscribed_at
​string · date-time · required
​
​

Absent once the category is archived: no edition follows.

​

Present only when status is archived.

ArchivedCategory

status
​string · const · required
Const value: archived
archive_reason
​string · required

Why the category stopped being tracked for you.

AudienceMood

tone
​string · enum · required
Enum values:
enthusiastic
affectionate
inquisitive
sceptical
concerned
divided
neutral
positive_share
​number · min: 0 · max: 1 · required
commercial_signal
​string · enum · required
Enum values:
low
medium
high
top_questions
​string[] · maxItems: 5 · required

CategoryFeed

category
​string · required
status
​string · enum · required
Enum values:
warming
ready
prepared_at
​string · date-time · required
next_update_at
​string · date-time · required
​Taxonomy · required
​Highlights · required
​Topic[] · required

Ordered by attention_index descending. When the subscription carries a brief, ordered by relevance to the brief instead, with the least relevant topics left out.

​

Highlights

big
​string[] · required
fast_moving
​string[] · required
uncontested
​string[] · required

Iab

ids
​string[] · required
path
​string · required

IntentMix

​
​
​
​
​

Suitability

risk
​string · enum · required

The GARM tier to threshold on: the most severe tier a real share of the topic's videos carries, or the tier its comments alone would earn, whichever is worse. Not the tier most of the topic sits in — a topic that is largely low risk but partly at the floor reads as floor.

Enum values:
low
medium
high
floor
categories
​string[] · maxItems: 3 · required
Enum values:
adult_explicit_sexual_content
arms_ammunition
crime_harmful_acts
death_injury_military_conflict
online_piracy
hate_speech_acts_of_aggression
obscenity_profanity
illegal_drugs_tobacco_vaping_alcohol
​object · required

Taxonomy

name
​string · const · required
Const value: iab-content-3.1
cattax
​integer · const · required
Const value: 9

Topic

topic
​string · pattern: ^[a-z0-9]+(?:-[a-z0-… · required
​Iab · required
terms
​string[] · maxItems: 10 · required
attention_index
​integer · min: 0 · max: 100 · required

How much attention this topic holds, 0-100. Higher means the topic's videos are earning views faster than comparable YouTube videos of the same format and age. The same score means the same thing in every category, and it moves when the category moves.

momentum_index
​integer · min: 0 · max: 100 · required

How hard the topic is accelerating, 0-100. Read from the topic's newest videos against the rest of its own output, so it is movement within the topic rather than a position against other topics.

trajectory
​string · enum · required
Enum values:
surging
building
established
softening
single_channel
why_now
​string · required
scale
​string · enum · required
Enum values:
niche
moderate
broad
brand_presence
​string · enum · required
Enum values:
open
light
active
saturated
creator_spread
​string · enum · required
Enum values:
concentrated
moderate
diverse
brands_present
​string[] · maxItems: 10 · required
​IntentMix · required
​AudienceMood · required
​Suitability · required
evidence
​string[] · minItems: 3 · maxItems: 3 · required