> ## 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.

# News Signals

> The articles Specter monitors, turned into structured, company-attributed events with an AI summary and an importance score.

Structured, company-attributed news from the articles Specter monitors. Each signal is one classified company mention within a single article — so an article naming three companies produces three signals — with an AI summary of what's newsworthy and a 0–5 importance score.

## Data categories

* **Article** — `article_id` (shared across signals from the same article), `article_url`, `title`, `published_date`, `featured_image_url`.
* **Classification** — `meaningful_updates`: `REVENUE_UPDATE`, `PROFIT_UPDATE`, `TRACTION_UPDATE`, `FUNDING_UPDATE`, `DEAL_UPDATE`.
* **Summary & importance** — `whats_new` (AI summary), `score` (0–5; 4+ is major news), `traction`.
* **Company link** — `entity_id`, `company_name`, `company_domain`.

```json Example (trimmed) theme={null}
{
  "signal_id": 1234567,
  "article_url": "https://techcrunch.com/2025/06/15/acme-series-b/",
  "published_date": "2025-06-15",
  "title": "Acme raises $40M Series B led by Lead VC",
  "entity_id": "66d926166261234567890123",
  "company_name": "Acme",
  "meaningful_updates": ["FUNDING_UPDATE"],
  "whats_new": "Acme raised a $40M Series B led by Lead VC.",
  "score": 4
}
```

## Endpoints

| Method | Endpoint                                                                                                               | Returns                                |
| ------ | ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| `GET`  | [Get News Signals for a company](/api-reference/news-signals/get-news-signals-for-a-company)                           | A company's news history, newest first |
| `GET`  | [Get News Signals for a company list](/api-reference/news-signals/get-news-signals-for-a-company-list)                 | Signals for the companies in a list    |
| `GET`  | [Get News Signals for a saved company search](/api-reference/news-signals/get-news-signals-for-a-saved-company-search) | Signals for a saved company search     |
| `GET`  | [Get News Signal by ID](/api-reference/news-signals/get-news-signal-by-id)                                             | A single news signal                   |

## How to use the API

**Start with a group of companies**

* A company → [Get News Signals for a company](/api-reference/news-signals/get-news-signals-for-a-company).
* A list → [Get News Signals for a company list](/api-reference/news-signals/get-news-signals-for-a-company-list).
* A saved search → [Get News Signals for a saved company search](/api-reference/news-signals/get-news-signals-for-a-saved-company-search).

**Filter**

* Set `major_only=true` to restrict to signals scoring ≥ 4.

**Expand from a signal**

* Company → follow `entity_id` to [Get company by ID](/api-reference/companies/get-company-by-id).
* Full detail → [Get News Signal by ID](/api-reference/news-signals/get-news-signal-by-id).

## Notes

* One signal = one company mention in one article. Articles naming multiple companies share an `article_id`.
* `score` runs 0–5; 4+ is treated as major news (`major_only` filters to those).
* `meaningful_updates` classifies the news: revenue, profitability, traction, funding, or deals.
* `signal_id` is a plain integer (not a prefixed string).
* The by-ID lookup costs 1 credit per request.