Skip to main content
GET
/
lists
/
companies
/
{listId}
/
news-signals
Get News Signals for a Company List
curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/companies/{listId}/news-signals \
  --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

​
listId
string<uuid>
required

The UUID of the list being requested

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.

Response

List of news signals matching the query.

​
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."