# competitorBrand

Query

Return a single Competitor Insights brand by ID for the current workspace, or null if no brand with that ID is tracked here. Also resolves the workspace's own-brand entry by its stable id. Pair with `competitorBrandItems(brandId:, filter:, …)` to paginate the brand's media items. If aggregate metrics are unavailable, roster data remains and the response includes a `SERVICE_UNAVAILABLE` error; match on `extensions.code` and retry later.

Available to agents as MCP tool `getCompetitorBrand` — see [Read tools](/api/v2/docs/mcp/read-tools#get-competitor-brand).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `date` | [`DateWithZone`](/api/v2/docs/types/date-with-zone) | No | `null` | Anchor date (e.g. 2025-06-01) for the aggregation window. Defaults to today. |
| `id` | `ID!` | Yes | — | Competitor Insights brand ID. Also resolves the workspace's own-brand entry by its stable id. |
| `period` | [`CompetitorBrandStatsPeriod`](/api/v2/docs/types/competitor-brand-stats-period) | No | `MONTH` | Aggregation window for the metric fields (WEEK or MONTH). Defaults to MONTH. |

## Returns

Returns [`CompetitorBrand`](/api/v2/docs/types/competitor-brand).

## Examples

### Get a competitor brand by ID

Fetch a single tracked Competitor Insights brand by ID.

```graphql
query CompetitorBrandDefault($id: ID!) {
  competitorBrand(id: $id) {
    id
    name
  }
}
```

Variables:

```json
{
  "id": "28add94e-9994-54b2-9aaa-528e6606efe9"
}
```

Response — HTTP 200:

```json
{
  "data": {
    "competitorBrand": {
      "id": "28add94e-9994-54b2-9aaa-528e6606efe9",
      "name": "Verdant Co."
    }
  }
}
```