Enrich investors

curl --request GET \
  --url https://app.tryspecter.com/api/v1/investors \
  --header 'X-API-Key: <api-key>'

[
  {
    "investor_id": "inv_609dba55408c4490fe58cf8e",
    "strategic_signal_ids": [
      "ddea4a84-ffdc-459d-bb10-3d7db9c6c193"
    ],
    "investor_name": "Bessemer Venture Partners",
    "investor_types": [
      "venture_capital"
    ],
    "investment_stage": [
      "Series A"
    ],
    "industry_target": [
      "Software"
    ],
    "specter_industry_target": [
      "Enterprise Software"
    ],
    "specter_tech_verticals_target": [
      "AI / Machine Learning"
    ],
    "fund_details": [
      {
        "name": "BVP Fund XII",
        "announced_on": "2023-04-12",
        "raised_amount_usd": "3850000000"
      }
    ],
    "portfolio_companies": [
      "5e3bbf6b00c8f4c966a1e53d"
    ],
    "person_id": "5e3b9281137e998b5aea67f4",
    "company_id": "5e3b9281137e998b5aea67f4",
    "investor_rank": 43,
    "company_size": "201-500",
    "operating_status": "active",
    "domain": "bvp.com",
    "hq_location": "San Francisco, California, United States, North America",
    "founded_year": 1911,
    "linkedin_url": "linkedin.com/company/bessemer-venture-partners",
    "twitter_url": "x.com/BessemerVP",
    "description": "Bessemer Venture Partners is a leading venture capital firm that partners with entrepreneurs from their early days through every stage of growth.",
    "number_of_exits": 325,
    "number_of_lead_investments": 574,
    "number_of_investments": 1581,
    "number_of_funds": 15
  }
]

Enrichment

Enrich investors

What it does

Searches the Specter investors dataset and returns the investor records matching the identifier(s) provided as query parameters. You can look an investor up by website (domain), by name, or by both.

Why you’d use it

Resolve an inbound mention of an investor — a domain on a deck, a firm name in a press release — to the canonical Specter investor record so you can sync it to CRM or chain into related calls.
Pull the Specter investor ID for downstream calls to /investors/{investorId}, /searches/investors, or list management.

Key behaviours

At least one of website or name is required. Supplying both narrows the match — an investor must match every field provided.
Lookups are case-insensitive. The website parameter accepts URLs with or without scheme/www.; the host is normalised before matching.
Response: an array of investors. The endpoint is a lookup, not a single-result fetch — an ambiguous query (e.g. a shared domain) can legitimately return multiple candidates.
Returns 404 Not Found if no investor matches the provided identifiers.

This endpoint uses 1 credit per investor returned. If the endpoint returns 3 investors then 3 credits are consumed.

GET

investors

Enrich investors

curl --request GET \
  --url https://app.tryspecter.com/api/v1/investors \
  --header 'X-API-Key: <api-key>'

[
  {
    "investor_id": "inv_609dba55408c4490fe58cf8e",
    "strategic_signal_ids": [
      "ddea4a84-ffdc-459d-bb10-3d7db9c6c193"
    ],
    "investor_name": "Bessemer Venture Partners",
    "investor_types": [
      "venture_capital"
    ],
    "investment_stage": [
      "Series A"
    ],
    "industry_target": [
      "Software"
    ],
    "specter_industry_target": [
      "Enterprise Software"
    ],
    "specter_tech_verticals_target": [
      "AI / Machine Learning"
    ],
    "fund_details": [
      {
        "name": "BVP Fund XII",
        "announced_on": "2023-04-12",
        "raised_amount_usd": "3850000000"
      }
    ],
    "portfolio_companies": [
      "5e3bbf6b00c8f4c966a1e53d"
    ],
    "person_id": "5e3b9281137e998b5aea67f4",
    "company_id": "5e3b9281137e998b5aea67f4",
    "investor_rank": 43,
    "company_size": "201-500",
    "operating_status": "active",
    "domain": "bvp.com",
    "hq_location": "San Francisco, California, United States, North America",
    "founded_year": 1911,
    "linkedin_url": "linkedin.com/company/bessemer-venture-partners",
    "twitter_url": "x.com/BessemerVP",
    "description": "Bessemer Venture Partners is a leading venture capital firm that partners with entrepreneurs from their early days through every stage of growth.",
    "number_of_exits": 325,
    "number_of_lead_investments": 574,
    "number_of_investments": 1581,
    "number_of_funds": 15
  }
]

