> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Enrich investor
> Looks up investors in the Specter dataset by `website` (domain), `name`, or both, and returns the matching investor records. Use the `investor_id` from a result with [Get investor by ID](/api-reference/investors/get-investor-by-id) for the full profile.
Costs 1 credit per investor returned.
## What you need
At least one of `website` (a domain or full URL) or `name`; supplying both narrows the match.
## Behaviour
- This is a lookup, not a single-result fetch: an ambiguous query (e.g. a shared domain) can return multiple investors.
- Lookups are case-insensitive; `website` accepts a full URL or a bare domain (scheme and `www.` are normalised away).
- Returns `404` if nothing matches, and `422` if neither `website` nor `name` is supplied.
## What you do next
- **Get the full profile.** Pass a result's `investor_id` to [Get investor by ID](/api-reference/investors/get-investor-by-id).
- **Explore the portfolio.** Resolve any `portfolio_companies` ID with [Get company by ID](/api-reference/companies/get-company-by-id).
- **Track their deals.** Pull their rounds and co-investors with [Get investor funding rounds](/api-reference/investors/get-investor-funding-rounds).
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /investors
openapi: 3.0.0
info:
title: Specter API
termsOfService: https://tryspecter.com/terms/
contact:
name: API support
email: api-support@tryspecter.com
version: 1.0.0
servers:
- description: Production
url: https://app.tryspecter.com/api/v1
security:
- ApiKeyAuth: []
tags:
- name: Enrich
description: >
Look up a company, person, or investor and, if Specter does not already
hold it, fetch it on demand. Includes email-based person enrichment.
- name: Search
description: |
Find records across every product from a single plain-English query.
- name: Companies
description: >
Company profiles, funding, headcount, traction, the per-company signals
and sub-resources attached to a single company, and identifier resolution.
- name: People
description: >
Specter people records: profile data, contact details, and per-person
lookups for a known person ID.
- name: Investors
description: >
Specter investor records: profile, activity, targeting, funds, portfolio
companies, and the funding rounds they have participated in.
- name: Transactions
description: |
Transaction detail by ID: funding rounds, acquisitions, and IPOs.
- name: News Signals
description: |
Company-level news signals: by ID, and for a saved list or company search.
- name: Revenue Signals
description: >
Revenue and profitability signals: by ID, by date, and for a saved list or
company search.
- name: Talent Signals
description: |
Talent signals: by ID and in bulk by ID.
- name: Investor Interest Signals
description: |
Investor interest signals: by ID and in bulk by ID.
- name: Company Lists
description: |
Create, query, and maintain lists of companies, including their results.
- name: Investor Lists
description: |
Create, query, and maintain lists of investors, including their results.
- name: People Lists
description: |
Create, query, and maintain lists of people, including their results.
- name: Saved Searches
description: |
List and delete searches saved via tryspecter.com.
- name: Company Saved Searches
description: |
Details and results for saved company searches.
- name: People Saved Searches
description: |
Details and results for saved people searches.
- name: Investor Saved Searches
description: |
Details and results for saved investor searches.
- name: Talent Signals Saved Searches
description: |
Details and results for saved Talent Signals searches.
- name: Investor Interest Saved Searches
description: |
Details and results for saved Investor Interest Signals searches.
- name: Network
description: >
Your team's LinkedIn network: the people and companies your teammates are
connected to, and your reach into a given company.
- name: Account
description: >
Organisation-level resources: your team's members, API call logs, and
credit balance.
paths:
/investors:
get:
tags:
- Enrich
summary: Enrich investor
description: >
Looks up investors in the Specter dataset by `website` (domain), `name`,
or both, and returns the matching investor records. Use the
`investor_id` from a result with [Get investor by
ID](/api-reference/investors/get-investor-by-id) for the full profile.
Costs 1 credit per investor returned.
## What you need
At least one of `website` (a domain or full URL) or `name`; supplying
both narrows the match.
## Behaviour
- This is a lookup, not a single-result fetch: an ambiguous query (e.g.
a shared domain) can return multiple investors.
- Lookups are case-insensitive; `website` accepts a full URL or a bare
domain (scheme and `www.` are normalised away).
- Returns `404` if nothing matches, and `422` if neither `website` nor
`name` is supplied.
## What you do next
- **Get the full profile.** Pass a result's `investor_id` to [Get
investor by ID](/api-reference/investors/get-investor-by-id).
- **Explore the portfolio.** Resolve any `portfolio_companies` ID with
[Get company by ID](/api-reference/companies/get-company-by-id).
- **Track their deals.** Pull their rounds and co-investors with [Get
investor funding
rounds](/api-reference/investors/get-investor-funding-rounds).
parameters:
- name: website
in: query
description: >
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`.
required: false
schema:
type: string
example: bvp.com
- name: name
in: query
description: >
The investor's name. Matching is case-insensitive and ignores
surrounding whitespace.
required: false
schema:
type: string
example: Bessemer Venture Partners
responses:
'200':
$ref: '#/components/responses/InvestorsResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/OutOfCredits'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'422':
description: >-
Missing required query parameter (provide at least one of `website`
or `name`).
'429':
$ref: '#/components/responses/RateLimits'
components:
responses:
InvestorsResponse:
description: The investors matching the lookup.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Investor'
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
OutOfCredits:
description: Out of credits - API credit limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
enum:
- OUT_OF_CREDITS
message:
type: string
description: |
There are no more credits available to complete the request.
headers:
X-CreditLimit-Limit:
schema:
type: integer
description: The total number of credits allocated for the current period
X-CreditLimit-Remaining:
schema:
type: integer
description: The number of credits remaining for the current period
X-CreditLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the credit limit resets
Forbidden:
description: Forbidden - There is no permissions to use the endpoint
content:
application/json:
schema:
type: object
properties:
errorCode:
description: NOT_PERMITTED
type: string
example: NOT_PERMITTED
message:
type: string
description: You do not have permission to access this resource.
example: You do not have permission to access this resource.
required:
- errorCode
- message
NotFound:
description: Not Found
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: NOT_FOUND
message:
type: string
description: Not Found
RateLimits:
description: Too Many Requests - API Rate limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: RATE_LIMITED
message:
type: string
description: You have been rate-limited
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The total rate limit allowed for this endpoint
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining
X-RateLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the rate limit resets
schemas:
Investor:
title: Investor
type: object
required:
- investor_id
- investor_name
additionalProperties: false
properties:
investor_id:
type: string
description: The Specter ID for this investor, can be used in other endpoints.
example: inv_84f563826c689ceb42aff52a
strategic_signal_ids:
type: array
description: >-
All Interest Signals IDs associated with this investor. Empty when
none are active.
items:
type: string
format: uuid
example: ddea4a84-ffdc-459d-bb10-3d7db9c6c193
example:
- 9d7dea32-d8f2-46ab-a794-562dd5775877
- e4f05086-8862-4f05-b871-b7485d84e996
- e63e5f0b-2d02-491d-9f7f-6f4cb7c141e1
- ce1dc8a4-4a53-49e9-ad79-7e741d8f4eca
- 2cb275ef-463f-4102-85af-4674e72502f7
- 41da8f9f-947f-4c37-a054-cc056d8fe8aa
- a59913fa-4fe3-4426-9e02-e661e50d659c
- 1b5d35c7-b553-4589-a7e0-8f2bfebdce0c
- 3512c9d6-dc5d-448f-8aa3-83688f90c6f1
- ce0fb6bb-04de-4d1c-93ea-6da5c724bf6c
person_id:
type: string
nullable: true
description: >-
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:
type: string
nullable: true
description: >-
The Specter company ID of the company associated with this investor,
when applicable (e.g. the firm behind a VC fund).
example: 5e3bbc2600c8f4c966983640
investor_name:
type: string
description: The legal or brand name of the investor or investment firm.
example: Sequoia Capital
investor_rank:
type: integer
nullable: true
description: The Specter rank for this investor.
example: 12
company_size:
type: string
nullable: true
description: >-
The size bracket of the investor's organization (employee count
band).
example: 201-500
operating_status:
type: string
nullable: true
description: The operating status of the investor (e.g. `active`, `closed`).
example: active
domain:
type: string
nullable: true
description: The investor's primary web domain.
example: sequoiacap.com
hq_location:
type: string
nullable: true
description: The investor's headquarters location.
example: Menlo Park, California, United States, North America
founded_year:
type: integer
nullable: true
description: The year the investor was founded.
example: 1972
investor_types:
type: array
description: >-
The investor types this investor falls under, as lowercase
snake_case (e.g. `venture_capital`, `angel_group`).
items:
type: string
example: venture_capital
example:
- venture_capital
linkedin_url:
type: string
nullable: true
description: The investor's LinkedIn profile URL.
example: linkedin.com/company/sequoia
twitter_url:
type: string
nullable: true
description: The investor's Twitter / X profile URL.
example: x.com/sequoia
description:
type: string
nullable: true
description: >-
Brief textual overview of the investor's activities, history, or
focus.
example: >-
Sequoia Capital is a venture capital firm founded by Don Valentine
in 1972, with a mission to help daring founders build legendary
companies from idea to IPO and beyond. They invest in a select few
outliers each year, providing hands-on support throughout the
company's lifecycle. Sequoia's expertise is drawn from 50 years of
partnering with iconic founders. Their backing has resulted in
companies accounting for over 25% of NASDAQ's total value. A
significant portion of their investments is made on behalf of
nonprofits and schools, directing returns to these organizations.
number_of_exits:
type: integer
nullable: true
description: Total number of portfolio company exits attributed to this investor.
example: 453
number_of_lead_investments:
type: integer
nullable: true
description: Total number of investments where the investor led the round.
example: 884
number_of_investments:
type: integer
nullable: true
description: Total number of investments made by the investor.
example: 2392
number_of_funds:
type: integer
nullable: true
description: Total number of separate funds managed or raised by the firm.
example: 36
investment_stage:
type: array
description: >-
Typical funding round stages in which the investor participates
(e.g., Seed, Series A).
items:
type: string
example: Series A
example:
- Angel
- Convertible Note
- Corporate Round
- Debt Financing
- Equity Crowdfunding
- Grant
- Initial Coin Offering
- Post Ipo Debt
- Post Ipo Equity
- Pre Seed
industry_target:
type: array
description: Industries or verticals in which the investor typically specializes.
items:
type: string
example: Software
example:
- Administrative Services
- Advertising
- Agriculture and Farming
- Biotechnology
- Blockchain and Crypto
- Clothing and Apparel
- Commerce and Shopping
- Community and Lifestyle
- Construction
- Consumer Products
specter_industry_target:
type: array
description: >-
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.
items:
type: string
example: Enterprise Software
example:
- Accommodation Services
- Accounting
- Administrative and Support Services
- Advertising Services
- Agricultural Technology
- Airlines and Aviation
- Appliances, Electrical, and Electronics Manufacturing
- Architecture and Planning
- Artists and Writers
- Automation Machinery Manufacturing
specter_tech_verticals_target:
type: array
description: >-
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.
items:
type: string
example: AI / Machine Learning
example:
- AI & Machine Learning
- AI Agents and Process Copilots
- AI Evaluation and Benchmarking
- AI Media and Virtual Creators
- AI Platforms, SDKs and APIs
- AI Safety and Governance
- AI Sales Copilots, Conversation Intelligence, and Assistants
- AI Security and Model Protection
- AI Tutors and Adaptive Learning
- AI and Analytics for Supply Chain Optimization
fund_details:
type: array
description: >-
The named funds this investor has raised, with announce date and
amount when available.
items:
$ref: '#/components/schemas/InvestorFund'
portfolio_companies:
type: array
description: Specter company IDs for portfolio companies of this investor.
items:
type: string
example: 5e3bbf6b00c8f4c966a1e53d
example:
- 5e3a8f1b040ca7b0c6f06a3c
- 6495263511c3a8c65a7c742d
- 67b7765cc3099373c3e3803a
- 5e3b927f137e998b5aea5e93
- 5e3b65e8ab6348f63cd9e5df
- 60422e064ddab8d8bf2b6338
- 5ed1cf8b4ae879e7872a002c
- 5e3bc0f900c8f4c966a6ded6
- 5e3a8f1b040ca7b0c6f07476
- 5e3b9fe6137e998b5aee9c4b
ApiKeyMissing:
properties:
errorCode:
description: API_KEY_MISSING
example: API_KEY_MISSING
type: string
message:
description: No API Key was presented on the header X-API-KEY
example: No API Key was presented on the header X-API-KEY
type: string
ApiKeyNotValid:
properties:
errorCode:
description: API_KEY_NOT_VALID
example: API_KEY_NOT_VALID
type: string
message:
description: API key present, but not valid
example: API key present, but not valid
type: string
InvestorFund:
title: InvestorFund
type: object
description: A single fund raised by an investor.
additionalProperties: false
properties:
name:
type: string
nullable: true
description: The fund's name.
example: Sequoia Capital Venture Fund II
announced_on:
type: string
format: date
nullable: true
description: ISO date (YYYY-MM-DD) the fund was announced.
example: '2025-10-27'
raised_amount_usd:
type: string
nullable: true
description: Amount raised in USD.
example: '750000000'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````