# Specter API

- [Welcome to the Specter API](https://api.tryspecter.com/api-ref/introduction.md)
- [Quickstart](https://api.tryspecter.com/api-ref/quickstart.md): Get access, authenticate, and make your first request to the Specter API.
- [Authentication](https://api.tryspecter.com/api-ref/auth.md): One team-level API key, sent on the X-API-Key header with every request.
- [Plans & Pricing](https://api.tryspecter.com/api-ref/plans.md): Programmatic access to Specter's private-markets data and signals, metered in credits and requiring at least one paid web-app seat.
- [LLMs.txt](https://api.tryspecter.com/api-ref/llms.md): Machine-readable documentation for LLMs and AI agents.
- [Companies](https://api.tryspecter.com/api-ref/products/companies.md): Firmographics, funding, headcount, traction and signals for millions of companies
- [People](https://api.tryspecter.com/api-ref/products/people.md): Professional profiles including career history, education, skills and contact routes, for the people behind the companies.
- [Investors](https://api.tryspecter.com/api-ref/products/investors.md): Investor records for VC, PEs, Funds, Angels, etc.: targeting, activity, funds raised and portfolios and linked to the companies and rounds they touch.
- [Transactions](https://api.tryspecter.com/api-ref/products/transactions.md): Funding rounds, acquisitions and IPOs each with a stable ID and both sides of the deal resolvable
- [Talent Signals](https://api.tryspecter.com/api-ref/products/talent-signals.md): Detected career moves (founders going into stealth, executives changing roles), often months before they're announced.
- [Interest Signals](https://api.tryspecter.com/api-ref/products/interest-signals.md): Detected investor attention: which investors are looking at which companies and founders, and how strongly.
- [Revenue Signals](https://api.tryspecter.com/api-ref/products/revenue-signals.md): Revenue and profitability data points for companies, extracted from news coverage and public filings; each with its figure, year, source, and company.
- [News Signals](https://api.tryspecter.com/api-ref/products/news-signals.md): The articles Specter monitors, turned into structured, company-attributed events with an AI summary and an importance score.
- [Network Mapping](https://api.tryspecter.com/api-ref/products/network.md): Your team's LinkedIn connections as a queryable graph: find a warm path into a target company, or see who already knows a given contact.
- [Enrichment](https://api.tryspecter.com/api-ref/enrichment.md): Resolve a company, person, or investor from a domain, LinkedIn URL, or email and return their full Specter profile.
- [Lists](https://api.tryspecter.com/api-ref/lists.md): Curated sets of companies, people, or investors
- [Saved Searches](https://api.tryspecter.com/api-ref/saved-searches.md): Turn filters you've built in the Specter app into a live, queryable feed
- [AI search](https://api.tryspecter.com/api-ref/ai-search.md)
- [Rate Limits & Credit Limits](https://api.tryspecter.com/api-ref/rate_limits.md): Two meters govern every request: how fast you can call (rate) and how much data you can pull (credits).
- [Pagination](https://api.tryspecter.com/api-ref/pagination.md): Page through large result sets with two query parameters: page and limit.
- [Errors](https://api.tryspecter.com/api-ref/errors.md): Every error is JSON with a machine-readable code and a human-readable fix; here's how to handle each one.
- [Enrich company](https://api.tryspecter.com/api-reference/enrich/enrich-company.md): Look up and enrich companies by a known identifier - website, domain, LinkedIn, Crunchbase, or Pitchbook. Returns the most current data Specter holds for each match.
- [Enrich companies (bulk)](https://api.tryspecter.com/api-reference/enrich/enrich-companies-bulk.md): Enrich up to 50 companies in one request — the bulk counterpart to [Enrich company](/api-reference/enrich/enrich-company). Each lookup object carries one identifier you already hold (website, domain, LinkedIn, or Crunchbase) and comes back as a full company record. No Specter ID is involved: use [Ge…
- [Enrich person](https://api.tryspecter.com/api-reference/enrich/enrich-person.md): Look up and enrich a person by a known LinkedIn identifier - URL, vanity ID, numeric ID, or URN. Returns the most current professional profile - career history, education, skills, languages, and social presence.
- [Enrich people (bulk)](https://api.tryspecter.com/api-reference/enrich/enrich-people-bulk.md): Enrich up to 50 people in one request — the bulk counterpart to [Enrich person](/api-reference/enrich/enrich-person). Each lookup object carries one LinkedIn identifier you already hold (URL, vanity ID, numeric ID, or URN) and comes back as a full person record. No Specter ID is involved: use [Get p…
- [Enrich investor](https://api.tryspecter.com/api-reference/enrich/enrich-investor.md): 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.
- [Enrich investors (bulk)](https://api.tryspecter.com/api-reference/enrich/enrich-investors-bulk.md): Enrich up to 50 investors in one request — the bulk counterpart to [Enrich investor](/api-reference/enrich/enrich-investor). Each lookup object carries a website and/or a name and comes back as a full investor record. No Specter ID is involved: use [Get investor by ID](/api-reference/investors/get-i…
- [Enrich person by email](https://api.tryspecter.com/api-reference/enrich/enrich-person-by-email.md): Resolves an email address to the most probable Specter person and returns that person's full record, the same object [Get person by ID](/api-reference/people/get-person-by-id) returns, plus the `email` it resolved from and a match confidence `score`.
- [Enrich people by email (bulk)](https://api.tryspecter.com/api-reference/enrich/enrich-people-by-email-bulk.md): Resolve up to 50 email addresses to people in one request - the bulk counterpart to [Enrich person by email](/api-reference/enrich/enrich-person-by-email). Pass a JSON array of email addresses (1-50). Each match is a full person record, the same object [Get person by ID](/api-reference/people/get-pe…
- [AI search](https://api.tryspecter.com/api-reference/search/ai-search.md): Search Specter with a plain-English query. Describe what you're looking for, such as "high-growth fintech companies in Germany founded after 2022" or "VC investors focused on climate", and the endpoint turns it into a structured search and returns the matching records.
- [Search entities by name](https://api.tryspecter.com/api-reference/search/search-entities-by-name.md): Fuzzy-match one name across companies, people, and investors in a single call, with matches grouped by entity type. This is the unified replacement for the per-type name searches.
- [Find company ID](https://api.tryspecter.com/api-reference/companies/find-company-id.md): Resolve a batch of alternate identifiers (domain, website, LinkedIn, Crunchbase or Pitchbook URL, or company name) into the Specter company `id`. Re-use that `id` with the id-only company endpoints such as [Get company by ID](/api-reference/companies/get-company-by-id).
- [Get company by ID](https://api.tryspecter.com/api-reference/companies/get-company-by-id.md): Retrieve the full, current company record for a single Specter company ID. Returns `404` if no company matches the ID.
- [Get company employees](https://api.tryspecter.com/api-reference/companies/get-company-employees.md): Returns the people Specter has on file for a company (founders and employees) as a list. Each row carries the person's identity, socials, location, highlights and signal IDs alongside their role at the company; use `person_id` with [Get person by ID](/api-reference/people/get-person-by-id) for the f…
- [Get company acquisitions](https://api.tryspecter.com/api-reference/companies/get-company-acquisitions.md): Returns the acquisitions a company is involved in (both deals where it was the acquirer and deals where it was the acquiree), newest first. Every row carries both sides, so you can tell the direction of each deal. Use either `acquirer_company_id` or `acquiree_company_id` with [Get company by ID](/ap…
- [Get company funding rounds](https://api.tryspecter.com/api-reference/companies/get-company-funding-rounds.md): Returns a company's funding rounds, newest first, each with the round detail and every participating investor (with a lead flag). Use each `investor_id` with [Get investor by ID](/api-reference/investors/get-investor-by-id) to pull a full investor profile.
- [Get company IPOs](https://api.tryspecter.com/api-reference/companies/get-company-ipos.md): Returns a company's IPOs, newest first. Most companies have zero or one; dual-listed or re-listed companies may have more. Fetch a single IPO with [Get IPO by ID](/api-reference/transactions/get-ipo-by-id), or the issuing company with [Get company by ID](/api-reference/companies/get-company-by-id).
- [Get company news](https://api.tryspecter.com/api-reference/companies/get-company-news.md): Returns a company's complete news-signal history.
- [Get company revenue signals](https://api.tryspecter.com/api-reference/companies/get-company-revenue-signals.md): Returns a company's complete revenue and profitability signal history.
- [Get company competitors](https://api.tryspecter.com/api-reference/companies/get-company-competitors.md): Returns the competitive landscape for a company, a ranked list of competitors, the dimensions the market splits on, and a short summary of the competitive landscape.
- [Get company latest revenue](https://api.tryspecter.com/api-reference/companies/get-company-latest-revenue.md): Returns the latest revenue figures and estimated revenue growth for a single company.
- [Get company latest valuation](https://api.tryspecter.com/api-reference/companies/get-company-latest-valuation.md): Returns the latest valuation figures and estimated valuation growth for a single company.
- [Get company investor-interest signals](https://api.tryspecter.com/api-reference/companies/get-company-investor-interest-signals.md): Investor-interest signals attributed to a specific company, newest first: the interest investors have shown in this company. Each item is the same signal object returned by [Get investor-interest signals by date](/api-reference/investor-interest-signals/get-investor-interest-signals-by-date).
- [Find person ID](https://api.tryspecter.com/api-reference/people/find-person-id.md): Resolve a batch of LinkedIn identifiers (profile URL, vanity id, numeric id, or URN) into the Specter `person_id`. Re-use that id with the id-only people endpoints such as [Get person by ID](/api-reference/people/get-person-by-id).
- [Get person by ID](https://api.tryspecter.com/api-reference/people/get-person-by-id.md): Returns the full professional profile for a person - career history, skills, education, and contact links - identified by their Specter person ID.
- [Get person email](https://api.tryspecter.com/api-reference/people/get-person-email.md): Returns a contactable email for a person, found via a waterfall across multiple data providers. Use the optional type parameter to request a professional or personal email. If you omit it, the endpoint returns a professional email where available, otherwise a personal one. Each response states which…
- [Get person talent signals](https://api.tryspecter.com/api-reference/people/get-person-talent-signals.md): Talent signals attributed to a specific person, newest first: their complete signal history. Each item is the same object returned by [Get talent signals by date](/api-reference/talent-signals/get-talent-signals-by-date): the signal detail (type, status, score, and stealth timing) plus the person's…
- [Find investor ID](https://api.tryspecter.com/api-reference/investors/find-investor-id.md): 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).
- [Get investor by ID](https://api.tryspecter.com/api-reference/investors/get-investor-by-id.md): Returns the full Specter investor record for a single investor ID - profile, activity, targeting, funds, and portfolio companies. Resolve any `portfolio_companies` ID with [Get company by ID](/api-reference/companies/get-company-by-id).
- [Get investor funding rounds](https://api.tryspecter.com/api-reference/investors/get-investor-funding-rounds.md): Returns an investor's funding rounds, newest first. Each round carries the round detail, the company that raised, and the full list of participating investors - so you can see this investor's co-investors on every deal. Use `company_id` with [Get company by ID](/api-reference/companies/get-company-b…
- [Get investor-interest signals](https://api.tryspecter.com/api-reference/investors/get-investor-interest-signals.md): Investor-interest signals attributed to a specific investor, newest first: the interest this investor has shown in talent or companies. Each item is the same signal object returned by [Get investor-interest signals by date](/api-reference/investor-interest-signals/get-investor-interest-signals-by-da…
- [Get acquisition by ID](https://api.tryspecter.com/api-reference/transactions/get-acquisition-by-id.md): Returns a single acquisition record by its Specter acquisition ID, covering both sides of the deal: the acquirer and the acquiree, each with their Specter company ID and primary domain.
- [Get funding round by ID](https://api.tryspecter.com/api-reference/transactions/get-funding-round-by-id.md): Returns a single funding round by its Specter funding round ID, including the company that raised the round and the full list of participating investors, each flagged if they led.
- [Get IPO by ID](https://api.tryspecter.com/api-reference/transactions/get-ipo-by-id.md): Returns a single IPO record by its Specter IPO ID, including the issuing company's Specter company ID and primary domain.
- [Get acquisitions by date](https://api.tryspecter.com/api-reference/transactions/get-acquisitions-by-date.md): Returns acquisitions across all companies, newest first. Each item is the same `PublicAcquisition` object returned by [Get acquisition by ID](/api-reference/transactions/get-acquisition-by-id): every row carries both sides of the deal (the acquirer and the acquiree), each with their Specter company…
- [Get funding rounds by date](https://api.tryspecter.com/api-reference/transactions/get-funding-rounds-by-date.md): Returns funding rounds across all companies, newest first, each with the round detail and every participating investor (with a lead flag). Use each `investor_id` with [Get investor by ID](/api-reference/investors/get-investor-by-id) to pull a full investor profile.
- [Get IPOs by date](https://api.tryspecter.com/api-reference/transactions/get-ipos-by-date.md): Returns IPOs across all companies, newest first. Each item is the same `PublicIpo` object returned by [Get IPO by ID](/api-reference/transactions/get-ipo-by-id), including the issuing company's Specter company ID and primary domain so you can chain to [Get company by ID](/api-reference/companies/get…
- [Get revenue signals by date](https://api.tryspecter.com/api-reference/revenue-signals/get-revenue-signals-by-date.md): Returns revenue and profitability signals across companies, newest first.
- [Get talent signals by date](https://api.tryspecter.com/api-reference/talent-signals/get-talent-signals-by-date.md): Returns talent signals across all people, newest first. Each item is the same object returned by [Get person talent signals](/api-reference/people/get-person-talent-signals): the signal detail (type, status, score, and stealth timing) plus the full professional profile of the person it's about.
- [Get investor-interest signals by date](https://api.tryspecter.com/api-reference/investor-interest-signals/get-investor-interest-signals-by-date.md): Returns investor-interest signals, newest first, each capturing the interest investors have in either talent or companies.
- [Get all company lists](https://api.tryspecter.com/api-reference/company-lists/get-all-company-lists.md): Returns the company lists reachable from your API key: lists created via the API, lists with "Share to API" turned on, and global lists curated by Specter.
- [Create company list](https://api.tryspecter.com/api-reference/company-lists/create-company-list.md): Creates a new company list shared with the API and returns its ID.
- [Get company list](https://api.tryspecter.com/api-reference/company-lists/get-company-list.md): Returns information about a company list created or shared with the API, including the companies that are part of the list.
- [Update company list](https://api.tryspecter.com/api-reference/company-lists/update-company-list.md): Adds and/or removes company IDs from an existing company list in a single request.
- [Delete company list](https://api.tryspecter.com/api-reference/company-lists/delete-company-list.md): Permanently deletes a company list and all its associated data.
- [Get company list results](https://api.tryspecter.com/api-reference/company-lists/get-company-list-results.md): Returns the companies in a list along with their current data and signals.
- [Get all investor lists](https://api.tryspecter.com/api-reference/investor-lists/get-all-investor-lists.md): Returns the investor lists reachable from your API key: lists created via the API, lists with "Share to API" turned on, and global lists curated by Specter.
- [Create investor list](https://api.tryspecter.com/api-reference/investor-lists/create-investor-list.md): Creates a new investor list shared with the API and returns its ID.
- [Get investor list](https://api.tryspecter.com/api-reference/investor-lists/get-investor-list.md): Returns information about an investor list created or shared with the API, including the investors it contains.
- [Update investor list](https://api.tryspecter.com/api-reference/investor-lists/update-investor-list.md): Adds and/or removes investor IDs from an existing investor list in a single request.
- [Delete investor list](https://api.tryspecter.com/api-reference/investor-lists/delete-investor-list.md): Permanently deletes an investor list and all its associated data.
- [Get investor list results](https://api.tryspecter.com/api-reference/investor-lists/get-investor-list-results.md): Returns the investors in a list with their current profile, activity, and targeting data.
- [Get all people lists](https://api.tryspecter.com/api-reference/people-lists/get-all-people-lists.md): Returns the people lists reachable from your API key: lists created via the API, lists with "Share to API" turned on, and global lists curated by Specter.
- [Create people list](https://api.tryspecter.com/api-reference/people-lists/create-people-list.md): Creates a new people list shared with the API and returns its ID.
- [Get people list](https://api.tryspecter.com/api-reference/people-lists/get-people-list.md): Returns information about a people list created or shared with the API, including the people it contains.
- [Update people list](https://api.tryspecter.com/api-reference/people-lists/update-people-list.md): Adds and/or removes person IDs from an existing people list in a single request.
- [Delete people list](https://api.tryspecter.com/api-reference/people-lists/delete-people-list.md): Permanently deletes a people list and all its associated data.
- [Get people list results](https://api.tryspecter.com/api-reference/people-lists/get-people-list-results.md): Returns the people in a list with detailed profile information for each person.
- [Get all saved searches](https://api.tryspecter.com/api-reference/saved-searches/get-all-saved-searches.md): Returns your saved searches across all product types.
- [Create saved search](https://api.tryspecter.com/api-reference/saved-searches/create-saved-search.md): Saves an existing query under a name so its results can be read later.
- [Delete search](https://api.tryspecter.com/api-reference/saved-searches/delete-search.md): Permanently deletes a saved search and all its associated data.
- [Get company saved search](https://api.tryspecter.com/api-reference/company-saved-searches/get-company-saved-search.md): Returns count-level details for a saved company search: total companies matched, newly added, and companies with highlights.
- [Get company saved search results](https://api.tryspecter.com/api-reference/company-saved-searches/get-company-saved-search-results.md): Returns the companies matching a saved company search.
- [Get people saved search](https://api.tryspecter.com/api-reference/people-saved-searches/get-people-saved-search.md): Returns count-level details for a saved people search: its name, query ID, and the number of people matched.
- [Get people saved search results](https://api.tryspecter.com/api-reference/people-saved-searches/get-people-saved-search-results.md): Returns the people matching a saved people search.
- [Get investor saved search](https://api.tryspecter.com/api-reference/investor-saved-searches/get-investor-saved-search.md): Returns count-level details for a saved investor search: its name, query ID, and the total number of investors matched.
- [Get investor saved search results](https://api.tryspecter.com/api-reference/investor-saved-searches/get-investor-saved-search-results.md): Returns the investors matching a saved investor search, with full profile, activity, targeting, funds, and portfolio detail.
- [Get talent signal saved search](https://api.tryspecter.com/api-reference/talent-signals-saved-searches/get-talent-signal-saved-search.md): Returns count-level details for a saved talent search: its name, query ID, and the number of talent signals matched.
- [Get talent signal saved search results](https://api.tryspecter.com/api-reference/talent-signals-saved-searches/get-talent-signal-saved-search-results.md): Returns the talent signals matching a saved talent search.
- [Get investor-interest saved search](https://api.tryspecter.com/api-reference/investor-interest-saved-searches/get-investor-interest-saved-search.md): Returns count-level details for a saved investor-interest search: its name, query ID, and the number of interest signals matched.
- [Get investor-interest saved search results](https://api.tryspecter.com/api-reference/investor-interest-saved-searches/get-investor-interest-saved-search-results.md): Returns the interest signals matching a saved investor-interest search.
- [Get funding rounds saved search](https://api.tryspecter.com/api-reference/funding-rounds-saved-searches/get-funding-rounds-saved-search.md): Returns count-level details for a saved funding rounds search: its name, query ID, and the number of funding rounds matched.
- [Get funding rounds saved search results](https://api.tryspecter.com/api-reference/funding-rounds-saved-searches/get-funding-rounds-saved-search-results.md): Returns the funding rounds matching a saved funding rounds search.
- [Get acquisitions saved search](https://api.tryspecter.com/api-reference/acquisitions-saved-searches/get-acquisitions-saved-search.md): Returns count-level details for a saved acquisitions search: its name, query ID, and the number of acquisitions matched.
- [Get acquisitions saved search results](https://api.tryspecter.com/api-reference/acquisitions-saved-searches/get-acquisitions-saved-search-results.md): Returns the acquisitions matching a saved acquisitions search.
- [Get IPOs saved search](https://api.tryspecter.com/api-reference/ipos-saved-searches/get-ipos-saved-search.md): Returns count-level details for a saved IPOs search: its name, query ID, and the number of IPOs matched.
- [Get IPOs saved search results](https://api.tryspecter.com/api-reference/ipos-saved-searches/get-ipos-saved-search-results.md): Returns the IPOs matching a saved IPOs search.
- [Get network people](https://api.tryspecter.com/api-reference/network/get-network-people.md): Returns all people your team is connected to on LinkedIn, deduped across your teammates. Each result includes which teammates hold the connection.
- [Get network companies](https://api.tryspecter.com/api-reference/network/get-network-companies.md): Returns all companies where someone in your team's network currently works ordered by number of connections at each company. Each result includes the person IDs of your contacts there.
- [Get network connections at a company](https://api.tryspecter.com/api-reference/network/get-network-connections-at-a-company.md): Returns your team's connections at a specific company, who you know there, what roles they hold and which teammates are linked to them.
- [Get organization members](https://api.tryspecter.com/api-reference/account/get-organization-members.md): Returns all active members of your team: their user ID, role, name, and email.
- [Get credit balance](https://api.tryspecter.com/api-reference/account/get-credit-balance.md): Returns the calling organization's API credit balance for the current billing window: the provisioned limit, credits used, and credits remaining, plus today's spend against your organization's own daily limit when one is set. This endpoint stays readable when either ceiling is reached, so you can al…
- [Get API call logs](https://api.tryspecter.com/api-reference/account/get-api-call-logs.md): Returns a paginated log of the API calls your organisation has made, newest first.
- [Health check](https://api.tryspecter.com/api-reference/account/health-check.md): Returns HTTP `200` with `{"status":"OK"}` while the API is up, serving traffic, and able to reach both of its backing databases.
- [Changelog](https://api.tryspecter.com/api-ref/changes.md): New endpoints, fields and behaviour changes in the Specter API — newest first.

## OpenAPI Specs

- [bundle_api](/api-ref/bundle_api.yaml)