Introduction - Signalbase Documentation

Welcome to the Investors API

The Investors API provides access to comprehensive venture capital and investor data aggregated from across the web. Our platform continuously monitors and collects information on VCs, angel investors, private equity firms, corporate investors, and more, giving you up-to-date intelligence on the investment landscape.

Investors Endpoint

View the complete OpenAPI specification

Count Mode

You can get the total number of results matching any filter combination without consuming credits by adding count=true to your request. This returns an empty data array with full pagination metadata, including totalCount.

curl -X GET "https://www.trysignalbase.com/api/v2/signals/investors?count=true&type=vc,angel&countries=US" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "success": true,
  "data": [],
  "pagination": {
    "currentPage": 1,
    "totalPages": 22,
    "totalCount": 430,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "signals.investors",
    "creditsUsed": 0
  }
}

Use count mode to preview how many results match your filters before fetching actual data. This is useful for building filter UIs, showing result counts, or validating queries — all at zero credit cost.

Key Features

Comprehensive Coverage: Access data on VCs, angels, PE firms, corporate investors, hedge funds, crowdfunding platforms, and more
Advanced Filtering: Filter by countries, investor types, HQ location, and ticket size ranges
Flexible Sorting: Sort by name, created date, or ticket size
Date Filtering: Filter by created date or use date presets for relative ranges
Pagination Support: Efficiently retrieve large datasets with up to 100 results per page
Rich Investor Data: Detailed information on investment focus, portfolio, and contact details
Credit-based Usage: Transparent credit consumption per API call

Service Level

Rate Limit: Based on your subscription tier
Uptime: 99% guaranteed uptime
Data Freshness: Continuously updated investor information
Maximum Results: Up to 100 results per page

Authentication

All API endpoints require authentication using a Bearer token passed in the Authorization header.

curl -X GET "https://www.trysignalbase.com/api/v2/signals/investors?page=1&limit=20&type=vc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Pagination

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	20	Results per page (max: 100)

Date Filters

Parameter	Type	Description
`dateFrom`	string	Filter by created date from (ISO-8601 string)
`dateTo`	string	Filter by created date to (ISO-8601 string)
`date_preset`	string	Relative date shorthand — takes precedence over `dateFrom`/`dateTo`. See Date Presets

Investor Filters

Parameter	Type	Description
`countries`	string	Comma-separated country codes (e.g., `US,GB,DE`)
`type`	string	Comma-separated investor types. See Investor Types
`categories`	string	Legacy: pipe-separated investor types (same values as `type`)
`headquarters`	string	Search by HQ location (partial match)
`search`	string	Free-text search across investor name & type

Numeric Range Filters

Parameter	Type	Description
`ticket_size_min`	integer	Minimum ticket size in USD
`ticket_size_max`	integer	Maximum ticket size in USD

Sorting

Parameter	Type	Default	Description
`sort_by`	string	`created_at`	Sort field: `name`, `created_at`, `ticket_size_min`, `ticket_size_max`
`sort_order`	string	`desc`	Sort direction: `asc` or `desc`

Investor Types

The API supports filtering by the following investor types:

vc: Venture Capital firms
angel: Angel investors and angel groups
pe: Private Equity firms
corporate: Corporate venture arms and strategic investors
government: Government-backed investment entities
accelerator: Startup accelerators and incubators
family_office: Family offices
hedge_fund: Hedge funds
crowdfunding: Crowdfunding platforms

These are case-insensitive groupings over a free-text type field, so e.g. vc matches VC, VC firm, Venture Capital, venture_capital, and Corporate VC. The type value returned in the response is the original scraped string (not the slug), so a single type=vc query returns rows with mixed type values. For values outside this list, use search.

Response Structure

All successful responses follow this structure:

{
  "success": true,
  "data": [
    {
      "id": "uuid-here",
      "name": "Sequoia Capital",
      "investorType": "vc",
      "country": "United States",
      "description": "Leading venture capital firm...",
      "website": "https://www.sequoiacap.com",
      ...
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 10,
    "totalCount": 200,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "meta": {
    "endpoint": "signals.investors",
    "creditsUsed": 1
  }
}

Error Handling

The API returns standard HTTP status codes:

200: Success
401: Unauthorized - Invalid or missing API key
429: Rate limit exceeded
500: Internal server error

Error responses include:

{
  "success": false,
  "error": "Error message description"
}

Example Usage

Filter by Investor Type

curl -X GET "https://www.trysignalbase.com/api/v2/signals/investors?type=vc,angel&countries=US" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by Ticket Size Range

curl -X GET "https://www.trysignalbase.com/api/v2/signals/investors?ticket_size_min=100000&ticket_size_max=5000000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search by HQ Location with Sorting

curl -X GET "https://www.trysignalbase.com/api/v2/signals/investors?headquarters=San%20Francisco&sort_by=name&sort_order=asc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Combined Filters

curl -X GET "https://www.trysignalbase.com/api/v2/signals/investors?type=vc&countries=US,GB&ticket_size_min=500000&sort_by=ticket_size_max&sort_order=desc&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

​Welcome to the Investors API

Investors Endpoint

​Count Mode

​Key Features

​Service Level

​Authentication

​Query Parameters

​Pagination

​Date Filters

​Investor Filters

​Numeric Range Filters

​Sorting

​Investor Types

​Response Structure

​Error Handling

​Example Usage

​Filter by Investor Type

​Filter by Ticket Size Range

​Search by HQ Location with Sorting

​Combined Filters

Welcome to the Investors API

Count Mode

Key Features

Service Level

Authentication

Query Parameters

Pagination

Date Filters

Investor Filters

Numeric Range Filters

Sorting

Investor Types

Response Structure

Error Handling

Example Usage

Filter by Investor Type

Filter by Ticket Size Range

Search by HQ Location with Sorting

Combined Filters