Query
competitorBrands
List Competitor Insights brands tracked by the current workspace, newest first. Each brand carries aggregate metrics over a period/date window (default month). The first page also returns the workspace's own brand as one pinned node, flagged isOwnBrand. It comes in addition to up to first competitor brands, so one query gives self-vs-competitor Share of Voice. totalCount counts tracked competitor brands only. Pair with competitorBrandItems(brandId:, filter:, …) to paginate a brand's media items. When aggregate metrics are unavailable, the roster data still returns, with a SERVICE_UNAVAILABLE error. Match on extensions.code and retry later.
Arguments
Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.
- after String default null
- Cursor for fetching the next page of results.
- date DateWithZone default null
- Anchor date (e.g. 2025-06-01) for the aggregation window. Defaults to today.
- first Int default 20
- Number of competitor brands to return (page size). The own-brand entry is additional.
- period CompetitorBrandStatsPeriod default MONTH
- Aggregation window for the metric fields (WEEK or MONTH). Defaults to MONTH.
- MONTH
- Aggregate over the month containing the anchor date.
- WEEK
- Aggregate over the week containing the anchor date.
Returns
A paginated connection of CompetitorBrand nodes. See Pagination for the connection shape.
- edges [CompetitorBrandEdge!]!
- List of edges with cursors.
- cursor String!
- Cursor for this node.
- node CompetitorBrand!
- The competitor brand.
- earnedMediaValue Float
- Estimated earned media value (USD) over the window. Null when unavailable or no data.
- engagementsTotal Float
- Total engagements (likes + comments + shares, …) over the window. Null when unavailable or no data.
- id ID!
- Unique identifier for the brand in Archive's system. For the workspace's own-brand entry this is a stable, workspace-scoped id (the same across requests).
- impressions Float
- Merged view/play impressions over the window. Null when unavailable or no data.
- influencersCount Int
- Distinct influencers counted over the window. Null when unavailable or no data.
- isOwnBrand Boolean!
- True for the workspace's own-brand entry, false for tracked competitor brands. Use this to compute self-vs-competitor Share of Voice.
- name String!
- Brand name. The workspace's own-brand entry is named "You".
- ownMetricsStatus CompetitorBrandOwnMetricsStatus
- For the own-brand entry only (null for competitors): AVAILABLE when metrics were computed (null metric fields then mean no data in the window, distinct from zero), UNAVAILABLE when they could not be computed. The accompanying error code says whether to retry.
- AVAILABLE
- Own-brand metrics were computed. Null metric fields mean no data in this window (distinct from zero).
- UNAVAILABLE
- Own-brand metrics could not be computed. The accompanying error explains whether to retry; metric fields are null.
- postsCount Int
- Number of posts counted over the window. Null when unavailable or no data.
- reach Float
- Summed follower reach over the window. Null when unavailable or no data.
- nodes [CompetitorBrand!]!
- List of competitor brands.
- earnedMediaValue Float
- Estimated earned media value (USD) over the window. Null when unavailable or no data.
- engagementsTotal Float
- Total engagements (likes + comments + shares, …) over the window. Null when unavailable or no data.
- id ID!
- Unique identifier for the brand in Archive's system. For the workspace's own-brand entry this is a stable, workspace-scoped id (the same across requests).
- impressions Float
- Merged view/play impressions over the window. Null when unavailable or no data.
- influencersCount Int
- Distinct influencers counted over the window. Null when unavailable or no data.
- isOwnBrand Boolean!
- True for the workspace's own-brand entry, false for tracked competitor brands. Use this to compute self-vs-competitor Share of Voice.
- name String!
- Brand name. The workspace's own-brand entry is named "You".
- ownMetricsStatus CompetitorBrandOwnMetricsStatus
- For the own-brand entry only (null for competitors): AVAILABLE when metrics were computed (null metric fields then mean no data in the window, distinct from zero), UNAVAILABLE when they could not be computed. The accompanying error code says whether to retry.
- AVAILABLE
- Own-brand metrics were computed. Null metric fields mean no data in this window (distinct from zero).
- UNAVAILABLE
- Own-brand metrics could not be computed. The accompanying error explains whether to retry; metric fields are null.
- postsCount Int
- Number of posts counted over the window. Null when unavailable or no data.
- reach Float
- Summed follower reach over the window. Null when unavailable or no data.
- pageInfo PageInfo!
- Pagination information.
- endCursor String
- Cursor for the last node in this page.
- hasNextPage Boolean!
- Whether there are more results after this page.
- hasPreviousPage Boolean!
- Whether there are results before this page.
- startCursor String
- Cursor for the first node in this page.
- totalCount Int
- Total number of items available.