Revenue Signals

Revenue and profitability data points for companies, extracted from news coverage and public filings — each with its figure, year, source, and company.

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

Method	Endpoint	Returns
GET	Get Revenue Signal by ID	A single revenue signal
GET	Get Revenue Signals for a company	A single company’s full revenue-signal history (by Specter company ID), newest first
GET	List Revenue Signals	Revenue signals pinned to your lists
GET	Get Revenue Signals for a company list	Signals for the companies in a list
GET	Get Revenue Signals for a saved company search	Signals for a saved company search

How to use the API

Start with what you have

• A Specter company ID → Get Revenue Signals for a company. Only have a domain or name? Resolve company ID first, then call this with the returned company_id.
• A list → Get Revenue Signals for a company list.
• A saved search → Get Revenue Signals for a saved company search.
• Your pinned lists → List Revenue Signals.

Track updates

• Set new=true to restrict results to the current week, and poll periodically to monitor changes.

Expand from a signal

• Company → follow entity_id to Get company by ID.
• Full detail → Get Revenue Signal by ID.

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.