Skip to main content
GET
Get company news

Authorizations

X-API-Key
string
header
required

Path Parameters

companyId
string
required

The Specter company ID.

Query Parameters

page
number

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

limit
number

The number of results to return, default is 50.

major_only
boolean
default:false

When true, only return signals with importance score >= 4 ("major news only"). Mirrors the front-end toggle.

news_publication_date_after
string<date>

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

Example:

"2026-06-01"

news_publication_date_before
string<date>

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

Example:

"2026-06-30"

Response

List of news signals matching the query.

signal_id
integer
required

Unique identifier for this news signal.

Example:

538589

article_id
integer
required

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

Example:

914756

article_url
string
required

The URL linking to the original source article.

Example:

"https://www.linkedin.com/posts/petterblid_so-proud-to-share-our-q2-report-today-and-activity-7481238353364054018-obd_"

published_date
string<date>
required

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

Example:

"2026-07-10"

fetched_at
string<date-time>
required

Timestamp Specter fetched the article.

Example:

"2026-07-10T09:19:40.270718Z"

title
string
required

Article title in English (translated when needed).

Example:

"So proud to share our Q2 report today and the results the team at Litium has delivered."

title_original
string
required

Article title in the original publication language.

Example:

"So proud to share our Q2 report today and the results the team at Litium has delivered."

URL to the article's featured image.

Example:

"https://www.breakit.se/img/default.png"

categories
string[]
required

Categories the publication tagged this article with.

Example:
entity_id
string
required

Specter company id that the signal is attributed to.

Example:

"5e3bbea200c8f4c9669f6601"

company_name
string
required

Name of the company the signal is attributed to.

Example:

"Litium"

company_domain
string
required

Primary domain of the company.

Example:

"litium.com"

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:
whats_new
string
required

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

Example:

"Litium ARR SEK 100M (prev ~SEK 90M in 2025); returned to profitability, Cash EBITDA positive in June."

score
integer
required

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

Example:

4

traction
string
required

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

Example:

"SEK 100M ARR, Net revenue increased 32%, ARR grew 19%, Returned to profitability, Cash EBITDA positive in June"