News Signals

​

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.

{
  "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

​

How to use the API

• A list → pull its companies with Get company list results, then call Get company news for each company id.
• A saved search → same shape, starting from Get company saved search results.

• Set major_only=true to restrict to signals scoring ≥ 4.
• Bound the window with news_publication_date_after / news_publication_date_before (both inclusive) — the cheapest way to poll a large cohort is a narrow date range per company.

• Company → follow entity_id to Get company by ID.
• Article → every signal already carries the full article context (article_url, title, whats_new, score), so no follow-up lookup is needed.

​

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).
• Get company news is charged per block of results returned rather than per signal, so a full page costs the same as a nearly empty one; pull wide pages instead of many narrow ones. See its “Costs” note for the figure.
• An unknown company returns 404; a known company with no coverage returns 200 with an empty array.