Skip to main content
POST
/
api
/
enterprise
/
newsfeed
/
news
Newsfeed
curl --request POST \
  --url https://api.wokelo.ai/api/enterprise/newsfeed/news/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "breaking_news": true,
  "geo": [
    "USA"
  ],
  "sentiment": "positive",
  "published_date_after": "2026-04-01",
  "published_date_before": "2026-04-30"
}
'
{
    "status": "success",
    "data": [
        {
            "id": 10633767,
            "url": "https://markets.businessinsider.com/news/stocks/ttec-recognized-...",
            "title": "TTEC Recognized as a Major Contender in Everest Group's 2026 Healthcare CXM Assessment",
            "ai_summary": "TTEC was recognized as a Major Contender in Everest Group's 2026 Healthcare CXM Intelligent Operations PEAK Matrix® Assessment.",
            "published_date": "2026-04-30 00:00:00",
            "source": "Wokelo",
            "geo": ["USA"],
            "sentiment": "Positive",
            "newsworthiness_impact": "Medium"
        }
    ],
    "count": 43,
    "total": 43,
    "limit": 100,
    "offset": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Newsfeed API fetches the latest news articles based on user-defined filters such as sentiment, geography, date range, and more. Results are returned directly in the API response.

Endpoint Details

  • Method: POST
  • Endpoint: /api/enterprise/newsfeed/news/

Authentication Requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

Request

Header Parameters

Authorization
string
required
JWT token obtained from the Authentication request

Body Parameters

industry
array
List of industry topics for which news articles should be fetched. E.g. ["Enterprise SaaS", "Cybersecurity"]
category
array
List of news categories for which news articles should be fetched. E.g. ["Strategic Development", "Leadership & Governance"]
blacklisted
array
List of publisher domains to exclude from results. E.g. ["example.com", "spam.com"]
limit
integer
Maximum number of news articles to return. Default: 100, Max: 1000
offset
integer
Number of articles to skip before starting to return results.
published_date_after
string
Start date for filtering news (e.g. "2024-01-01")
published_date_before
string
End date for filtering news (e.g. "2024-12-31")
geo
string[]
List of 3-letter ISO country codes to filter by geography (e.g. ["USA", "GBR"])
sentiment
string
Filter by article sentiment. Accepted values: positive, negative, neutral
breaking_news
boolean
Set to true to fetch breaking news only.

Response

A successful response returns news articles directly.

Successful Response Fields

status
string
"success" if the request was processed successfully.
data
array
List of news articles.
count
integer
Number of results returned.
total
integer
Total number of matching articles.
{
    "status": "success",
    "data": [
        {
            "id": 10633767,
            "url": "https://markets.businessinsider.com/news/stocks/ttec-recognized-...",
            "title": "TTEC Recognized as a Major Contender in Everest Group's 2026 Healthcare CXM Assessment",
            "ai_summary": "TTEC was recognized as a Major Contender in Everest Group's 2026 Healthcare CXM Intelligent Operations PEAK Matrix® Assessment.",
            "published_date": "2026-04-30 00:00:00",
            "source": "Wokelo",
            "geo": ["USA"],
            "sentiment": "Positive",
            "newsworthiness_impact": "Medium"
        }
    ],
    "count": 43,
    "total": 43,
    "limit": 100,
    "offset": 0
}

Authorizations

Authorization
string
header
required

JWT token obtained from the /auth/token/ endpoint.

Body

application/json
category
enum<string>[]

List of news categories to filter by. E.g. ["Strategic Development", "Leadership & Governance"]. See News Categories for all available values.

Available options:
Strategic Development,
Capital Markets & Transactions,
Leadership & Governance,
Workforce & Talent,
Financial Results & Performance,
Regulatory & Compliance,
Macro & Market Environment,
Market Dynamic,
Industry Disruption & Innovation,
Risk & Crisis Events,
Product Launches & Enhancements,
Partnerships & Alliances,
Geographic Expansion,
Operational Milestones,
Market Share & Positioning,
Digital Transformation,
Brand & Marketing Initiatives,
Research, Development & Innovation,
Sustainability & ESG,
Pricing & Commercial Strategy,
Equity Fund-Raising,
Debt Financing,
Mergers & Acquisitions,
Divestitures & Asset Sales,
IPOs & Follow-on Offerings,
SPAC Deals & De-SPACs,
Secondary Transactions,
Shareholder Returns (Buybacks & Dividends),
Valuation Events,
Deal Flow & Volume Statistics,
Public-to-Private/Take-Private,
C-Suite Appointments & Departures,
Board Composition & Changes,
Succession Planning,
Organisational Restructuring,
Executive Commentary & Interviews,
Strategic Hiring,
Workforce Reductions,
Compensation & Benefits,
Culture & Workplace Practices,
Talent-Market Dynamics,
Earnings Releases,
Revenue & Growth Metrics,
Profitability & Margins,
Cash Flow & Capital Expenditure,
Guidance & Forecast Revisions,
Credit-Rating Actions,
Sector Performance Dashboards,
Regulatory Approvals & Certifications,
Policy & Legislative Changes,
Legal Proceedings & Litigation,
Compliance & Reporting Updates,
Intellectual Property,
Antitrust & Competition,
Data Privacy & Cybersecurity Regulation,
Tax & Accounting Rules,
Economic Indicators,
Monetary Policy,
Fiscal Policy,
Trade, Tariffs & Sanctions,
Consumer Behaviour & Spending,
Labor-Market Statistics,
Sector Outlook & Forecasts,
Market Indices Performance,
Institutional Flows & Positioning,
Sector Rotation,
Volatility & Risk Appetite,
FX & Commodity Pricing,
Liquidity Conditions,
Investor Sentiment,
Emerging Technologies,
Technology Adoption & Disruption,
Business-Model Evolution,
Competitive Threats,
Market-Structure Changes,
Geopolitical Risk,
Public-Health Crises,
Natural Disasters,
Operational Disruptions,
Cybersecurity Incidents,
Reputational Damage,
Financial Distress & Restructuring,
Supply-Chain Disruptions,
Awards, Rankings & Recognitions,
Conflicts of Interest & Related-Party Transactions,
Others
Example:
["Strategic Development"]
industry
enum<string>[]

List of industry topics for which news articles should be fetched. See Industry Names for all available values.

Available options:
Agriculture & Food,
Agriculture & Food Production,
Advertising & Marketing,
Business & Public Services,
Corporate & Business Services,
Consumer & E-commerce,
Consumer Packaged Goods (CPG),
Consumer Products & Retail,
Education,
Enterprise Software & Cloud,
Energy & Utilities,
Energy, Utilities & Environment,
Financial & Insurance,
Financial Services & Fintech,
Gaming & Entertainment,
Hardware, Technology & Telecom,
Healthcare & Life Sciences,
Home & Personal Services,
Industrials, Manufacturing & Construction,
Industrials & Manufacturing,
Data, AI & ML Infrastructure,
Media, Entertainment & Sports,
Public Sector & GovTech,
Real Estate & Construction,
Semiconductors & Electronics,
Telecommunications,
Travel & Hospitality,
Transportation & Logistics
Example:
["Enterprise SaaS", "Cybersecurity"]
blacklisted
string[]

List of publisher domains to exclude from results.

Example:
["example.com", "spam.com"]
limit
integer

Maximum number of news articles to return. Default: 100, Max: 1000.

Example:

100

offset
integer

Number of articles to skip before starting to return results.

Example:

0

published_date_after
string

Start date for filtering news (e.g. 2024-01-01).

Example:

"2026-04-01"

published_date_before
string

End date for filtering news (e.g. 2024-12-31).

Example:

"2026-04-30"

geo
string[]

List of 3-letter ISO country codes to filter by geography.

Example:
["USA"]
sentiment
enum<string>

Filter by article sentiment.

Available options:
positive,
negative,
neutral
Example:

"positive"

breaking_news
boolean

Set to true to fetch breaking news only.

Example:

true

Response

200 - application/json

News articles returned

status
string
Example:

"success"

data
array

List of news articles.

count
integer

Number of results returned.

total
integer

Total number of matching articles.

limit
integer
offset
integer