Skip to main content
>SectorHQ

API Documentation

Integrate Sector HQ data into your applications

Get API Key

Authentication

Authenticate by including your API key as a Bearer token in the Authorization header. API keys follow the format sk_live_*.

Public endpoints can be called without authentication, but rate limits are lower for unauthenticated requests.

bash
curl -H "Authorization: Bearer sk_live_YOUR_KEY" \
  https://sectorhq-api-fa5v2.ondigitalocean.app/api/v1/leaderboard/companies

Endpoint Reference

Leaderboard

GETPublic
/api/v1/leaderboard/companiesPaginated company list with ranks
GETPublic
/api/v1/leaderboard/companies/{slug}Company detail
GETPublic
/api/v1/leaderboard/hype-indexAI Hype Index
GETPublic
/api/v1/leaderboard/moversBiggest rank movers

LLM Pricing

GETPublic
/api/v1/llm/modelsAll LLM models with pricing
GETPublic
/api/v1/llm/providersProvider aggregate stats
GETPublic
/api/v1/llm/compareCross-provider comparison
GETPublic
/api/v1/llm/cheapestCheapest per category
GETPublic
/api/v1/llm/history/{slug}Price history
POSTPublic
/api/v1/llm/estimateCost calculator
GETPublic
/api/v1/llm/price-frontierPrice-performance frontier

Data Marketplace

GETPublic
/api/v1/data/catalogDataset catalog
GETPublic
/api/v1/data/preview/{id}Preview rows
GETFree
/api/v1/data-feed/latestLatest feed
GETFree
/api/v1/data-feed/historicalHistorical feeds

Trading

GETPublic
/api/v1/trading/public-performancePublic track record
GETPro
/api/v1/trading/performanceFull trading data

Billing

POSTPublic
/api/v1/billing/signupCreate account
GETFree
/api/v1/billing/usageUsage stats
POSTFree
/api/v1/billing/upgradeStripe checkout

Reports

POSTPro
/api/v1/reports/company/{slug}Generate report
GETPro
/api/v1/reports/{job_id}/statusCheck progress

Rate Limits

TierDaily LimitRate / Minute
Free10010
Professional1,00060
EnterpriseUnlimitedNone

Embeddable Widgets

Drop live Sector HQ data into any webpage with a single line of HTML.

Company Rank Badge

Display a company's current rank on the Sector HQ rankings. Replace {slug} with the company slug (e.g., openai).

html
<iframe
  src="https://sectorhq-api-fa5v2.ondigitalocean.app/embed/company/{slug}"
  width="300"
  height="200"
  frameborder="0"
></iframe>

Hype Gauge Widget

Show the current AI Hype Index level in a compact gauge format.

html
<iframe
  src="https://sectorhq-api-fa5v2.ondigitalocean.app/embed/hype-gauge"
  width="200"
  height="120"
  frameborder="0"
></iframe>

ChatGPT Plugin

Sector HQ data is available as a ChatGPT plugin, allowing conversational queries against the leaderboard, LLM pricing, and hype index data.

Plugin manifest: /.well-known/ai-plugin.json

Response Format

All responses are returned as application/json.

Success Response

json
{
  "data": [ ... ],
  "meta": {
    "total": 500,
    "page": 1,
    "per_page": 20
  }
}

Error Response

json
{
  "detail": "Invalid API key"
}

HTTP Status Codes

200Success
201Created
400Bad Request
401Unauthorized
403Forbidden (tier too low)
404Not Found
429Rate Limit Exceeded
500Internal Server Error

Ready to get started?

Sign up for a free API key and start integrating Sector HQ data into your applications today.

View Pricing Plans