Skip to main content
GET
/
api
/
v2
/
insights
/
competitive
Competitive Landscape
curl --request GET \
  --url https://app.octavehq.com/api/v2/insights/competitive \
  --header 'api_key: <api-key>'
{
  "data": [
    {
      "oId": "<string>",
      "entityOId": "<string>",
      "periodStart": "<string>",
      "periodEnd": "<string>",
      "wonDealCount": 123,
      "lostDealCount": 123,
      "noDecisionDealCount": 123,
      "openDealCount": 123,
      "wonDealTotalAmount": "<string>",
      "lostDealTotalAmount": "<string>",
      "totalFindingCount": 123,
      "uniqueEventCount": 123,
      "uniqueCompanyCount": 123,
      "uniqueContactCount": 123,
      "winRate": 123,
      "relativeWinRate": 123,
      "liftScore": 123,
      "winRateDelta": 123,
      "isUbiquitous": true,
      "dealsWherePresent": 123,
      "dealsWhereAbsent": 123,
      "lastComputedAt": "<string>",
      "entityName": "<string>"
    }
  ]
}

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.

Authorizations

api_key
string
header
required

Query Parameters

periodType
enum<string>
required

Period granularity

Available options:
week,
month,
quarter
periodStart
string<date-time>
required

Start of the period window (ISO datetime)

Response

200 - application/json

Competitor and alternative entity stats, sorted by win rate impact

data
object[]
required