Skip to main content
Revenue and profitability signals from news, filings, and public disclosures. Revenue Signals capture structured financial data points for companies — revenue, ARR, and profitability — each with a source, time period, and company attribution. Each signal is a single observation tied to a company and a point in time.

​
Data categories

  • Revenue metrics — metric (ARR, Revenue, or GMV), annualized_usd, year.
  • Profitability — is_profitable, profitability_annual_usd, profitability_year (when available).
  • Timing — reference_date (the period the figure refers to) and signal_date (when it was observed).
  • Source — source_type (news, social, or public), source_url.
  • Context — tags (e.g. PROJECTION, public), whats_new, context.
  • Company link — entity_id (company ID) and company_name.
Example (trimmed)
{
  "signal_id": "rev_e3b0c44298fc1c149afbf4c8996fb924",
  "signal_date": "2025-06-15",
  "entity_id": "66d926166261234567890123",
  "company_name": "Acme Corp",
  "metric": "ARR",
  "annualized_usd": 40000000,
  "year": 2025,
  "is_profitable": true,
  "tags": ["PROJECTION"],
  "source_url": "https://www.example.com/articles/acme-q2-update"
}

​
Endpoints

MethodEndpointReturns
GETGet Revenue Signal by IDA single revenue signal
GETGet Revenue Signals for a companyA single company’s full revenue-signal history (by Specter company ID), newest first
GETList Revenue SignalsRevenue signals pinned to your lists
GETGet Revenue Signals for a company listSignals for the companies in a list
GETGet Revenue Signals for a saved company searchSignals for a saved company search

​
How to use the API

Start with what you have Track updates
  • Set new=true to restrict results to the current week, and poll periodically to monitor changes.
Expand from a signal

​
Notes

  • Signal IDs are prefixed rev_.
  • entity_id may be null when the company is referenced upstream but isn’t in Specter’s company DB.
  • tags qualify the figure — PROJECTION means a forecast, public means a public-filing figure.
  • Financial fields are null when not disclosed.
  • The company, list, and search endpoints cost 10 credits per signal returned — the priciest signal type. The by-ID lookup costs 1 credit per request.
  • new=true limits to the current week; limit/page paginate. Lists or searches over 5,000 companies are capped at that limit; unknown or non-visible ones return 404.