Skip to main content
GET
/
revenue-signals
/
{signalId}
Get Revenue Signal by ID
curl --request GET \
  --url https://app.tryspecter.com/api/v1/revenue-signals/{signalId} \
  --header 'X-API-Key: <api-key>'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
signalId
string
required

The ID of the revenue signal being requested (prefixed with rev_).

Response

The requested revenue signal.

A single revenue (or profitability) data point observed for a company as it's reported across social posts, news, podcasts, and public filings.

​
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