> ## 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.
# Get talent signal saved search results
> Returns the talent signals matching a saved talent search.
Costs 1 credit per result returned.
## What you need
A talent saved-search ID shared with the API; get one from [Get all saved searches](/api-reference/saved-searches/get-all-saved-searches), or check counts first with [Get talent signal saved search](/api-reference/talent-signals-saved-searches/get-talent-signal-saved-search).
## Behaviour
- Page through with `page` and `limit`.
- Set `new=true` to restrict results to the current week; it overrides the stored date filter.
- Bound results by signal date with `talent_signal_date_after` / `talent_signal_date_before` (both inclusive; an explicit date overrides `new`).
- Must be a talent search, otherwise `400` with `NOT_SUPPORTED_PRODUCT`.
- Returns `404` if the search doesn't exist or isn't accessible.
## What you do next
- **Open the person.** Pass a `person_id` to [Get person by ID](/api-reference/people/get-person-by-id).
- **Read the signal.** Pass a `talent_signal_id` to [Get Talent Signal by ID](/api-reference/talent-signals/get-talent-signal-by-id).
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /searches/talent/{searchId}/results
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:
/searches/talent/{searchId}/results:
get:
tags:
- Talent Signals Saved Searches
summary: Get talent signal saved search results
description: >
Returns the talent signals matching a saved talent search.
Costs 1 credit per result returned.
## What you need
A talent saved-search ID shared with the API; get one from [Get all
saved searches](/api-reference/saved-searches/get-all-saved-searches),
or check counts first with [Get talent signal saved
search](/api-reference/talent-signals-saved-searches/get-talent-signal-saved-search).
## Behaviour
- Page through with `page` and `limit`.
- Set `new=true` to restrict results to the current week; it overrides
the stored date filter.
- Bound results by signal date with `talent_signal_date_after` /
`talent_signal_date_before` (both inclusive; an explicit date overrides
`new`).
- Must be a talent search, otherwise `400` with `NOT_SUPPORTED_PRODUCT`.
- Returns `404` if the search doesn't exist or isn't accessible.
## What you do next
- **Open the person.** Pass a `person_id` to [Get person by
ID](/api-reference/people/get-person-by-id).
- **Read the signal.** Pass a `talent_signal_id` to [Get Talent Signal
by ID](/api-reference/talent-signals/get-talent-signal-by-id).
operationId: getTalentSearchResults
parameters:
- $ref: '#/components/parameters/SearchId'
- $ref: '#/components/parameters/PaginationLimit'
- $ref: '#/components/parameters/PaginationPage'
- $ref: '#/components/parameters/NewSignalsQueryParam'
- in: query
name: talent_signal_date_after
required: false
schema:
type: string
format: date
example: '2026-06-01'
description: >
Only return signals with a signal date on or after this date
(`YYYY-MM-DD`, inclusive). Overrides `new` when both are given.
- in: query
name: talent_signal_date_before
required: false
schema:
type: string
format: date
example: '2026-06-30'
description: >
Only return signals with a signal date on or before this date
(`YYYY-MM-DD`, inclusive).
responses:
'200':
$ref: '#/components/responses/TalentResultsResponse'
'400':
description: BadRequest
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/SearchIdBadRequest'
- $ref: '#/components/schemas/NotSupportedProduct'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/OutOfCredits'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimits'
components:
parameters:
SearchId:
in: path
name: searchId
schema:
type: integer
required: true
description: The ID of the saved search being requested.
PaginationLimit:
in: query
name: limit
schema:
type: number
required: false
description: The number of results to return, default is 50.
PaginationPage:
in: query
name: page
schema:
type: number
required: false
description: The page number of results to return, base 0, default is 0.
NewSignalsQueryParam:
in: query
name: new
schema:
type: boolean
default: false
required: false
description: >
When `true`, restricts results to signals from the current week,
overriding any `SignalDate` filter stored in the saved search.
responses:
TalentResultsResponse:
description: The list of talent signals that were found for the saved search
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Talent'
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:
SearchIdBadRequest:
properties:
errorCode:
type: string
description: BAD_SEARCH_ID_TYPE
example: BAD_SEARCH_ID_TYPE
message:
type: string
description: The search id needs to be a number.
example: The search id needs to be a number.
NotSupportedProduct:
properties:
errorCode:
type: string
description: NOT_SUPPORTED_PRODUCT
example: NOT_SUPPORTED_PRODUCT
message:
type: string
description: >
Details the product that was requested and the product that is
supported.
example: >
The product "people" is not supported by this operation. Only
"companies" are supported.
Talent:
properties:
talent_signal_id:
title: Talent.talent_signal_id
description: Unique identifier for this talent signal
type: string
example: 2ac47f14-47d5-467d-bfde-4d903ebe9d59
person_id:
description: >-
The Specter person ID for this person, can be used in people
endpoints.
type: string
example: per_5a8db8da85166db285f6f15a
signal_date:
title: Talent.signal_date
description: Date when the talent signal was detected
type: string
example: '2026-06-12'
signal_score:
title: Talent.signal_score
description: Confidence score for this talent signal (1-10 scale)
type: number
example: 7
signal_summary:
description: A short summary of the signal
type: string
example: >-
Ashish founded Mettle Capital for venture investments in Indian tech
startups. Ashish was previously a Managing Director at Sequoia
Capital and Peak XV Partners. Ashish has a strong track record of
investing in companies like Groww, Zomato, and Oyo.
signal_type:
title: Talent.signal_type
description: Type of talent signal detected
type: string
example: New Fund
signal_status:
title: Talent.signal_status
description: Current status of the talent signal
type: string
example: Live
out_of_stealth_advantage:
title: Talent.out_of_stealth_advantage
description: Advantage in months of detecting talent before public announcement
nullable: true
type: number
example: 119
announcement_delay_months:
title: Talent.announcement_delay_months
description: Number of months before the move was publicly announced
nullable: true
type: number
example: 1
talent_last_signal:
title: Talent.talent_last_signal
description: Whether this is the most recent signal for this person
type: boolean
example: true
new_position_title:
title: Talent.new_position_title
description: Job title at the new position
nullable: true
type: string
example: Founder
new_position_company_id:
title: Talent.new_position_company_id
description: Company ID for the new position
nullable: true
type: string
example: 6a30e77e25a5ea5395eb905a
new_position_company_name:
title: Talent.new_position_company_name
description: Company name for the new position
nullable: true
type: string
example: Mettle Capital
new_position_company_website:
title: Talent.new_position_company_website
description: Website of the new position company
nullable: true
type: string
example: mettlecap.com
new_position_company_tagline:
title: Talent.new_position_company_tagline
description: Tagline or description of the new position company
nullable: true
type: string
example: >-
Wind River Capital Strategies offers independent advisory services
for endowments and foundations.
new_position_industry:
$ref: '#/components/schemas/Industry'
new_position_tech_verticals:
$ref: '#/components/schemas/TechVertical'
is_new_position_industry_estimated:
type: boolean
description: Whether the industry is estimated
example: true
past_position_company_id:
title: Talent.past_position_company_id
description: Company ID for the previous position
nullable: true
type: string
example: 67daaaaa0b91647a62395992
tags:
title: Talent.tags
description: Tags describing the new position, when available
nullable: true
type: array
items:
type: string
example: saas
talent_signal_ids:
description: Talent signal IDs for this person, can be used in talent endpoints
nullable: true
items:
type: string
example: 02d32673-f1ab-40a1-93c5-a3a36a10d342
type: array
example:
- 2ac47f14-47d5-467d-bfde-4d903ebe9d59
- 3ad39797-da0e-4870-af89-14e1bdf8e105
investor_signal_ids:
nullable: true
items:
description: >
Investor signal IDs for this person, will be usable in investor
endpoints when available.
type: string
example: 0340bac8-bcee-46a2-94bf-cf77e0c34253
type: array
profile_picture_url:
description: A url for a profile picture if there is one.
nullable: true
type: string
example: >-
https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_5a8db8da85166db285f6f15a.jpg
first_name:
description: First name
type: string
example: Ashish
last_name:
description: Last Name
type: string
example: Agrawal
full_name:
description: Full name
type: string
example: Ashish Agrawal
linkedin_url:
description: URL for LinkedIn account.
type: string
example: https://www.linkedin.com/in/ashish-agrawal-ba3a706
twitter_url:
description: URL for Twitter account.
nullable: true
type: string
example: https://x.com/dvbydt
github_url:
description: URL for Github account.
nullable: true
type: string
example: https://github.com/sarahchen9776
about:
description: A description of the person.
nullable: true
type: string
example: >-
Focussed on venture investments in tech startups in India. Select
investments -Lead - Groww (NSE: GROWW), Leap, Progcap, GoKwik,
Pristyn Care, Stanza Living, Toddle, PayGlocal, Metropolitan Stock
Exchange, Zanskar Research, Lightmetrics, Plum, Ambak, Osfin, Agrani
Labs, C2i Semiconductors, Orbitshift, Eduvanz, Pagarbook,
Clarisights, Onfinance, Wobot, DezyCo-lead/support - Zomato (NSE:
ETERNAL), Oyo (partially exited in a private transaction), Porter
(fully exited in a private transaction), Go-Jek (IDX: GOTO), Ola
Cabs (fully exited in a private transaction), Rebel Foods (partially
exited in a private transaction), Blinkit (Acquired by ETERNAL),
Blackbuck (NSE: BLACKBUCK)
tagline:
description: A shorter tagline for the person.
nullable: true
type: string
example: Founder, Mettle Capital
location:
description: Where the person is located.
nullable: true
type: string
example: Bengaluru, Karnataka, India, Asia
region:
description: Main region where the person is located.
nullable: true
type: string
example: Asia
highlights:
items:
type: string
example: prior_exit
type: array
description: |
Type of highlight, the full list will be added shortly.
example:
- fortune_500_experience
- hyper_connector
- influencer
- prior_vc_backed_experience
- serial_founder
- top_university
level_of_seniority:
description: Top level of seniority the person has achieved.
nullable: true
type: string
example: Executive Level
years_of_experience:
description: Years of experience the person has worked for.
nullable: true
type: number
example: 21
education_level:
description: Top level of education that the person has.
nullable: true
type: string
example: Bachelor's Degree
experience:
type: array
description: Companies that the person has worked for.
items:
$ref: '#/components/schemas/Experience'
past_position_title:
description: Title of the person's last position
nullable: true
type: string
example: Managing Director
past_position_company_name:
description: Name of the company where the person last left.
nullable: true
type: string
example: Peak XV Partners
past_position_company_website:
description: Website for the company where the person last left.
nullable: true
type: string
example: peakxv.com
current_tenure:
description: Length of time the person has been in their current job.
nullable: true
type: number
example: 2
average_tenure:
description: Average length of time in a position.
nullable: true
type: number
example: 30
education:
type: array
description: Educational background for the person
items:
$ref: '#/components/schemas/Education'
languages:
description: Languages that the person speaks
nullable: true
type: array
items:
$ref: '#/components/schemas/Language'
example:
- name: English
proficiency_level: Native Or Bilingual Proficiency
- name: Mandarin Chinese
proficiency_level: Limited Working Proficiency
skills:
nullable: true
items:
type: string
example: Machine Learning
description: List of skills that the person has.
type: array
example:
- Business Analysis
- Business Strategy
- Cloud Computing
- Computer Vision
- E-commerce
- Entrepreneurship
- Financial Modeling
- Management
- Management Consulting
- Mobile
linkedin_followers:
description: Number of followers the person has on LinkedIn.
type: number
example: 47896
linkedin_connections:
description: Number of connections the person has on LinkedIn.
type: number
example: 29540
required:
- person_id
- signal_score
- signal_status
- signal_type
- talent_last_signal
- talent_signal_id
additionalProperties: false
title: Talent Signal
type: object
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
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
Experience:
properties:
company_name:
title: Experience.company_name
description: The name of the company or organization
type: string
example: valantic (vormals mm1)
company_id:
title: Experience.company_id
description: Unique identifier for the company in the system
nullable: true
type: string
example: 6744b47c776432406530a72b
domain:
title: Experience.domain
description: The company's website domain
nullable: true
type: string
example: mm1.com
linkedin_url:
title: Experience.linkedin_url
description: LinkedIn URL for the company
nullable: true
type: string
example: https://www.linkedin.com/company/mm1
description:
title: Experience.description
description: Details about the role, responsibilities, and achievements
nullable: true
type: string
example: >-
As an Implementation Engineer at valantic, I play a pivotal role in
the technical execution of Stripe integration projects, ensuring
precision, efficiency, and robust infrastructure in every
implementation. Leveraging deep technical expertise and payments
industry experience, I design and deploy custom payment solutions
that enhance operational efficiency and customer satisfaction.
company_size:
title: Experience.company_size
description: The size category of the company
nullable: true
type: string
example: 51-200
industry:
$ref: '#/components/schemas/Industry'
tech_verticals:
$ref: '#/components/schemas/TechVertical'
title:
title: Experience.title
description: Job title or position held
type: string
example: Senior Consultant Fintech & Digital Payment
departments:
anyOf:
- items:
title: Experience.departments.[]
type: string
example: Engineering
title: Experience.departments.[]
type: array
example:
- Senior Leadership
- Engineering
- title: Experience.departments
nullable: true
title: Experience.departments
description: Departments or teams the person worked in
example:
- Finance
start_date:
title: Experience.start_date
description: Start date of the position
nullable: true
type: string
example: '2025-04-01'
end_date:
title: Experience.end_date
description: End date of the position (null if current)
nullable: true
type: string
example: '2025-03-01'
location:
title: Experience.location
description: Location where the work was performed
nullable: true
type: string
example: Stuttgart, Baden-Wurttemberg, Germany, Europe
is_current:
title: Experience.is_current
description: Whether this is the person's current position
type: boolean
example: true
founded_year:
title: Experience.founded_year
description: The year the company was founded
nullable: true
type: number
example: 1997
job_order:
title: Experience.job_order
description: >-
Sequential order of this job in the person's career (higher numbers
for more recent positions)
type: number
example: 13
required:
- company_name
- linkedin_url
- title
- departments
- start_date
- is_current
- job_order
additionalProperties: false
title: Experience
type: object
Education:
properties:
name:
title: Education.name
description: The name of the educational institution
nullable: true
type: string
example: Stanford University
linkedin_url:
title: Education.linkedin_url
description: LinkedIn URL for the educational institution
nullable: true
type: string
example: https://www.linkedin.com/school/stanford-university
field_of_study:
title: Education.field_of_study
description: The academic field or major area of study
nullable: true
type: string
example: Computer Science (AI track) and Statistics
degree_title:
title: Education.degree_title
description: The type of degree or qualification obtained
nullable: true
type: string
example: Bachelor of Science - BS
description:
title: Education.description
description: >-
Additional details about the educational experience, research focus,
or achievements
nullable: true
type: string
example: |-
Krieger School of Arts and Sciences
Bloomberg School of Public Health
(joint degree program)
start_date:
title: Education.start_date
description: The start date of the educational program
nullable: true
type: string
example: '2024-01-01'
end_date:
title: Education.end_date
description: The end date or graduation date of the educational program
nullable: true
type: string
example: '2028-01-01'
location:
title: Education.location
description: The location of the educational institution
nullable: true
type: string
example: Stanford, California, United States, North America
required:
- name
- linkedin_url
- field_of_study
- degree_title
- description
- start_date
- end_date
- location
additionalProperties: false
title: Education
type: object
Language:
properties:
name:
title: Language.name
description: The name of the language
nullable: true
type: string
example: Romanian
proficiency_level:
title: Language.proficiency_level
description: The level of proficiency in the language
nullable: true
type: string
example: Native Or Bilingual Proficiency
required:
- name
- proficiency_level
additionalProperties: false
title: Language
type: object
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````