# Specter API ## Docs - [AI Search](https://api.tryspecter.com/api-ref/ai-search.md) - [Authentication](https://api.tryspecter.com/api-ref/auth.md): One team-level API key, sent on the X-API-Key header with every request. - [Changelog](https://api.tryspecter.com/api-ref/changes.md): New endpoints, fields and behaviour changes in the Specter API — newest first. - [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. - [Welcome to the Specter API](https://api.tryspecter.com/api-ref/introduction.md) - [Lists](https://api.tryspecter.com/api-ref/lists.md): Curated sets of companies, people, or investors - [LLMs.txt](https://api.tryspecter.com/api-ref/llms.md): Machine-readable documentation for LLMs and AI agents. - [Pagination](https://api.tryspecter.com/api-ref/pagination.md): Page through large result sets with two query parameters: page and limit. - [Plans & Pricing](https://api.tryspecter.com/api-ref/plans.md): Specter's two API plans — Enrichment and Full — and how credits are charged per result, with rate and credit limits. - [Companies](https://api.tryspecter.com/api-ref/products/companies.md): Firmographics, funding, headcount, traction and signals for millions of companies - [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. - [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. - [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. - [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. - [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. - [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. - [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. - [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 - [Quickstart](https://api.tryspecter.com/api-ref/quickstart.md): Get access, authenticate, and make your first request to the Specter API. - [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). - [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-reference/ai-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. - [Bulk get similar companies by ID](https://api.tryspecter.com/api-reference/companies/bulk-get-similar-companies-by-id.md): Find companies similar to each of up to 50 companies in one request — the bulk counterpart to [Get similar companies](/api-reference/companies/get-similar-companies). Pass a list of company IDs and get back the similar company IDs for each. - [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](/a… - [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 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 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 people](https://api.tryspecter.com/api-reference/companies/get-company-people.md): Returns the people Specter has on file for a company — founders and employees — as a list. Use each `person_id` with [Get person info by ID](/api-reference/people/get-person-info-by-id) to pull a full profile. - [Get Latest Revenue for a Company](https://api.tryspecter.com/api-reference/companies/get-latest-revenue-for-a-company.md): Returns the latest revenue figures and estimated revenue growth for a single company. - [Get Latest Valuation for a Company](https://api.tryspecter.com/api-reference/companies/get-latest-valuation-for-a-company.md): Returns the latest valuation figures and estimated valuation growth for a single company. - [Get similar companies](https://api.tryspecter.com/api-reference/companies/get-similar-companies.md): Returns companies similar to a referenced company (by Specter company ID) as a list of Specter IDs; fetch any of them with [Get company by ID](/api-reference/companies/get-company-by-id). Returns `404` if the company ID doesn't exist. - [Resolve company ID](https://api.tryspecter.com/api-reference/companies/resolve-company-id.md): Resolve a batch of alternate identifiers — domain, website, LinkedIn 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). - [Search company name](https://api.tryspecter.com/api-reference/companies/search-company-name.md): Search Specter companies with a `query` term — typically a company name. Returns lightweight matches; fetch the full record for any result with [Get company by ID](/api-reference/companies/get-company-by-id). - [Create a new company list](https://api.tryspecter.com/api-reference/company-lists/create-a-new-company-list.md): **What it does** - [Delete a company list](https://api.tryspecter.com/api-reference/company-lists/delete-a-company-list.md): Permanently delete a company list and all its associated data. This action cannot be undone. - [Get all company lists](https://api.tryspecter.com/api-reference/company-lists/get-all-company-lists.md): **What it does** - [Get company list results](https://api.tryspecter.com/api-reference/company-lists/get-company-list-results.md): **What it does** - [Get specific company list info](https://api.tryspecter.com/api-reference/company-lists/get-specific-company-list-info.md): Returns information about a company list which is created or shared with the API, including the companies that are part of the list. - [Modify a company list](https://api.tryspecter.com/api-reference/company-lists/modify-a-company-list.md): **What it does** - [Get company saved search details](https://api.tryspecter.com/api-reference/company-saved-searches/get-company-saved-search-details.md): **What it does** Returns summary details for a saved company search—including the total companies matched, the number of newly added companies, and the count of companies with highlights. - [Get company saved search results](https://api.tryspecter.com/api-reference/company-saved-searches/get-company-saved-search-results.md): **What it does** - [List API call logs](https://api.tryspecter.com/api-reference/customer-data/list-api-call-logs.md): **What it does** - [Bulk enrich companies by ID](https://api.tryspecter.com/api-reference/enrichment/bulk-enrich-companies-by-id.md): Resolve up to 50 companies in one request — the bulk counterpart to [Enrich companies](/api-reference/enrichment/enrich-companies). Pass an array of 1–50 lookup objects, each identifying one company by website, domain, LinkedIn, or Crunchbase. - [Bulk enrich people by ID](https://api.tryspecter.com/api-reference/enrichment/bulk-enrich-people-by-id.md): Resolve up to 50 people in one request — the bulk counterpart to [Enrich people](/api-reference/enrichment/enrich-people). Pass an array of 1–50 lookup objects, each identifying one person by LinkedIn URL, vanity ID, numeric ID, or URN. - [Bulk reverse email lookup](https://api.tryspecter.com/api-reference/enrichment/bulk-reverse-email-lookup.md): Resolve up to 50 email addresses to people in one request — the bulk counterpart to [Reverse email lookup](/api-reference/enrichment/reverse-email-lookup). Pass a JSON array of email addresses (1–50). - [Enrich companies](https://api.tryspecter.com/api-reference/enrichment/enrich-companies.md): Look up and enrich companies by a known identifier — website, domain, LinkedIn, or Crunchbase. Returns the most current data Specter holds for each match. - [Enrich people](https://api.tryspecter.com/api-reference/enrichment/enrich-people.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. - [Reverse email lookup](https://api.tryspecter.com/api-reference/enrichment/reverse-email-lookup.md): Resolves an email address to the most probable Specter person, returning their person ID, core profile fields, and a match confidence score. Use `person_id` with [Get person info by ID](/api-reference/people/get-person-info-by-id), or `company_id` with [Get company by ID](/api-reference/companies/ge… - [Text search](https://api.tryspecter.com/api-reference/enrichment/text-search.md): Resolve a short piece of text to the Specter entities it refers to. Pass a passage to pull out the entities mentioned, or a natural-language query (e.g. "competitors of rippling.com" or "fintech investors") to get the entities that match. Each result includes the entity's Specter ID, type, and how c… - [Get Investor Interest Signals saved search details](https://api.tryspecter.com/api-reference/investor-interest-saved-searches/get-investor-interest-signals-saved-search-details.md): Retrieve details about a saved interest search. This endpoint provides access to the name, query_id and number of interest signals in the search. - [Get Investor Interest Signals saved search results](https://api.tryspecter.com/api-reference/investor-interest-saved-searches/get-investor-interest-signals-saved-search-results.md): Retrieve the results of an interest search operation. This endpoint provides paginated access to matching investor interest signals with core company or talent data based on your search criteria. - [Create a new investor list](https://api.tryspecter.com/api-reference/investor-lists/create-a-new-investor-list.md): **What it does** - [Delete an investor list](https://api.tryspecter.com/api-reference/investor-lists/delete-an-investor-list.md): Permanently delete an investor list and all its associated data. This action cannot be undone. - [Get all investor lists](https://api.tryspecter.com/api-reference/investor-lists/get-all-investor-lists.md): **What it does** - [Get investor list results](https://api.tryspecter.com/api-reference/investor-lists/get-investor-list-results.md): **What it does** - [Get specific investor list info](https://api.tryspecter.com/api-reference/investor-lists/get-specific-investor-list-info.md): Retrieve detailed information about a specific investor list reachable from your API key: created via the API, with "Share to API" turned on, or a global list curated by Specter. Includes the ids of the investors it contains. Lists shared only within your team are not accessible from the API. - [Modify an investor list](https://api.tryspecter.com/api-reference/investor-lists/modify-an-investor-list.md): **What it does** - [Get investor saved search details](https://api.tryspecter.com/api-reference/investor-saved-searches/get-investor-saved-search-details.md): **What it does** - [Get investor saved search results](https://api.tryspecter.com/api-reference/investor-saved-searches/get-investor-saved-search-results.md): **What it does** - [Bulk get investors by ID](https://api.tryspecter.com/api-reference/investors/bulk-get-investors-by-id.md): Resolve up to 50 investors in one request — the bulk counterpart to [Look up investors](/api-reference/investors/look-up-investors). Pass a JSON array of 1–50 lookup objects, each identifying one investor by website or name. - [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… - [Look up investors](https://api.tryspecter.com/api-reference/investors/look-up-investors.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. - [Search investor name](https://api.tryspecter.com/api-reference/investors/search-investor-name.md): Returns investors whose name fuzzily matches the `query` term, each with a `match_confidence` from 0 to 1, sorted by descending confidence. Use the `id` from a result with [Get investor by ID](/api-reference/investors/get-investor-by-id) for the full profile. - [Get companies in your team's network](https://api.tryspecter.com/api-reference/network/get-companies-in-your-teams-network.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 people in your team's network](https://api.tryspecter.com/api-reference/network/get-people-in-your-teams-network.md): Returns all people your team is connected to on LinkedIn, deduped across your teammates. Each result includes which teammates hold the connection. - [Get your team's network at a company](https://api.tryspecter.com/api-reference/network/get-your-teams-network-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 News Signal by ID](https://api.tryspecter.com/api-reference/news-signals/get-news-signal-by-id.md): Retrieve a single news signal by its integer Specter signal id. A "news signal" represents one classified company mention within a single article — when an article mentions multiple companies, each company yields its own signal. - [Get News Signals for a company](https://api.tryspecter.com/api-reference/news-signals/get-news-signals-for-a-company.md): News signals associated with a specific company, providing its complete history of signals sorted in reverse chronological order (most recent first). - [Get News Signals for a company list](https://api.tryspecter.com/api-reference/news-signals/get-news-signals-for-a-company-list.md): News signals attributed to the companies in a given list. Companies outside the list are excluded. - [Get News Signals for a saved company search](https://api.tryspecter.com/api-reference/news-signals/get-news-signals-for-a-saved-company-search.md): News signals attributed to the companies returned by a saved company search. Use `news_publication_date_after` / `news_publication_date_before` to bound results by article publication date. - [List your team's members](https://api.tryspecter.com/api-reference/organization/list-your-teams-members.md): Returns all active members of your team - their user ID, role, name, and email. The `user_id` field matches teammate IDs returned by Network endpoints. - [Create a new people list](https://api.tryspecter.com/api-reference/people-lists/create-a-new-people-list.md): **What it does** - [Delete a people list](https://api.tryspecter.com/api-reference/people-lists/delete-a-people-list.md): Permanently delete a people list and all its associated data. This action cannot be undone. - [Get all people lists](https://api.tryspecter.com/api-reference/people-lists/get-all-people-lists.md): **What it does** - [Get people list results](https://api.tryspecter.com/api-reference/people-lists/get-people-list-results.md): **What it does** - [Get specific people list info](https://api.tryspecter.com/api-reference/people-lists/get-specific-people-list-info.md): Retrieve detailed information about a specific people list reachable from your API key: created via the API, with "Share to API" turned on, or a global list curated by Specter. Includes the ids of the people it contains. Lists shared only within your team are not accessible from the API. - [Modify a people list](https://api.tryspecter.com/api-reference/people-lists/modify-a-people-list.md): **What it does** - [Get people saved search details](https://api.tryspecter.com/api-reference/people-saved-searches/get-people-saved-search-details.md): **What it does** - [Get people saved search results](https://api.tryspecter.com/api-reference/people-saved-searches/get-people-saved-search-results.md) - [Get person info by ID](https://api.tryspecter.com/api-reference/people/get-person-info-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's email](https://api.tryspecter.com/api-reference/people/get-persons-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… - [Search person name](https://api.tryspecter.com/api-reference/people/search-person-name.md): Returns people whose name matches the `query`, each with a Specter person ID and a match confidence. Fetch a full profile with [Get person info by ID](/api-reference/people/get-person-info-by-id). - [Get Revenue Signal by ID](https://api.tryspecter.com/api-reference/revenue-signals/get-revenue-signal-by-id.md): Retrieve a single revenue (or profitability) signal by its Specter signal id (`rev_...`). Each signal corresponds to one observation derived from news coverage or a public filing — the revenue (or profitability) figures, the year they refer to, the source url, and the company they are attributed to. - [Get Revenue Signals for a company](https://api.tryspecter.com/api-reference/revenue-signals/get-revenue-signals-for-a-company.md): Revenue (and profitability) signals attributed to a specific company, providing its complete history of signals sorted in reverse chronological order (most recent first). - [Get Revenue Signals for a company list](https://api.tryspecter.com/api-reference/revenue-signals/get-revenue-signals-for-a-company-list.md): Revenue signals attributed to the companies in a given list. Companies outside the list are excluded. - [Get Revenue Signals for a saved company search](https://api.tryspecter.com/api-reference/revenue-signals/get-revenue-signals-for-a-saved-company-search.md): Revenue signals attributed to the companies returned by a saved company search. Use `revenue_signal_date_after` / `revenue_signal_date_before` to bound results by signal date. - [List Revenue Signals](https://api.tryspecter.com/api-reference/revenue-signals/list-revenue-signals.md): Retrieve revenue (and profitability) signals, newest first. Each item is the same signal object returned by `GET /revenue-signals/{signalId}` — the revenue or profitability figure, the year it refers to, the source url, and the company it is attributed to. - [Delete a search](https://api.tryspecter.com/api-reference/saved-searches/delete-a-search.md): Permanently delete the saved search and all its associated data. This action cannot be undone. - [Get all saved searches](https://api.tryspecter.com/api-reference/saved-searches/get-all-saved-searches.md): Returns the saved searches reachable from your API key, across all product types: searches explicitly shared to the API via "Share to API", and global searches curated by Specter. Searches shared only within your team or organization are not returned. - [Bulk get Investor Interest Signals by ID](https://api.tryspecter.com/api-reference/talent-and-interest-signals/bulk-get-investor-interest-signals-by-id.md): 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}`. - [Bulk get Talent Signals by ID](https://api.tryspecter.com/api-reference/talent-and-interest-signals/bulk-get-talent-signals-by-id.md): Retrieve up to 50 Talent Signals in one request — the bulk counterpart to [Get Talent Signal by ID](/api-reference/talent-and-interest-signals/get-talent-signal-by-id). Pass a JSON array of 1–50 talent signal IDs. - [Get Investor Interest Signal by ID](https://api.tryspecter.com/api-reference/talent-and-interest-signals/get-investor-interest-signal-by-id.md): Retrieve interest that investors have in either Talent or Companies. - [Get Talent Signal by ID](https://api.tryspecter.com/api-reference/talent-and-interest-signals/get-talent-signal-by-id.md): Returns a single Talent Signal by its ID — the signal detail (type, status, score, and stealth timing) plus the full professional profile of the person it's about (career history, education, skills, and links). - [Get Talent Signals saved search details](https://api.tryspecter.com/api-reference/talent-signals-saved-searches/get-talent-signals-saved-search-details.md): Retrieve details about a saved talent search. This endpoint provides access to the name, query_id and number of talent signals in the search. - [Get Talent Signals saved search results](https://api.tryspecter.com/api-reference/talent-signals-saved-searches/get-talent-signals-saved-search-results.md): Retrieve the results of a talent search operation. This endpoint provides paginated access to matching talent profiles based on your search criteria, including their signal scores and position changes. To use a saved search it must be shared to the API via "Share to API", created by the API,… - [Get acquisition by ID](https://api.tryspecter.com/api-reference/transactions/get-acquisition-by-id.md): **What it does** - [Get funding round by ID](https://api.tryspecter.com/api-reference/transactions/get-funding-round-by-id.md): **What it does** - [Get IPO by ID](https://api.tryspecter.com/api-reference/transactions/get-ipo-by-id.md): **What it does** ## OpenAPI Specs - [bundle_api](https://api.tryspecter.com/api-ref/bundle_api.yaml) - [openapi](https://api.tryspecter.com/api-reference/openapi.json)