Primary brand and competitors

Cleotic looks for your primary brand and its competitors in captured answers. Each brand has one primary brand record and a set of competitors. Together they are your tracked brands, which count towards your organisation's tracked-brand allowance.

How they are used

Your primary brand is the focus of Performance, the Mentions feed, Site Readiness, and answer-gap analysis. Competitors provide the comparison set for visibility and share of voice.

Choose competitors relevant to the questions you are testing. Adding unrelated companies changes the comparison without making it more useful.

Add a competitor

  1. Open Brand settings -> Competitors.
  2. Click Add competitor.
  3. Enter the competitor's Name and Domain.
  4. Add optional comma-separated Aliases, such as AWS for Amazon Web Services.
  5. Click Create.

Use the company's own domain. Cleotic uses domains to classify citation ownership. Keep aliases specific, because a common word can match unrelated text. Site metadata is an optional aid, and you can enter the details yourself.

Edit the primary brand

Open Brand settings -> Details and click Edit under Brand identity to update its name, domain, or aliases. A competitor can't become the primary brand.

Edit a competitor

Open the edit action for a competitor on Brand settings -> Competitors, update its name, domain, or aliases, then click Save Changes.

Historical reanalysis

Adding or editing a competitor or the primary brand starts historical reanalysis after saving. This applies the updated configuration to existing responses. Let it finish before comparing metrics, because a change in matching can change historical results.

Reanalysis reuses captured answers. It doesn't ask the AI models the prompts again. If Cleotic can't refresh progress, use Retry status check in the banner. If the analysis itself fails, contact support with the brand and the change you made.

Pause or delete a competitor

Pausing a competitor keeps its history and removes it from active analysis and tracked-brand capacity. You can resume it later if capacity allows. The primary brand can't be paused.

Deleting removes the competitor from the brand. Review the confirmation before deleting, and pause instead if you may need it again.

API, CLI, and MCP

Agents and scripts manage these records with the brand's project ID:

  • API: /api/v2/projects/{id}/primary-brand and /api/v2/projects/{id}/competitors
  • CLI: cleotic primary-brand show|set and cleotic competitors list|create|update|delete
  • MCP: set_primary_brand, create_competitor, and update_competitor