Revenue Signals

​

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.

{
  "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

​

How to use the API

• A Specter company ID → Get company revenue signals. Only have a domain or name? Find company ID first, then call this with the returned company_id.
• No particular company, or a wide sweep → Get revenue signals by date, bounded with revenue_signal_date_after / revenue_signal_date_before.

• A list → pull its companies with Get company list results, then call Get company revenue signals for each company id.
• A saved search → same shape, starting from Get company saved search results.

• Poll with revenue_signal_date_after set to the end of your last read to pick up only what has been published since.

• Company → follow entity_id to Get company by ID.
• Full detail → already included: both endpoints return the complete signal object, with source_url, context, and the profitability fields.

​

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.
• Revenue signals are premium data: both endpoints are charged per signal returned and cost more than other signals. See each endpoint’s “Costs” note for exact figures.
• The date bounds are inclusive, and limit/page paginate. An unknown company returns 404; a known company with no signals returns 200 with an empty array.