Authorizations

X-API-Key

string

header

required

Query Parameters

website

string

The website or domain of the investor. Accepts the full URL with or without http(s):// and www., or a bare domain like bvp.com.

name

string

The investor's name. Matching is case-insensitive and ignores surrounding whitespace.

Response

The list of investors matching the saved search.

investor_id

string

required

The Specter ID for this company, can be used in other endpoints.

Example:

"inv_609dba55408c4490fe58cf8e"

strategic_signal_ids

string<uuid>[]

required

All Interest Signals IDs associated with this investor. Empty when none are active.

investor_name

string

required

The legal or brand name of the investor or investment firm.

Example:

"Bessemer Venture Partners"

investor_types

string[]

required

The investor types this investor falls under, as lowercase snake_case (e.g. venture_capital, angel_group).

investment_stage

string[]

required

Typical funding round stages in which the investor participates (e.g., Seed, Series A).

industry_target

string[]

required

Industries or verticals in which the investor typically specializes.

specter_industry_target

string[]

required

Only top level. Classifies companies by their economic activity — the market they serve and the products or services they deliver. E.g. Construction, Utilities, Wholesale. There is one industry per company, with up to three levels.

specter_tech_verticals_target

string[]

required

Only top level. Classifies companies by the technology domain they operate in — the technical capability or space they're building around. E.g. AI & Machine Learning, Cybersecurity, FinTech. There can be up to 5 tech verticals per company, with 2 levels each.

fund_details

InvestorFund · object[]

required

The named funds this investor has raised, with announce date and amount when available.

Show child attributes

portfolio_companies

string[]

required

Specter company IDs for portfolio companies of this investor.

person_id

string | null

The Specter person ID this investor is linked to, when the investor is an individual (e.g. an angel). null for firms.

Example:

"5e3b9281137e998b5aea67f4"

company_id

string | null

The Specter company ID of the company associated with this investor, when applicable (e.g. the firm behind a VC fund).

Example:

"5e3b9281137e998b5aea67f4"

investor_rank

integer | null

The Specter rank for this investor.

Example:

43

company_size

string | null

The size bracket of the investor's organisation (employee count band).

Example:

"201-500"

operating_status

string | null

The operating status of the investor (e.g. active, closed).

Example:

"active"

domain

string | null

The investor's primary web domain.

Example:

"bvp.com"

hq_location

string | null

The investor's headquarters location.

Example:

"San Francisco, California, United States, North America"

founded_year

integer | null

The year the investor was founded.

Example:

1911

linkedin_url

string | null

The investor's LinkedIn profile URL.

Example:

"linkedin.com/company/bessemer-venture-partners"

twitter_url

string | null

The investor's Twitter / X profile URL.

Example:

"x.com/BessemerVP"

description

string | null

Brief textual overview of the investor’s activities, history, or focus.

Example:

"Bessemer Venture Partners is a leading venture capital firm that partners with entrepreneurs from their early days through every stage of growth."

number_of_exits

integer | null

Total number of portfolio company exits attributed to this investor.

Example:

325

number_of_lead_investments

integer | null

Total number of investments where the investor led the round.

Example:

574

number_of_investments

integer | null

Total number of investments made by the investor.

Example:

1581

number_of_funds

integer | null

Total number of separate funds managed or raised by the firm.

Example:

15

Reverse Email Lookup Text Search

Documentation Index

Authorizations

Query Parameters

Response