Get revenue signals by date

Returns revenue and profitability signals across companies, newest first.

Costs 2 credits per result returned.

What you need

Nothing beyond your API key. Optionally bound the window with revenue_signal_date_after / revenue_signal_date_before, and walk it with page and limit.

Behaviour

• Sorted newest first.
• Page through with page and limit.
• Bound results by signal date with revenue_signal_date_after / revenue_signal_date_before (both inclusive). For the current week’s signals, set revenue_signal_date_after to the Monday.

What you do next

• Open a single signal. Pass a signal_id to Get revenue signals by date.
• Open the company. Follow a signal’s entity_id (when set) to Get company by ID.

GET /revenue-signals

Get revenue signals by date

cURL

curl --request GET \
  --url https://app.tryspecter.com/api/v1/revenue-signals \
  --header 'X-API-Key: <api-key>'

200

[
  {
    "signal_id": "rev_288a8a7b4ea68bbfd674b035bde3659b",
    "signal_date": "2025-12-16",
    "whats_new": "Q2 rev $424K; net loss $10.8M; backlog ~$15M (+$11.2M YoY); shipped 8 WAM-V; partnerships with Mythos AI & Gradient Marine; AUVSI certification.",
    "source_type": "news",
    "source_url": "https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/",
    "source_article_id": 496721,
    "entity_id": "5e3bbfb900c8f4c966a2d566",
    "company_name": "Ocean Power Technologies",
    "metric": "Revenue",
    "annualized_usd": 1696000,
    "year": 2025,
    "reference_date": "2025-06-30",
    "tags": [
      "ANNUALIZED",
      "COMPANY_REPORTED"
    ],
    "context": "Fiscal Q2 2025 revenue was $424K, down from $2.4M in the prior-year quarter; the company posted a net loss of $10.8M for the quarter; backlog was about $15.0M at Oct. 31.",
    "traction": "Net loss $10.8M in fiscal Q2 (vs. $3.9M prior-year), revenue $424,000 (down from $2.4M year-over-year), backlog ~$15.0M (up $11.2M, ~300% YoY), shipped 8 WAM-V autonomous surface vehicles, signed strategic partnerships with Mythos AI and Gradient Marine, AUVSI Trusted Uncrewed Maritime Systems Operator Training Provider certification.",
    "is_profitable": false,
    "profitability_annual_usd": -43200000,
    "profitability_year": 2025,
    "profitability_reference_date": "2025-06-30",
    "profitability_context": "Posted a net loss of $10.8M for fiscal Q2 ended Oct. 31, 2025 (quarterly loss; annualized to -$43.2M).",
    "profitability_source_url": "https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/",
    "profitability_source_article_id": 496721
  }
]

Authorizations

X-API-Key · string · header · required

Query Parameters

revenue_signal_date_after · string<date>

Only return signals with a signal date on or after this date (YYYY-MM-DD, inclusive).

Example:

"2026-06-01"

revenue_signal_date_before · string<date>

Only return signals with a signal date on or before this date (YYYY-MM-DD, inclusive).

Example:

"2026-06-30"

limit · integer · default: 50

The number of results to return per page (minimum 1, maximum 5000, default 50).

Required range: 1 <= x <= 5000

page · number

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

Response

200

application/json

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

signal_date · string<date> · required

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

Example:

"2025-12-16"

whats_new · string · required

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

Example:

"Q2 rev $424K; net loss $10.8M; backlog ~$15M (+$11.2M YoY); shipped 8 WAM-V; partnerships with Mythos AI & Gradient Marine; AUVSI certification."

source_type · enum<string> · required

The kind of source the signal was derived from.

Available options: news, social, public

Example:

"news"

source_url · string · required

URL to the source article or filing.

Example:

"https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/"

source_article_id · integer · required

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

Example:

496721

entity_id · string · required

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:

"5e3bbfb900c8f4c966a2d566"

company_name · string · required

Name of the company the signal is attributed to.

Example:

"Ocean Power Technologies"

metric · enum<string> · required

Which revenue metric the value represents.

Available options: ARR, Revenue, GMV

Example:

"Revenue"

annualized_usd · number · required

Annualised revenue in USD at the time of the signal.

Example:

1696000

year · integer · required

The fiscal year the revenue metric refers to.

Example:

2025

reference_date · string<date> · required

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:

"2025-06-30"

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:

["ANNUALIZED", "COMPANY_REPORTED"]

context · string · required

The text excerpt the revenue figure was extracted from.

Example:

"Fiscal Q2 2025 revenue was $424K, down from $2.4M in the prior-year quarter; the company posted a net loss of $10.8M for the quarter; backlog was about $15.0M at Oct. 31."

traction · string · required

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

Example:

"Net loss $10.8M in fiscal Q2 (vs. $3.9M prior-year), revenue $424,000 (down from $2.4M year-over-year), backlog ~$15.0M (up $11.2M, ~300% YoY), shipped 8 WAM-V autonomous surface vehicles, signed strategic partnerships with Mythos AI and Gradient Marine, AUVSI Trusted Uncrewed Maritime Systems Operator Training Provider certification."

is_profitable · boolean · required

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

Example:

false

profitability_annual_usd · number

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

Example:

-43200000

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:

"2025-06-30"

profitability_context · string

The text excerpt the profitability figure was extracted from.

Example:

"Posted a net loss of $10.8M for fiscal Q2 ended Oct. 31, 2025 (quarterly loss; annualized to -$43.2M)."

profitability_source_url · string

URL to the source backing the profitability claim.

Example:

"https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/"

profitability_source_article_id · integer

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

Example:

496721