Skip to main content

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_tag and up to several secondary_tags drawn from Wokelo’s 86-category news taxonomy
  • Sentiment signalPositive, Neutral, or Negative classification at the article level
  • Newsworthiness impactHigh, Medium, or Low rating 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_text for downstream summarisation, embedding, or LLM processing
Common use cases:
  • Portfolio adverse signal monitoring — Filter for LEGAL AND COMPLIANCE, LAY-OFFS, FINANCIAL DISTRESS & RESTRUCTURING, or CYBERSECURITY INCIDENTS categories 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, and LEGAL PROCEEDINGS & LITIGATION to surface relevant deal context fast
  • Competitive intelligence — Monitor PRODUCT LAUNCHES & ENHANCEMENTS, PARTNERSHIPS & ALLIANCES, and GEOGRAPHIC EXPANSION categories for a set of competitors on a rolling basis
  • Executive monitoring — Track C-SUITE APPOINTMENTS & DEPARTURES, EXECUTIVE COMMENTARY & INTERVIEWS, and SUCCESSION PLANNING for key personnel across your coverage universe
  • LLM-powered research — Use the scraped_text field 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 request
Step 2 — Filter by category and date range
Step 3 — Work with the articles

3. Authentication

All requests must include a Bearer token in the Authorization HTTP header. No other authentication method is supported.
API tokens are issued from your Wokelo account. Navigate to Account Details → API Credentials in the Wokelo dashboard to get your client id and client secret. Contact support@wokelo.ai if you do not yet have API access.
Never expose your token in client-side code, browser requests, or public repositories. A missing or invalid token returns 401 Unauthorized. A valid token without sufficient plan permissions returns 403 Forbidden.

4. Request Reference

Endpoint
All parameters are passed as URL query parameters. Full request example:

5. Response

Response structure

Article object fields

Each object in the data 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 content
  • secondary_tags, countries, company_names — empty array when no values were detected
  • scraped_text — empty string for paywalled articles or pages that blocked scraping
  • author — 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.
Sample response (excerpt):

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

When total exceeds limit, paginate using offset to retrieve all matching articles.

Extracting article text for LLM processing

Use scraped_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 a detail or message field. Error response example:
Retry logic with exponential back-off:

8. Best Practices

Use the company 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:
Filter by 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:
Exclude press release domains with 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:
Use 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:
Guard against empty classification fields 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:
Use 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:
Paginate correctly when 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.

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.