DatahyenaDatahyena
API Reference

Investors

Investor directory records with search, type, country, and domain filters.

GET
/v1/investors

Search and filter investor records. Costs one credit per returned record.

X-API-Key<token>

In: header

Query Parameters

cursor?string

Opaque pagination cursor returned as pagination.nextCursor.

since?string

Return investors created or updated on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.

limit?number

Maximum records to return.

Default20
Range1 <= value <= 100
search?string

Keyword search over investor name and domain.

type?array<>

Investor type filters. Accepts repeated query keys or comma-separated values.

countries?array<>

Headquarters country codes (OR). Repeat the query key for multiple values. Use unknown to match companies with no country on file.

domain?string

Exact investor domain.

hasFirmographics?boolean

Return only investors that have firmographics (a website domain and a known type). Individual angels and firms we could not identify are excluded.

minRoundUsd?number

Return only investors that have participated in at least one round at or above this amount, in whole USD. Filters on what an investor has actually done rather than on how it is labelled.

Range0 <= value
minRounds?number

Return only investors that have participated in at least this many rounds.

Range1 <= value
activeSince?string

Return only investors whose most recent round was announced on or after this date (YYYY-MM-DD).

investsIn?array<>

Return only investors that have funded companies headquartered in these countries (OR). Filters on where an investor actually deploys rather than where it is registered, which is both a more useful question and far better covered: 40,692 investors have market data against 2,208 with an HQ country on file.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/investors"
{  "success": true,  "data": [    {      "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40",      "name": "Example Ventures",      "type": "vc",      "hqCountry": {        "code": "US",        "name": "United States"      },      "domain": "example.vc",      "roundsCount": 42,      "largestRoundUsd": 120000000,      "firstRoundAt": "2021-03-04T00:00:00.000Z",      "lastRoundAt": "2026-08-14T00:00:00.000Z",      "activeMarkets": [        {          "code": "US",          "name": "United States"        }      ]    }  ],  "pagination": {    "hasMore": true,    "nextCursor": "eyJpZCI6IjAxOWU4YTNjLTJiMTAtN2M0NC04YTFmLTlkOGU3YzZiNWE0MCJ9"  },  "meta": {    "endpoint": "funding_events.list",    "creditsUsed": 20,    "creditsRemaining": 980  }}
{  "success": false,  "error": {    "code": "INVALID_INPUT",    "message": "limit must not be greater than 100"  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "UNAUTHORIZED",    "message": "Missing or invalid API key."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "PAYMENT_REQUIRED",    "message": "Workspace has no credits remaining. Top up to continue."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "FORBIDDEN",    "message": "Request blocked by abuse prevention policy."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "TOO_MANY_REQUESTS",    "message": "Rate limit exceeded for this workspace and plan."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}