Skip to main content

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.

Bookmark this page for all updates to the Specter API. Items here help both engineers and non‑technical stakeholders understand what changed, why it changed, and what (if anything) you need to do.

​
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

​
2026-04-20
v0.1.0
New endpoints:

​
API Call Logs

GET /api/v1/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 controls
  • from / to — date range filter for log entries
Response fields per entry:
  • timestamp — UTC timestamp of the call
  • path — request path (e.g. /v1/companies)
  • url — full URL including query string
  • http_method — HTTP verb used
  • http_status — HTTP status code returned
  • status — logical status (ok or error)
  • query — query parameters sent with the request (nullable)
​
2026-04-09
v0.1.0
New parameters:

​
Talent search results & Investor Interest search results

Both endpoints now accept a new 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:
  • GET /searches/talent/{searchId}/results
  • GET /searches/investor-interest/{searchId}/results
​
2026-03-20
v0.1.0
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
Deprecated fields:

​
Company response

  • HQ region: Move to company.hq.continent
​
2025-11-20
v0.1.0
Features:

​
Enrich/Get Person

  • People can now be retrieved via the linkedin_num_id and the linkedin_urn.
New fields:

​
Person responses

  • linkedin_urn: The URN of the person being returned, can be empty.
​
2025-11-18
v0.1.0
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.
​
2025-11-15
v0.1.0
New endpoints:

​
Person lookup by email

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.

​
Entities text search

Turn unstructured text—press releases, bios, notes—into structured entity references you can track, enrich, and join to your downstream systems.
​
2025-10-28
v0.1.0
New endpoints added that give the ability to query for investor interest signals.
​
2025-09-30
v0.1.0
New endpoint added which gives the ability to search for companies and get back basic information for them given a query term.
​
2025-08-04
v0.1.0
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_id which 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.
​
2025-06-26
v0.1.0
Added a new filter to the 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.
​
2025-06-18
v0.1.0
A new endpoint for getting email addresses for people has been released which allows you to retrieve the professional or personal email address for a person based on their ID.
​
2025-06-12
v0.1.0
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.
​
2025-05-08
v0.1.0
Added similar companies endpoint 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.
​
2025-02-26
v0.1.0
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.