> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octavehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# What are Competitors in Octave?

> Store strengths, weaknesses, win/loss reasons, and differentiation points. Agents use Competitors for competitive positioning.

## What is a Competitor?

A Competitor is a structured profile of a vendor or solution that your prospects evaluate alongside your product. It captures more than a name — it stores their strengths, weaknesses, why you win against them, why you lose, and specific differentiation points that agents use to generate competitive messaging. When a Sequence Agent writes an outbound email to a prospect evaluating a known competitor, it reads the Competitor entity to weave in targeted differentiation — emphasizing your strengths where the competitor is weak, and proactively addressing areas where they have an edge.

## What a Competitor contains

| Field                  | Purpose                              |
| ---------------------- | ------------------------------------ |
| Name                   | Competitor name                      |
| Description            | What they do and who they serve      |
| Strengths              | What they do well                    |
| Weaknesses             | Where they fall short                |
| Win reasons            | Why you beat them in deals           |
| Loss reasons           | Why you lose to them                 |
| Differentiation points | Specific areas where you're distinct |
| Primary URL            | Their website                        |

## How Competitors connect to other entities

* **[Offerings](/concepts/offerings)** — which of your products or services compete with this vendor
* **[Motions](/concepts/motions)** — competitive Motion Playbooks (narrative type `COMPETITIVE`) target specific vendors for displacement
* **Findings** (via [analytics](/concepts/analytics)) — call transcripts and emails where this competitor was mentioned

The [analytics](/concepts/analytics) pipeline automatically detects competitor mentions in sales calls and emails. When a prospect says "we're also looking at \[Competitor X]", Octave extracts that finding and links it to the Competitor entity, building a real-time picture of competitive deal frequency and context. Over time, this surfaces which competitors appear most often, in which [segments](/concepts/segments), and whether your win rate against them is improving or declining — turning anecdotal competitive intelligence into a structured, queryable dataset.

## Managing Competitors via API

* `GET /api/v2/competitor/list` — list all competitors
* `GET /api/v2/competitor/{id}` — get a specific competitor
* `POST /api/v2/competitor/create` — create a new competitor
* `POST /api/v2/competitor/generate` — AI-generate competitor profiles from market research
* `PUT /api/v2/competitor/update` — update an existing competitor
* `DELETE /api/v2/competitor/delete` — remove a competitor