> ## 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.
# Find investor ID
> Resolve a batch of investor websites and names into the Specter `investor_id`. Re-use that id with the id-only investor endpoints such as [Get investor by ID](/api-reference/investors/get-investor-by-id).
Free. This call does not consume credits. The id-only endpoints you call next are charged as usual.
## What you need
One or more websites and/or names to resolve (1–50 per request). No Specter ID is required; that is what this returns.
## Behaviour
- Pass inputs under `to_resolve` (1–50 per request). Each entry needs at least one of `website` or `name`; an empty entry returns a validation error. Supplying both narrows the match.
- The response has one result group per input, in the same order, so you can attribute each set of matches back to what you sent. `query` echoes the input.
- `website` is reduced to its domain before matching, so a URL with a scheme or `www.` resolves the same as the bare domain.
- `name` is matched case-insensitively and ignores surrounding whitespace. An ambiguous name can match several firms, so use the returned `website`, `hq_location` and `founded_year` to pick the right one.
- An input that matches nothing keeps its place with an empty `matches` list.
## What you do next
- **Get the full profile.** Pass the returned `investor_id` to [Get investor by ID](/api-reference/investors/get-investor-by-id).
- **Track their deals.** Pull their rounds and co-investors with [Get investor funding rounds](/api-reference/investors/get-investor-funding-rounds).
- **See what they're circling.** Read [Get investor-interest signals](/api-reference/investors/get-investor-interest-signals) for the resolved firm.
## OpenAPI
````yaml /api-ref/bundle_api.yaml post /investors/resolve
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: 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: Funding Rounds Saved Searches
description: |
Details and results for saved funding-round searches.
- name: Acquisitions Saved Searches
description: |
Details and results for saved acquisition searches.
- name: IPOs Saved Searches
description: |
Details and results for saved IPO 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/resolve:
post:
tags:
- Investors
summary: Find investor ID
description: >
Resolve a batch of investor websites and names into the Specter
`investor_id`. Re-use that id with the id-only investor endpoints such
as [Get investor by ID](/api-reference/investors/get-investor-by-id).
Free. This call does not consume credits. The id-only endpoints
you call next are charged as usual.
## What you need
One or more websites and/or names to resolve (1–50 per request). No
Specter ID is required; that is what this returns.
## Behaviour
- Pass inputs under `to_resolve` (1–50 per request). Each entry needs at
least one of `website` or `name`; an empty entry returns a validation
error. Supplying both narrows the match.
- The response has one result group per input, in the same order, so you
can attribute each set of matches back to what you sent. `query` echoes
the input.
- `website` is reduced to its domain before matching, so a URL with a
scheme or `www.` resolves the same as the bare domain.
- `name` is matched case-insensitively and ignores surrounding
whitespace. An ambiguous name can match several firms, so use the
returned `website`, `hq_location` and `founded_year` to pick the right
one.
- An input that matches nothing keeps its place with an empty `matches`
list.
## What you do next
- **Get the full profile.** Pass the returned `investor_id` to [Get
investor by ID](/api-reference/investors/get-investor-by-id).
- **Track their deals.** Pull their rounds and co-investors with [Get
investor funding
rounds](/api-reference/investors/get-investor-funding-rounds).
- **See what they're circling.** Read [Get investor-interest
signals](/api-reference/investors/get-investor-interest-signals) for the
resolved firm.
requestBody:
description: The investors to resolve.
required: true
content:
application/json:
schema:
type: object
properties:
to_resolve:
type: array
minItems: 1
maxItems: 50
items:
$ref: '#/components/schemas/InvestorResolveIdentifier'
required:
- to_resolve
additionalProperties: false
example:
to_resolve:
- website: bvp.com
- name: Index Ventures
- website: https://www.sequoiacap.com/
name: Sequoia Capital
responses:
'200':
$ref: '#/components/responses/InvestorResolveResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'422':
description: >
`to_resolve` is missing or empty, or an item provides neither
`website` nor `name`.
'429':
$ref: '#/components/responses/RateLimits'
components:
schemas:
InvestorResolveIdentifier:
type: object
description: >
One investor to resolve. Supply at least one of the fields below;
supplying both narrows the match.
properties:
website:
description: >
Investor website or domain. Accepts `http`/`https`, with or without
`www`.
type: string
example: bvp.com
name:
description: >
Investor name. Matched case-insensitively, ignoring surrounding
whitespace; an ambiguous name can match several firms.
type: string
example: Bessemer Venture Partners
additionalProperties: false
BasicInvestor:
type: object
description: >
The minimum needed to identify an investor and re-use their Specter id,
plus enough profile to choose between candidates when a name is
ambiguous.
properties:
investor_id:
description: Specter investor id. Pass it to the id-only investor endpoints.
type: string
example: inv_5f3a2b1c4d5e6f7a8b9c0d1e
investor_name:
description: The investor's name.
type: string
example: Bessemer Venture Partners
website:
description: The investor's domain, as stored by Specter.
type: string
example: bvp.com
linkedin_url:
description: The investor's LinkedIn URL.
type: string
example: https://www.linkedin.com/company/bessemer-venture-partners
description:
description: Short description of the firm.
type: string
founded_year:
description: Year the firm was founded.
type: integer
example: 1911
hq_location:
description: The firm's headquarters.
type: string
example: San Francisco, CA, United States
required:
- investor_id
- investor_name
additionalProperties: false
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
responses:
InvestorResolveResponse:
description: |
One result group per input, in the same order as `to_resolve`.
content:
application/json:
schema:
type: array
items:
type: object
properties:
query:
$ref: '#/components/schemas/InvestorResolveIdentifier'
description: The input this group resolves.
matches:
description: >
Matching investors. Empty when nothing matched; several
firms are possible when a `name` is ambiguous.
type: array
items:
$ref: '#/components/schemas/BasicInvestor'
required:
- query
- matches
additionalProperties: false
example:
- query:
website: bvp.com
matches:
- investor_id: inv_5f3a2b1c4d5e6f7a8b9c0d1e
investor_name: Bessemer Venture Partners
website: bvp.com
linkedin_url: https://www.linkedin.com/company/bessemer-venture-partners
description: >-
Multi-stage venture firm investing across enterprise,
consumer and healthcare.
founded_year: 1911
hq_location: San Francisco, CA, United States
- query:
name: Not A Real Fund
matches: []
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
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
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
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````