What we track here
- New or updated endpoints, parameters, or response fields
- Deprecations and removals
- Rate‑limit or credit‑limit policy updates
Questions or concerns?
If an update isn’t clear or you need help planning a migration, email us at support@tryspecter.com.Changes
New endpoints:
Revenue Signals
- Get Revenue Signal by ID — 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. - List Revenue Signals — list revenue (and profitability) signals, newest first. Each item is the same signal object returned by Get Revenue Signal by ID.
- Get Revenue Signals for a company list — returns every revenue signal
attributed to the companies in a given list, newest first. Companies outside
the list are excluded. Lists with more than 5,000 member companies are capped
at that limit; unknown or non-visible lists return
404. - Get Revenue Signals for a saved company search — returns every
revenue signal attributed to the companies returned by a saved company
search, newest first. Date-range queries live inside the saved search
itself. Searches matching more than 5,000 companies are capped at that
limit; unknown or non-visible searches return
404.
new=truerestricts the results to signals published in the current week.- Supports
limit/pagepagination.
Credit-limit responses now return 402
Running out of credits now returns HTTP 402 instead of HTTP 429,
so you can distinguish being credit‑limited from being
rate‑limited:402with errorCodeOUT_OF_CREDITS— your team has no credits left for the current billing period. The response carries theX-CreditLimit-*headers, includingX-CreditLimit-Resetwith the seconds until credits renew.429with errorCodeRATE_LIMITED— unchanged; you sent too many requests per second.
429 as “out of
credits”, update it to handle 402 for that case. Retry-on-429 logic can
stay as is.Bulk Endpoints
New endpoints — bulk variants of the existing lookup and enrichment endpoints. Each accepts up to 50 identifiers in a single request, so you can resolve many records in one call instead of issuing them one at a time. For lookup endpoints, unknown identifiers are silently omitted; for enrichment endpoints each row carries afound/queued status (see the entry). Each
uses 1 credit per record returned (misses/queued rows are not charged).Enrichment
- Bulk enrich companies by ID — bulk counterpart to Enrich companies; resolve
companies by website, domain, LinkedIn URL/ID, or Crunchbase URL. Each row
carries a
statusoffound(with thecompanypayload) orqueued(an enrichment was started for an unknown company); onlyfoundrows are charged. - Bulk enrich people by ID — bulk counterpart to Enrich people; resolve people
by LinkedIn URL/ID/URN. Each row carries a
statusoffound(with thepersonpayload) orqueued(async enrichment started); onlyfoundrows are charged. - Bulk reverse email lookup — bulk counterpart to Reverse email lookup; reverse-lookup people from email addresses.
Companies
- Bulk get similar companies by ID — bulk counterpart to Get similar companies; find lookalike companies for multiple seed company IDs at once.
Investors
- Bulk get investors by ID — look up investors by website or name.
Talent and Interest Signals
- Bulk get Talent Signals by ID — bulk counterpart to Get Talent Signal; fetch talent signals by ID. Duplicate IDs are honored.
- Bulk get Investor Interest Signals by ID — bulk counterpart to Get Investor Interest Signal by ID; fetch investor interest signals by ID. Duplicate IDs are honored.
Name based search for companies, people and investors
Name-based search across companies, people and investors. Each search endpoint takes a requiredquery string (minimum 3 characters), returns up
to 10 lightweight results sorted by descending match_confidence, and
uses 1 credit per request regardless of how many matches come back. Chain
the corresponding GET /{id} endpoint on any result for the full profile.People search
Search person name — fuzzy search for people by name. Returns up to 10 candidates, each withid, full_name, headline, linkedin_url,
profile_picture_url, current_company_name, and a match_confidence. Only
matches scoring at least 0.5 are returned; no match returns an empty list.
This is a catalogue search and never triggers enrichment — to enrich a brand
new LinkedIn identifier, keep using Enrich people.Investor search
Search investor name — fuzzy search for investors by name. Returns up to 10 candidates, each withid, name, domain, hq_location,
founded_year, type, and a match_confidence. Only matches scoring at
least 0.5 are returned. Look up investors (lookup by website / exact name) is
unchanged.Company search
Search company name now returns amatch_confidence on every result and
applies the same 0.5 threshold, so weak matches no longer appear.A note on match_confidence
All three endpoints expose match_confidence on a 0–1 scale, but they are
derived differently. Investor search uses trigram similarity, which is
absolute — scores are comparable across separate calls. People and
company search scores are relative to the results within a single
response and should not be compared between calls.New endpoints:
Network Mapping
Three new endpoints expose your team’s LinkedIn network — the people your teammates are connected to, deduped across the team, and the companies they work at. Use them to find a warm path into a target company or to surface who on your team already knows a given contact.- Get people in your team’s network — returns all people your team is connected to on
LinkedIn, deduped across teammates. Each result includes which teammates
hold the connection. Supports
limit/pagepagination and aconnected_onfilter (onlylinkedinis supported today). - Get companies in your team’s network — 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.
Supports
limit/pagepagination and amin_connectionsfilter to only return companies with at least that many network contacts. - Get your team’s network at a company — returns your team’s connections at
a specific company: who you know there, what roles they hold, and which
teammates are linked to them. Returns
404when your team has no connections at the requested company.
Organization
List your team’s members — returns all active members of your team: their user ID, role (admin or member), name, and email. Suspended users are
excluded. Supports limit/page pagination.The user_id field matches the connected_teammates values returned by the
Network endpoints, so you can use it to resolve teammate IDs back to a named
person.This endpoint uses 1 credit per request.New endpoints:
News Signals
- Get News Signal by ID — 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 — returns a company’s full news
signal history in reverse chronological order (most recent first). Supports
limit/pagepagination and amajor_onlytoggle that restricts results to signals with importance score ≥ 4.
meaningful_updates detected (revenue,
profitability, traction, funding, deals), an AI-generated summary of what’s
new, and an importance score on a 0–5 scale.New endpoints:
Investor lookup
Look up investors — look up Specter investor records bywebsite and/or
name query parameters. Returns the matching investor records with full
detail (profile, activity, targeting, funds, portfolio companies). Use it
to resolve an inbound mention of an investor — a domain on a deck, a firm
name in a press release — to the canonical Specter ID for downstream
calls.Behavior:- The endpoint returns a list of investors. A lookup can match more than one investor (e.g. multiple firms sharing a domain), so the endpoint returns all matches.
- When no investor matches, the response is
404 Not Found. - Query parameters: provide at least one of
websiteorname. Supplying both narrows the match. Missing both returns422.
New endpoints:
Investors
Get investor by ID — returns the full Specter investor record for a single investor ID, including profile, targeting, funds, and portfolio companies. Useful for enriching a known investor, pulling portfolio company IDs for downstream calls, or inspecting targeting (industries, verticals, stages) before outreach.Investor saved searches
- Get investor saved search details — returns the name, query ID, and total matched-investor count for a saved investor search. Use it to confirm a search is bound to the expected query, or to surface counts in a UI without fetching results.
- Get investor saved search results — returns the investors
matching a saved investor search with full detail (profile, activity,
targeting, funds, portfolio companies). Supports
limit(default 50, max 5000) andpage(0-indexed).
Investor lists
- Get all investor lists — returns all investor lists created with the API, shared with the API, or shared globally, including the count of investors in each list.
- Create a new investor list — create a new investor list.
- Get specific investor list info — retrieve details of a specific investor list, including the investor IDs it contains.
- Modify an investor list — modify an existing investor list.
- Delete an investor list — delete an investor list.
- Get investor list results — returns the investors in a
specific list along with their current profile, activity, and targeting
data. The list must be of product type
investorsand must be shared with the API or created by the API.
Transactions
Three new typed resources cover the company-level transaction history — funding rounds, acquisitions, and IPOs — that used to require bulk delivery.Use these to look up a transaction referenced from another API response, audit an investor’s recent activity, or stitch a company’s funding history into your CRM without round-tripping through bulk exports.Funding rounds
- Get funding round by ID — a single round with its raising company and full investor list (lead flagged).
- Get company funding rounds — paginated funding history for one company.
- Get investor funding rounds — paginated list of rounds an investor has participated in.
Acquisitions
- Get acquisition by ID — a single acquisition with acquirer and acquiree context.
- Get company acquisitions — acquisitions where the given company is the acquirer.
IPOs
- Get IPO by ID — a single IPO with the issuing company, exchange and ticker symbol, listing date, and proceeds in USD.
- Get company IPOs — IPOs by company.
New endpoints:
API Call Logs
List API call logs — returns a paginated list of API calls made by your organization, ordered by most recent first.Use it to audit which endpoints your integration is hitting, debug failed calls by inspecting HTTP status codes and paths, and monitor usage trends across your team.Parameters:limit/page— pagination controlsfrom/to— date range filter for log entries
timestamp— UTC timestamp of the callpath— request path (e.g./v1/companies)url— full URL including query stringhttp_method— HTTP verb usedhttp_status— HTTP status code returnedstatus— logical status (okorerror)query— query parameters sent with the request (nullable)
New parameters:
Talent search results & Investor Interest search results
Both endpoints now accept anew query parameter (boolean, default false).When set to true, results are restricted to signals from the current week,
overriding any SignalDate filter that is stored in the saved search. This is
equivalent to applying a “This week” signal date filter without modifying the
saved search itself — useful for polling integrations that always want the
latest batch of signals.Affected endpoints:New fields:
Company response
- Pitchbook URL - company.socials.pitchbook.url
- Crunchbase URL - company.socials.crunchbase.url
- HQ regions - company.hq.regions
- HQ continent - company.hq.continent
- Glassdoor data - company.glassdoor
- Glassdoor rating metrics - company.traction_metrics.glassdoor_rating
- Glassdoor reviews metrics - company.traction_metrics.glassdoor reviews
Talent response
- Signal Summary - talent.signal_summary
- Experience
-
- Industry - talent.experience[].industry
-
- Tech Verticals - talent.experience[].tech_verticals
- New position industry - talent.new_position_industry
- New position tech verticals - talent.new_position_tech_verticals
- Is new position industry estimated - talent.is_new_position_industry_estimated
Investor Interest response
- Signal Summary - investor_interset.signal_summary
- Person
-
- Industry - investor_interest.person.industry
-
- Tech Verticals - investor_interest.person.tech_verticals
-
- Is industry estimated - investor_interest.person.is_industry_estimated
- Company
-
- Industry - investor_interest.company.industry
-
- Tech Verticals - investor_interest.company.tech_verticals
-
- Is industry estimated - investor_interest.company.is_industry_estimated
-
- Customer Focus - investor_interest.company.customer_focus
Company response
- HQ region: Move to company.hq.continent
New fields:
Person responses
- linkedin_num_id: Can be used to link a person to a URN.
- last_updated: A timestamp of when the person was last updated in the Specter dataset.
New endpoints:
Reverse email lookup
Which can be used when you have an email address and need to resolve it to a Specter person record so you can standardize contacts, enrich them, or link inbound emails to the correct individual in our database.Text search
Turn unstructured text—press releases, bios, notes—into structured entity references you can track, enrich, and join to your downstream systems.New endpoints added that give the ability to query for investor interest
signals.
New endpoint added which gives the ability to
Search company name and get
back basic information for them given a query term.
Two new fields have been added to all endpoints which return companies.0
- founders_info: Gives more information about the founders including the
specter_person_idwhich allows for the person to be looked up either in the App, or via the People API. specter_strategic_signal_ids: which indicate strategic signals related to the company.
Added a new filter to the Get company people
endpoint allowing anyone that is a CEO to be returned. This new filter
can only be used on its own and
founders and department won’t be taken
in to account with this filter.Updated all search and list endpoints to work with a new Share to API toggle.
This allows lists and searches to be shared with the API without sharing them
with the team.A new endpoint for Get person’s email
has been released which allows you to retrieve the professional or personal
email address for a person based on their ID.
Added endpoints for enrichment of people, which will notify us if there
are people we do not have so we can retrieve them.Added endpoints for People and Talent Signals, allowing you to manage and
get both using the API.
Added Get similar companies
which returns a list of ids for companies that are similar to the company id
being requested.This helps you uncover high-potential companies similar to the one
you’re referencing and is a powerful way to identify new opportunities,
uncover competitors, or expand your investment pipeline with minimal effort.
First release of the API including:
- Enrichment API - Querying to get companies based on parameters
- LinkedIn url
- LinkedIn Id
- domain
- etc
- Companies API - Get companies by Specter ID or list and manage lists.
- Searches API - Get all available searches and query for companies by search ID.