CiteFoundry Docs
Open dashboard

Brands and the brand-book

Your own brand, detected competitors, the brand-book, and product entity tracking.

A brand is a tracked entity inside a project — your own, plus competitors. CiteFoundry uses brands to attribute mentions and citations and to compute share-of-voice. Getting brand definitions right is the single most impactful tuning you can do.

Your own brand

The first brand in every project is seeded from the project’s primary domain. Open Settings → Brand-book to refine it:

  • Display names and aliases — every way customers refer to you. “ACME”, “ACME Corp”, “ACME Tools”, the legacy product line you retired but is still mentioned, an acquired brand.
  • Owned domains — root domains under your control. Citations to these count as you, regardless of subpath.
  • Products — named products with their own aliases. A run that mentions “Pegasus 41” gets attributed to Nike via the product.
  • Voice and tone — used by AI-generated prompt ingestion to keep candidate prompts on-brand.
  • Legal claims — disallowed claims (medical, financial, comparative) we’ll never put into AI-generated prompts.

A complete brand-book makes share-of-voice numbers trustworthy. A half-finished one will undercount you and overcount competitors.

Detected brands (competitors)

Every run that mentions a brand that isn’t already tracked surfaces it as a detected brand. Open Brands → Detected to review:

  • Promote — start tracking this brand explicitly. You can edit its display name, aliases, and domains, just like your own brand.
  • Merge — fold it into an existing tracked brand. Useful for spelling variants and acquisitions.
  • Dismiss — discard. Detected brands you’ve dismissed won’t be re-suggested.

The detected-brands page is the engine for building out your competitor set without typing them in cold.

Tracking competitors

A few high-leverage competitors beats a long list. Pick the three or four brands that show up most often next to yours in the answers, and promote them. Their citations and mentions will show up alongside your own throughout the dashboard — share-of-voice, content gaps, citation domain drill-down, weekly briefs.

You can add competitors manually too (Brands → Tracked → New), but the detected-brands queue is usually faster.

Brand-book best practices

  • Add aliases proactively. If you renamed a product or have a common misspelling, add it. Don’t wait for it to show up.
  • Add subdomains explicitly only when needed. A root domain catches every subpath by default; subdomains under “owned” let you also attribute help.acme.com or docs.acme.com.
  • Keep product lists pruned. Discontinued products still in the list bloat the brand and dilute share-of-voice.

API

  • GET /v1/projects/{projectId}/brands
  • GET /v1/projects/{projectId}/brand-book
  • PUT /v1/projects/{projectId}/brand-book
  • GET /v1/projects/{projectId}/detected-brands
  • POST /v1/projects/{projectId}/detected-brands/{id}/promote