Skip to main content
GET
New shelf arrivals vs the conversation around their brand

Query Parameters

category
string
required

Category root slug (department, not aisle). No wildcard: these answers are ranked comparisons.

country
enum<string>
default:us

Country whose observations define first-seen.

Available options:
us,
ca
window
enum<string>
default:30d

Arrival 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.

limit
integer
default:25

Maximum arrivals to return.

Required range: 1 <= x <= 100

Response

Launch buzz

category
string
country
string
window_days
integer
platform
string
organic_only
boolean
launches
object[]
silent_launches
integer

Arrivals with zero brand conversation. A finding, not a gap: most launches are silent.

new_store_launches
integer

Arrivals whose whole store entered observation inside the window — catalog backfill wearing the shape of a launch. Flagged per row as new_store, never filtered.

note
string
coverage
object

TWO blocks — social counts brands, shelf counts launches. Never merged.

freshness
object

TWO values — weekly social, daily serving. Never the max.

snapshot
object | null
resolved
object
meta
object