Skip to main content
GET
Share of social conversation by brand

Query Parameters

category
string
required

Category root slug (department, not aisle).

window
enum<string>
default:30d

Rollup window. Only published windows are accepted.

Available options:
7d,
30d,
90d
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.

brand
string

Brand name (e.g., Sony, Samsung, Nike)

Minimum string length: 1
limit
integer
default:25

Max results to return (default 25, min 1, max 100)

Required range: 1 <= x <= 100

Response

Brand share of conversation

category
string
subcategory
string | null

Always null. The rollup publishes category-level rows only.

axis
enum<string>

Always category. The subcategory axis is unpublished.

Available options:
category
brand
string | null
window_days
integer
platform
string
organic_only
boolean
brands
object[]
siblings
object[]
noise_pct
number | null
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