Skip to main content
GET
Weekly mentions/views time series for one subject

Query Parameters

subject_kind
enum<string>
default:brand

What kind of subject to chart. Brand or category only.

Available options:
brand,
category
subject
string

The subject key (brand_key). Required unless subject_kind=category, where it defaults to category.

category
string
required

Category root slug the subject is scoped to (department, not aisle).

platform
enum<string>
default:all

TikTok and Instagram are the only platforms in the corpus.

Available options:
all,
tiktok,
instagram
organic_only
boolean
default:false

Exclude posts marked as ads.

weeks
integer
default:26

How many trailing ISO weeks to return.

Required range: 1 <= x <= 104

Response

Social series

subject_kind
string
subject
string
category
string
platform
string
organic_only
boolean
weeks
integer
series
object[]
coverage
object

How much data backed this answer. sufficient is false when the slice is too thin to read as a market statement; the count is always reported so you can judge for yourself, and note explains an empty or thin result rather than leaving you to infer it.

freshness
object

How current the underlying observations are. observedThrough is the newest observation behind this answer; staleHours is its age. Both null when nothing was observed.

snapshot
object | null
resolved
object
meta
object