Developer Docs

API Reference

200+ endpoints across 33 resource groups. Build custom integrations with your competitive intelligence data.

119
API Routes
200+
Endpoints
33
Resource Groups
REST
JSON API

Base URL

https://app.kompense.com/api

Public API v1 endpoints are available at /api/v1/ for programmatic access via API keys.

Authentication

Session Authentication (Dashboard)

All dashboard API endpoints use Supabase session-based authentication via secure HTTP-only cookies. Sessions are automatically managed when you log in to the Kompense dashboard.

API Key Authentication (Public API v1)

For programmatic access, use API keys with the Authorization header.

Authorization: Bearer your_api_key_here

Generate API keys in Settings > API Keys within the Kompense dashboard.

Public API (v1)

These endpoints are available for external integrations using API key authentication.

GET /api/v1/competitors

List all tracked competitors with status, domain, and metadata.

GET /api/v1/insights

Retrieve AI-generated competitive insights with severity, category, and recommended actions.

GET /api/v1/pricing

Access competitor pricing intelligence — tiers, features, price history, and change alerts.

All API Resource Groups

Click any group to see its endpoints. All dashboard endpoints require session authentication.

▶

Competitors

11 routes
CRUD + scrape + discover
GET/api/competitorsList all competitors
POST/api/competitorsAdd new competitor
GET/api/competitors/:idGet competitor details
PUT/api/competitors/:idUpdate competitor
DEL/api/competitors/:idDelete competitor
POST/api/competitors/discoverAI competitor discovery
POST/api/competitors/find-similarFind similar companies
POST/api/competitors/:id/scrapeScrape competitor website
GET/api/competitors/:id/scoreThreat score
GET/api/competitors/:id/snapshotsHistorical snapshots
GET/api/competitors/:id/researchResearch summary
▶

Insights

2 routes
AI-generated intelligence
GET/api/insightsList insights (filter by severity, category)
GET/api/insights/:idGet insight detail with business impact
▶

Pricing Intelligence

3 routes
Price tracking & alerts
GET/api/pricingCompetitor pricing data
GET/api/pricing/alertsPrice change alerts
GET/api/pricing/historyHistorical pricing trends
▶

Ad Intelligence

12 routes
Google & Meta ad tracking
GET/api/adsAd summary data
GET/api/ads/campaignsAd campaigns
GET/api/ads/creativesAd creatives (text, images, video)
POST/api/ads/creatives/googleFetch Google Ads
POST/api/ads/creatives/metaFetch Meta/Facebook Ads
GET/api/ads/keywordsKeyword intelligence
GET/api/ads/landing-pagesLanding page analysis
▶

Battlecards

4 routes
AI sales battlecards
GET/api/battlecardsAll battlecards
GET/api/battlecards/:idSpecific battlecard
POST/api/battlecards/generateGenerate for competitor
POST/api/battlecards/generate-allBulk generate
▶

Content & SEO

8 routes
Keywords & backlinks
GET/api/contentContent intelligence
GET/api/content/keywordsKeyword rankings
GET/api/content/backlinksBacklink data
POST/api/content/keyword-researchKeyword research
POST/api/content/backlink-strategyBacklink strategy analysis
▶

AI Chat & Command Center

4 routes
Gemini-powered AI agent
POST/api/chatChat with AI agent
POST/api/chat/streamStreaming responses (SSE)
GET/api/chat/historyConversation history
GET/api/command-centerCross-module intelligence
▶

Social & Reviews

4 routes
Social media & sentiment
GET/api/socialShare of voice metrics
POST/api/social/analyzeSocial sentiment analysis
GET/api/reviewsReview data (G2, Trustpilot)
POST/api/reviews/analyzeReview sentiment analysis
▶

Deals & Win/Loss

5 routes
Sales intelligence
GET/api/dealsList tracked deals
POST/api/dealsCreate deal
POST/api/deals/:id/outcomeRecord win/loss
GET/api/winlossWin/loss analytics
POST/api/winloss/analyzeAI win/loss analysis
▶

Import & Data

9 routes
CSV/Excel/AI import
GET/api/import/templateDownload import template
POST/api/import/companiesImport from CSV/Excel
POST/api/import/intelligentAI-powered smart import
POST/api/import/productsImport products
POST/api/import/stakeholdersImport stakeholders
▶

Alerts & Notifications

3 routes
Email, Slack, Telegram
GET/api/alerts/preferencesAlert preferences
POST/api/alerts/sendSend alert notification
POST/api/alerts/testTest alert delivery
▶

More Resource Groups

60+ routes
Watchlist, Team, Clients, more
Watchlist5 routes — Monitor, research, convert to competitor
Team & Collaboration3 routes — Invite members, manage roles
Client Profiles4 routes — Agency client management, enrichment
Intelligence Sources3 routes — Manage & validate data sources
Global Companies3 routes — Shared company registry & enrichment
Dashboard & Health2 routes — Summary stats, system health check
User & Profile4 routes — Profile, API keys, business info
Compare & Timeline2 routes — Side-by-side comparison, event timeline
Smart Sync3 routes — Full sync, AI analysis, discovery
n8n Workflows2 routes — Trigger automation workflows
Tenant & Branding1 route — White-label customization
Demo6 routes — Try without signing up

Example Request

cURL — Public API v1 
curl -X GET "https://app.kompense.com/api/v1/competitors" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json"

Example Response

JSON 200 OK 
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "competitor_name": "Example Corp",
      "competitor_url": "https://example.com",
      "competitor_domain": "example.com",
      "status": "active",
      "scrape_frequency_hours": 12,
      "last_scraped_at": "2026-03-04T12:00:00Z",
      "favicon_url": "https://example.com/favicon.ico"
    }
  ]
}

Rate Limits

Starter
50 req/day
Pro
100 req/day
Enterprise
Custom limits

Need higher limits or webhook support? Enterprise plans include dedicated API access with custom rate limits.

Contact Sales for Enterprise API Access