Share-of-voice time-series

A share-of-voice time series: one entry per brand in scope, each carrying a dense list of buckets tracing the brand's share of voice across the filter window.

Fields

Field	Type	Description
interval	string	The bucket granularity used to compute the series.
series	BrandShareOfVoiceSeries[]	One entry per brand in scope, each carrying a dense list of buckets.

Per-brand share-of-voice series

Field	Type	Description
brand	Brand	The brand this series covers.
data	TimeSeriesPoint[]	The bucketed data points for this brand. Each value is the brand's mentions expressed as a percentage of the mentions of the brands in the filter scope in the bucket.

Time-series data point

Field	Type	Description
timestamp	datetime	The ISO 8601 UTC start of the bucket.
value	integer	The metric value for this bucket. The series that carries the point describes what the value measures.

{ "interval": "day", "series": [ { "brand": { "id": 555, "project_id": 42, "display_name": "Acme Inc.", "aliases": [ "Acme", "Acme Co" ], "domains": [ "acme.com", "acme.co" ], "kind": "competitor", "color": "#008FFB", "ignored_at": null, "project": { "id": 42, "organization_id": 7, "name": "Acme Marketing", "brand_id": 555, "organization": { "id": 7, "name": "Acme Inc.", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "data": [ { "timestamp": "2026-04-01T00:00:00+00:00", "value": 73 } ] } ] }