Skip to main content
GET
/
news-signals
/
{signalId}
Get News Signal by ID
curl --request GET \
  --url https://app.tryspecter.com/api/v1/news-signals/{signalId} \
  --header 'X-API-Key: <api-key>'
{
  "signal_id": 1234567,
  "article_id": 987654,
  "article_url": "https://techcrunch.com/2025/06/15/acme-series-b/",
  "categories": [
    "funding"
  ],
  "meaningful_updates": [
    "FUNDING_UPDATE"
  ],
  "published_date": "2025-06-15",
  "fetched_at": "2025-06-15T12:00:00Z",
  "title": "Acme raises $40M Series B led by Lead VC",
  "title_original": "Acme raises $40M Series B led by Lead VC",
  "featured_image_url": "https://techcrunch.com/wp-content/uploads/2025/06/acme.png",
  "entity_id": "66d926166261234567890123",
  "company_name": "Acme",
  "company_domain": "acme.com",
  "whats_new": "Acme raised a $40M Series B led by Lead VC.",
  "score": 4,
  "traction": "Customer count doubled YoY."
}

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
integer
required

The ID of the news signal being requested.

Response

The requested news signal.

A single classified company mention within a news article; if an article mentions multiple companies, each mention is recorded as a separate signal.

​
signal_id
integer
required

Unique identifier for this news signal.

Example:

1234567

​
article_id
integer
required

Underlying article id. Articles that mention multiple companies share this id across signals.

Example:

987654

​
article_url
string
required

The URL linking to the original source article.

Example:

"https://techcrunch.com/2025/06/15/acme-series-b/"

​
categories
string[]
required

Categories the publication tagged this article with.

Example:
["funding"]
​
meaningful_updates
enum<string>[]
required

Categories of newsworthy update detected on the article — revenue figures, profitability, traction milestones, funding rounds, acquisitions / deals.

Available options:
REVENUE_UPDATE,
PROFIT_UPDATE,
TRACTION_UPDATE,
FUNDING_UPDATE,
DEAL_UPDATE
Example:
["FUNDING_UPDATE"]
​
published_date
string<date>

Date (YYYY-MM-DD) the article was published.

Example:

"2025-06-15"

​
fetched_at
string<date-time>

Timestamp Specter fetched the article.

Example:

"2025-06-15T12:00:00Z"

​
title
string

Article title in English (translated when needed).

Example:

"Acme raises $40M Series B led by Lead VC"

​
title_original
string

Article title in the original publication language.

Example:

"Acme raises $40M Series B led by Lead VC"

​
featured_image_url
string

URL to the article's featured image.

Example:

"https://techcrunch.com/wp-content/uploads/2025/06/acme.png"

​
entity_id
string

Specter company id that the signal is attributed to.

Example:

"66d926166261234567890123"

​
company_name
string

Name of the company the signal is attributed to.

Example:

"Acme"

​
company_domain
string

Primary domain of the company.

Example:

"acme.com"

​
whats_new
string

A short AI-generated summary of what the article reports for this company.

Example:

"Acme raised a $40M Series B led by Lead VC."

​
score
integer

Importance score (0–5). 4+ is considered "major news".

Example:

4

​
traction
string

Free-text traction headline associated with the company, if any.

Example:

"Customer count doubled YoY."