API Documentation

Build with the UnicornHunt API

The same data that powers the web app, over REST and JSON. Companies, investors, sectors and funding events, filterable the same way they are in the product.

REST
JSON over HTTPS, cursor paginated
<100ms
p50 response time on cached reads
8
Core endpoints
3
Official SDKs

Built to be boring to integrate

Predictable shapes, predictable errors, predictable latency. Nothing clever, which is the point.

Fast

Sub-100ms p50 response times. Reads are edge-cached, so list endpoints stay fast under load.

Secure

Bearer-token authentication, scoped keys per environment, and IP allowlists on request.

The same data

No separate API dataset and no delayed feed. You read exactly what the web app reads, refreshed on the same daily cycle.

Easy to integrate

REST and JSON, with official SDKs for Python, Node and Go if you would rather not hand-roll a client.

Quickstart in three steps

From a fresh account to a parsed response in about five minutes.

01  Get an API key
Settings

Sign in, then go to Settings → API Keys to generate a key. Enterprise customers can scope keys per environment.

02  Make your first request
bash
# bash
curl -X GET "https://api.unicornhunt.com/v1/companies?sector=fintech&stage=series-a" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
03  Read the response
json
{
  "data": [
    {
      "id": "co_1a2b3c",
      "name": "Acme Pay",
      "sector": "fintech",
      "stage": "series-a",
      "founded": "2021-03-12",
      "hq": { "city": "London", "country": "GB" },
      "last_funding": {
        "round": "Series A",
        "amount_usd": 18000000,
        "closed_at": "2025-08-04",
        "lead_investor": "Index Ventures"
      }
    }
  ],
  "page": { "next_cursor": "eyJpZCI6ImNvXzkifQ" }
}

Core endpoints

Eight endpoints cover the whole surface. Every list endpoint takes the same filter parameters as the equivalent screen in the product.

/v1
REST · JSON
MethodEndpointDescription
GET/v1/companiesList companies, with filters for sector, geography, stage.
GET/v1/companies/{id}Full company profile, including funding history and team.
GET/v1/investorsList investors. Filter by check size, sector focus, geography.
GET/v1/investors/{id}Investor profile with portfolio and recent activity.
GET/v1/sectorsSector overviews with funding flows and deal counts.
GET/v1/locationsGeographic ecosystem stats.
GET/v1/funding-roundsRecent funding events with rich filtering.
POST/v1/watchlistsCreate a watchlist of companies, investors, or sectors.

Official SDKs

Thin clients over the same REST surface. Use one if it saves you time; the API is perfectly usable without.

Python

Idiomatic Python client with type hints and async support.

pip install unicornhunt

Node.js

TypeScript-first SDK with full IntelliSense.

npm install @unicornhunt/sdk

Go

Lightweight Go module for backend services.

go get github.com/unicornhunt/unicornhunt-go

Rate limits

Per-hour request ceilings by plan. Enterprise keys can be scoped and limited per environment.

1,000
Starter · requests / hour
10,000
Professional · requests / hour
Custom
Enterprise · agreed per contract

Start with a single curl

Generate a key, run the quickstart request, and see the shape of the data for yourself.