Share-of-voice time-series

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 total tracked-brand mentions 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", "project": { "id": 42, "organization_id": 7, "name": "Acme Marketing", "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 } ] } ] }