Search skmtc…
⌘K
Docs
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Generate
Filter operations
ads
3
alerts
9
apiKeys
5
audience
1
brands
62
briefs
3
categories
10
get
/v1/categories/leaders
For each asked category, its `n` largest non-shadow brands by live ads.
get
/v1/categories/proven-counts
Per category (and overall, category null), the named brands and those that are Proven.
get
/v1/categories/{categoryId}
One category (any level) with its parent and current totals.
get
/v1/categories
Top-level categories, or the children of one parent; with `slug`, the categories of any level carrying that slug (the site resolves `/categories/…` paths with it).
get
/v1/categories/tree
One top-level category (by slug, default `ecommerce`) with every level-2 and level-3 category under it and the public brands and active ads filed under each, in one read. A category with no public brand is left out. The same totals as categories.list.
get
/v1/categories/sitemap
Public category pages (every level) for sitemap generation.
get
/v1/categories/{categoryId}/hooks
A top-level category's hook library: the opening lines its brands' creatives use (the spoken hook, else the on-screen text of the first 3 seconds), each with its angle, format, how many brands, creatives and ads use it, the share still active, median observed days live and example ads, ranked by observed survival. Filter by format, production (ugc or produced), awareness, angle or a last-seen day. Observed survival, not performance or spend. Answers 409 until the view's first nightly build.
get
/v1/categories/{categoryId}/stats
Aggregates for one category: brands, landing URLs, Similarweb visits, top page types and top tools.
get
/v1/category-concentration
categories.concentration's daily series for many categories of one level in one read (no share of voice or movers): HHI of active-ad shares, the top four brands' share, Gini, live brands, active and new ads per day over the last `days` days, oldest first. Every category asked is answered, in the order asked; `days: []` means no built day.
get
/v1/categories/{categoryId}/concentration
How concentrated a category's advertising is, day by day over the last `days` days (HHI, top-4 share, Gini, live brands, active and new ads), the top brands' share of its active ads on the newest day, and the brands that moved most in its active-ads rank over the window.
collections
9
creatives
15
me
1
notes
3
operators
4
pages
5
radar
9
rankings
17
reports
3
system
3
tools
7
categories
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to For each asked category, its `n` largest non-shadow brands by live ads.
get
/v1/categories/leaders
Oct 19, 2026
4fbe9d681caf
Revision changes
info
endpoint added