Skip to main content
GET
Use this to decide which filters to offer in your app before you offer them: which sports get a story ring, which sections get a tab, which authors get a row. One request replaces probing /v1/feed/filter once per value. The counts are over exactly the content the feed serves — published, ready, non-deleted items of a supported type — and honour the same exclude.* and media-negotiation rules as filtered feeds. For any value v, counts[v] equals the number of items a feed filtered to v would page through.
Authenticate with a publishable key (X-API-Key: pk_…). The endpoint is safe to call from client apps on every launch: responses are cached for 60 seconds per organisation and query.

Query parameters

string
required
The dimension to break the catalogue down by. One of tags, section, author, content_type, or metadata.<key> for a custom metadata field (for example metadata.sport). These are the same include dimensions FeedFilter accepts.
integer
default:"0"
Drop values with fewer than this many matching items. Use it to hide filters that would open a nearly empty feed.
string
Comma-separated values to exclude before counting. Also accepts exclude.sections, exclude.authors, exclude.content_types and exclude.metadata.<key>, with the same semantics as the feed’s exclusion filters.

Response

string
The dimension that was counted, echoed back.
object
A map of value → number of matching items, ordered by count descending, then value ascending. Each item counts once per distinct value it carries, so an item tagged baseball and bats appears in both counts.
Invalid by values return 400.

Notes

  • Counts are per organisation and reflect the catalogue at the time of the request (up to 60 seconds of caching).
  • Only values that can be requested are listed: string tags with no commas or whitespace, non-empty sections and authors, and string metadata values.
  • Organisations on the discovery feed see counts for the discovery pool (video and live stream content), which match that pool’s X-Pool-Size header for the same filter.
  • For the SDK side of this — opening a filtered feed from a tapped tile — see per-tile feeds.