> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trysignalbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Access comprehensive VC and investor data with advanced filtering, sorting, and search

## 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.

<Card title="Investors Endpoint" icon="hand-holding-dollar" href="/api-reference/investors/endpoint/get">
  View the complete OpenAPI specification
</Card>

## 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`.

```bash theme={null}
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:**

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

<Tip>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.</Tip>

## 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.

```bash theme={null}
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](/enums#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](/enums#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

## Response Structure

All successful responses follow this structure:

```json theme={null}
{
  "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:

```json theme={null}
{
  "success": false,
  "error": "Error message description"
}
```

## Example Usage

### Filter by Investor Type

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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"
```