> ## 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.
# Bulk get Investor Interest Signals by ID
> Retrieve up to 50 investor-interest signals in a single request by supplying a list of signal IDs. This is the bulk counterpart to `GET /investor-interest/{signalId}`.
The request body is a JSON array of signal IDs (1-50). Unknown IDs are silently omitted from the response, and duplicate IDs are honored. The response order is not guaranteed.
Costs 1 credit per signal returned. Unknown IDs are not charged.
## OpenAPI
````yaml /api-ref/bundle_api.yaml post /investor-interest/by-id/bulk
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:
/investor-interest/by-id/bulk:
post:
tags:
- Investor Interest Signals
summary: Bulk get Investor Interest Signals by ID
description: >
Retrieve up to 50 investor-interest signals in a single request by
supplying a list of signal IDs. This is the bulk counterpart to `GET
/investor-interest/{signalId}`.
The request body is a JSON array of signal IDs (1-50). Unknown IDs are
silently omitted from the response, and duplicate IDs are honored. The
response order is not guaranteed.
Costs 1 credit per signal returned. Unknown IDs are not charged.
requestBody:
required: true
content:
application/json:
schema:
type: array
minItems: 1
maxItems: 50
items:
type: string
format: uuid
example: 0340bac8-bcee-46a2-94bf-cf77e0c34253
example:
- f7e8e33a-ea66-40e4-a567-e2afc8638bd2
- f813bc0a-147a-483a-8254-88a4f9c1ae48
- f856abe0-2f63-4239-a2bd-9e8d7512659e
responses:
'200':
description: >
The investor-interest signals matching the supplied IDs. Unknown IDs
are omitted.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/InvestorInterest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
components:
schemas:
InvestorInterest:
properties:
signal_id:
description: Unique identifier for this investor interest signal
type: string
example: f7e8e33a-ea66-40e4-a567-e2afc8638bd2
signal_date:
description: Date when the talent signal was detected
type: string
example: '2026-07-10'
signal_score:
description: Confidence score for this talent signal (1-10 scale)
type: number
example: 8
signal_summary:
description: Summary of the signal
type: string
example: >-
A Partner at General Catalyst and Evantic Capital are both exploring
BORN amid early-stage fundraising. BORN creates AI friends that
provide companionship and connection through AI and consumer social
experiences.
signal_type:
description: Type of talent signal detected
type: string
enum:
- Company
- Talent
example: Company
source_types:
description: The course of the signal
type: string
enum:
- influencer
- journalist
- investor
- insider
- angel
- investment_bank
- venture_capital
- private_equity
example:
- venture_capital
signal_total_funding_usd:
description: The total funding in USD when the signal was triggered
type: number
example: 15000000
signal_last_funding_date:
description: The total funding date when the signal was triggered
type: string
example: '2025-09-01'
signal_investors:
description: The investors for this signal
type: array
items:
type: object
description: Information about the investor
properties:
name:
type: string
description: The full name of the investor
example: Accel
entity_id:
description: >
Unique identifier of the entity that this signal is for, if it's a
Company signal then this is the company id, if it's a Talent signal
then this is the person id.
Note that this may not exist, in which case for company signals the
`domain` can be used and for talent signals the linkedin_url can be
used.
type: string
example: 5e3a7f110aa7a3270a54b92e
company:
type: object
description: Information about the company if it is a company signal.
properties:
name:
description: Name of the company
type: string
example: BORN
description:
description: A description for what the company does, and who they are.
type: string
example: >-
Born creates AI friends-companions that enter people's lives at
the right moment and stay for a lifetime. These friends are
always there when needed most, making conversations, play, and
connection fun. At the intersection of AI and consumer social,
Born is building experiences that feel natural, joyful, and
lasting.
website:
description: >-
The website url, will contain the protocol, and may contain
`www.`.
type: string
example: http://born.com/
linkedin_url:
description: Linkedin URL (if any) of the company
type: string
example: https://www.linkedin.com/company/born-dot-com
twitter_url:
description: Twitter URL (if any) of the company
type: string
example: None
founded_year:
description: The year that the company was founded.
type: number
example: 2022
hq:
$ref: '#/components/schemas/HQ'
description: Location information about the companies HQ.
industry:
$ref: '#/components/schemas/Industry'
tech_verticals:
$ref: '#/components/schemas/TechVertical'
is_industry_estimated:
description: Whether the industry is estimated or not.
type: boolean
example: false
customer_focus:
$ref: '#/components/schemas/CustomerFocus'
description: The type of customers the company deals with.
required:
- name
additionalProperties: false
person:
type: object
description: Information about the person if it is a talent signal.
properties:
full_name:
description: Full name
type: string
example: Gudmundur Bjarni Olafsson
description:
description: A description of the person.
nullable: true
type: string
example: >-
AI/ML researcher and entrepreneur with a focus on computer
vision applications. Previously led ML teams at Google and
founded an AI startup.
website:
description: Website (if any) of the company the person may be related to.
type: string
linkedin_url:
description: URL for LinkedIn account.
type: string
example: https://www.linkedin.com/in/gudmundurbjarni
twitter_url:
description: URL for Twitter account.
nullable: true
type: string
example: https://x.com/gudmundur
founded_year:
description: The year that the company the person is related to was founded.
type: number
example: 2026
location:
$ref: '#/components/schemas/HQ'
description: Location information about the person
industry:
$ref: '#/components/schemas/Industry'
tech_verticals:
$ref: '#/components/schemas/TechVertical'
is_industry_estimated:
description: Whether the industry is estimated or not.
type: boolean
example: true
required:
- full_name
additionalProperties: false
signal_last_funding_usd:
nullable: true
type: integer
description: >-
The company's most recent funding round amount in USD, as of the
signal date.
signal_source:
type: array
items:
type: string
description: >-
The sources this signal was derived from (e.g. the article or filing
references that triggered it).
required:
- company
- entity_id
- person
- signal_date
- signal_id
- signal_investors
- signal_last_funding_date
- signal_last_funding_usd
- signal_score
- signal_source
- signal_summary
- signal_total_funding_usd
- signal_type
- source_types
additionalProperties: false
title: Investor Interest Signal
type: object
HQ:
properties:
city:
description: City for the location.
type: string
example: South San Francisco
state:
description: >-
State for the location, outside of America will relate to the
country and region.
type: string
example: California
country:
description: Country for the location.
type: string
example: United States
region:
description: Use `continent` instead.
type: string
example: North America
deprecated: true
continent:
description: The continent the HQ is in.
type: string
example: North America
regions:
description: Any regions that the HQ is in.
type: array
items:
type: string
example:
- San Francisco Bay Area
required:
- city
- state
- country
- region
additionalProperties: false
title: HQ
type: object
Industry:
type: array
items:
type: string
example: Financial Services
example:
- Financial Services
- Financial Technology
description: >
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.
nullable: true
TechVertical:
type: array
items:
type: array
items:
type: string
example: Blockchain, Crypto & Web3
example:
- - Blockchain, Crypto & Web3
- Crypto Exchanges and Trading Infrastructure
title: Experience.tech_verticals
description: >
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.
nullable: true
CustomerFocus:
type: string
enum:
- b2b
- b2c
- b2b_b2c
- b2c_b2b
example: b2c
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:
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
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````