List subscribed categories
Return every category this subscriber holds, newest first. A category that is still warming carries the time its topics become available in ready_at; one that has been archived carries the reason it was archived. Fetch a category by name for its topics.
List subscribed categories › Responses
OK
categorystatussubscribed_atAbsent once the category is archived: no edition follows.
Present only when status is archived.
Subscribe to a category
Register a category and begin tracking it. The subscription is accepted immediately and starts warming; its topics become available at the time given in ready_at. Subscribing again to a category you already hold updates its brief, which narrows the topics returned to those closest to what you sell.
Subscribe to a category › Responses
Accepted
categorystatusFetch a category's topics
Return the category's current topics, each with its trajectory, biddable terms, audience mood, format mix and evidence. A category that is still warming returns no topics yet. The edition is rebuilt every 24 hours; prepared_at and next_update_at bound the one you are reading. A category you have archived carries only its status and the reason it was archived; subscribe to it again to resume tracking and receive topics.
path Parameters
categoryFetch a category's topics › Responses
OK
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: category, prepared_at, next_update_at +3 more | |
| type = object · status="archived" · requires: archive_reason |
categorystatusprepared_atnext_update_atOrdered by attention_index descending. When the subscription carries a brief, ordered by relevance to the brief instead, with the least relevant topics left out.
Archive a category
Stop tracking a category for this subscriber. A reason is required.
path Parameters
categoryquery Parameters
reasonWhy the category is being archived. Returned on later fetches.
Why the category is being archived. Returned on later fetches.
Archive a category › Responses
No Content