1. Overview
The Company News Monitoring API fetches the latest news articles for a given company, enriched with AI-generated summaries, structured event categories, sentiment classifications, publisher metadata, and scraped article text. Results are returned synchronously in the HTTP response — no job polling required. This is a synchronous GET API — you pass a company identifier and optional filters as URL parameters, and receive a paginated array of enriched news articles immediately. Each article in the response includes:- AI summary — a concise, machine-generated synopsis of the article’s key facts and implications
- Event categorisation — a
primary_tagand up to severalsecondary_tagsdrawn from Wokelo’s 86-category news taxonomy - Sentiment signal —
Positive,Neutral, orNegativeclassification at the article level - Newsworthiness impact —
High,Medium, orLowrating assessing the article’s strategic significance - Publisher and author metadata — source domain, author name, publication date, and original language
- Company mentions — a structured array of all companies named in the article, with their resolved websites
- Full article text — the complete
scraped_textfor downstream summarisation, embedding, or LLM processing
- Portfolio adverse signal monitoring — Filter for
LEGAL AND COMPLIANCE,LAY-OFFS,FINANCIAL DISTRESS & RESTRUCTURING, orCYBERSECURITY INCIDENTScategories to catch early warning signals across a watchlist - Deal due diligence — Pull all news for a target company in the past 12 months, filter by
MERGERS & ACQUISITIONS,REGULATORY APPROVALS & CERTIFICATIONS, andLEGAL PROCEEDINGS & LITIGATIONto surface relevant deal context fast - Competitive intelligence — Monitor
PRODUCT LAUNCHES & ENHANCEMENTS,PARTNERSHIPS & ALLIANCES, andGEOGRAPHIC EXPANSIONcategories for a set of competitors on a rolling basis - Executive monitoring — Track
C-SUITE APPOINTMENTS & DEPARTURES,EXECUTIVE COMMENTARY & INTERVIEWS, andSUCCESSION PLANNINGfor key personnel across your coverage universe - LLM-powered research — Use the
scraped_textfield to feed full article content directly into your own summarisation or RAG pipeline, pre-filtered by category and date
This API is synchronous. Results are returned directly in the HTTP response — no job submission or polling required. See How Sync APIs work.
2. Quick Start
Step 1 — Make a simple request3. Authentication
All requests must include a Bearer token in theAuthorization HTTP header. No other authentication method is supported.
4. Request Reference
Endpoint
Full request example:
5. Response
Response structure
Article object fields
Each object in thedata array contains the following fields:
Article content
Publisher metadata
Categorisation
Signals
Geography & company mentions
The
company_names array includes all entities mentioned in the article — not just the queried company. This makes it useful for surfacing deal counterparties, lead investors, named competitors, and co-signatories in regulatory filings without having to parse the article text.Sentiment values
Newsworthiness impact values
Notes on empty fields
Several fields can be empty strings or empty arrays in valid responses:sentiment,newsworthiness_impact,primary_tag,original_language— empty string when classification has not yet been applied to this article, particularly for older contentsecondary_tags,countries,company_names— empty array when no values were detectedscraped_text— empty string for paywalled articles or pages that blocked scrapingauthor— empty string when the byline was not present or parseable
6. Examples
Portfolio adverse signal monitoring
Get all legal, compliance, layoff, and financial distress news for a portfolio company to catch early warning signals.Deal due diligence — target company news sweep
Pull all news for an acquisition target over a defined period, prioritise by category, and exclude press release sources to focus on independent coverage.Competitive monitoring — product launches and partnerships
Track product and partnership news for a set of competitors over a rolling 90-day window.Paginating through large result sets
Whentotal exceeds limit, paginate using offset to retrieve all matching articles.
Extracting article text for LLM processing
Usescraped_text to feed full article content into a summarisation or classification pipeline.
JavaScript / Node.js
7. Error Handling
The API uses standard HTTP status codes. All error responses include a JSON body with adetail or message field.
Error response example:
8. Best Practices
Use thecompany permalink, not a display name
The company parameter expects a permalink (e.g. "tesla", "brex") or a full URL. Passing a display name like "Tesla Inc." will not resolve correctly. Use the Company Search API to look up the permalink for any company:
category to reduce noise — this is the highest-impact parameter
Returning all news for a major company like Tesla or Apple can yield hundreds of articles, many of which are market data reports, stock price articles, or tangentially related coverage. Use the category filter aggressively to surface only the signal types relevant to your workflow. Combine multiple categories with a comma:
blacklisted
Wire service articles (prnewswire.com, businesswire.com, globenewswire.com) are often company-issued press releases that add volume without independent editorial perspective. Blacklist them for competitive intelligence and monitoring use cases where you want journalist-authored coverage:
newsworthiness_impact to triage before reading
When processing large result sets, filter to "High" impact articles first for executive briefings or urgent monitoring workflows. "Medium" and "Low" articles can be batch-processed later:
primary_tag, sentiment, newsworthiness_impact, and original_language can be empty strings for older articles or articles still pending classification. Always use .get() with a default rather than direct key access:
scraped_text for downstream LLM pipelines — but expect some gaps
scraped_text contains the full article body and is ideal for passing to summarisation, classification, or embedding models. However, paywalled articles (Bloomberg, FT, WSJ) will often have empty or truncated scraped_text. Use ai_summary as a fallback:
total exceeds limit
The default limit is 100 and the maximum is 1000. For queries returning large result sets, check total against count and paginate using offset until all records are retrieved. Stop when count returns 0 or len(all_articles) >= total.
Use company_names to map article networks
The company_names array resolves all entity mentions in the article, not just the queried company. This lets you identify deal counterparties, named investors, or competitors without text parsing — useful for building relationship graphs across a coverage universe.
9. Related APIs
Industry News Monitoring
Monitor the latest news across an entire industry or sector, rather than a single company.
Newsfeed
Retrieve a curated, cross-company newsfeed based on a topic, theme, or portfolio watchlist.
Company Deep Intelligence
Generate a comprehensive AI intelligence report on any company — strategy, financials, and competitive position.
Company Instant Enrichment
Synchronously enrich firmographic and financial data for any company by permalink or URL.
Target Screening
Identify and score potential acquisition targets — AI-ranked with deal feasibility, synergy, and precedent scores.
Supporting APIs
Company Search, Request Status, and other utilities used alongside monitoring workflows.