List Revenue Signals - Specter API

[ { "signal_id": "rev_e3b0c44298fc1c149afbf4c8996fb924", "source_type": "news", "tags": [ "PROJECTION" ], "signal_date": "2025-06-15", "whats_new": "Acme Corp reported $40M ARR in their Q2 update.", "source_url": "https://www.example.com/articles/acme-q2-update", "source_article_id": 1234567, "entity_id": "66d926166261234567890123", "company_name": "Acme Corp", "metric": "ARR", "annualized_usd": 40000000, "year": 2025, "reference_date": "2024-12-31", "context": "We crossed $40M in annualised recurring revenue in June.", "traction": "Customer count doubled YoY.", "is_profitable": true, "profitability_annual_usd": 6000000, "profitability_year": 2025, "profitability_reference_date": "2024-12-31", "profitability_context": "Hit profitability in Q1 2025 with $1.5M net income.", "profitability_source_url": "https://www.example.com/articles/acme-profitability", "profitability_source_article_id": 1234568 } ]

Authorizations

X-API-Key

string

header

required

Query Parameters

list_id

string<uuid>

required

The UUID of the list whose revenue signals should be returned.

new

boolean

default:false

When true, restricts results to signals published in the current week.

limit

number

The number of results to return, default is 50.

page

number

The page number of results to return, base 0, default is 0.

Response

The list of revenue signals belonging to the requested list.

signal_id

string

required

Unique identifier for this revenue signal (prefixed with rev_).

Example:

"rev_e3b0c44298fc1c149afbf4c8996fb924"

source_type

enum<string>

required

The kind of source the signal was derived from.

Available options:

news,

social,

public

Example:

"news"

tags

string[]

required

Tags qualifying the revenue figure (e.g. PROJECTION when the figure is forecast rather than reported, or public for SEC-filing-derived figures).

Example:

["PROJECTION"]

signal_date

string<date>

The date (YYYY-MM-DD) the underlying observation was published (article or filing date).

Example:

"2025-06-15"

whats_new

string

Concise summary of what is new in this signal compared to the previous company context (e.g. "$40M ARR (2024); profitable; ...").

Example:

"Acme Corp reported $40M ARR in their Q2 update."

source_url

string

URL to the source article or filing.

Example:

"https://www.example.com/articles/acme-q2-update"

source_article_id

integer

Internal article id for the source (only set for news / social).

Example:

1234567

entity_id

string

Specter company id that this signal is attributed to. May be null if the company is referenced upstream but not tracked in our company DB.

Example:

"66d926166261234567890123"

company_name

string

Name of the company the signal is attributed to.

Example:

"Acme Corp"

metric

enum<string>

Which revenue metric the value represents.

Available options:

ARR,

Revenue,

GMV

Example:

"ARR"

annualized_usd

number

Annualised revenue in USD at the time of the signal.

Example:

40000000

year

integer

The fiscal year the revenue metric refers to.

Example:

2025

reference_date

string<date>

The date (YYYY-MM-DD) as of which the reported revenue figure is valid (e.g. EOY for a yearly figure, or a specific date for an ARR snapshot). May differ from signal_date.

Example:

"2024-12-31"

context

string

The text excerpt the revenue figure was extracted from.

Example:

"We crossed $40M in annualised recurring revenue in June."

traction

string

A short qualitative traction headline associated with the signal, if any.

Example:

"Customer count doubled YoY."

is_profitable

boolean

Whether the company is reported as profitable at the time of the signal.

Example:

true

profitability_annual_usd

number

Annualised net income in USD at the time of the signal.

Example:

6000000

profitability_year

integer

The fiscal year the profit figure refers to.

Example:

2025

profitability_reference_date

string<date>

The date (YYYY-MM-DD) as of which the reported profitability metric is valid.

Example:

"2024-12-31"

profitability_context

string

The text excerpt the profitability figure was extracted from.

Example:

"Hit profitability in Q1 2025 with $1.5M net income."

profitability_source_url

string

URL to the source backing the profitability claim.

Example:

"https://www.example.com/articles/acme-profitability"

profitability_source_article_id

integer

Internal article id for the profitability source (only set for news / social).

Example:

1234568