News - Multi Source Real Time News Aggregation API

📰 API-News — Real-Time Global News API

🌍 One API. Thousands of News Stories. Endless Possibilities.

API-News is a powerful, production-ready news aggregation API that gives your applications access to fresh, structured, and searchable news from multiple sources through a single, consistent API.

Instead of integrating and maintaining multiple news providers separately, API-News provides a unified interface for discovering, searching, filtering, monitoring, and consuming news.

The API aggregates available providers, normalizes article data, removes duplicate stories, ranks results, and provides flexible filtering and discovery capabilities.

✨ What makes API-News different?

🔹 🌐 Multi-source aggregation — Access news from multiple publishers through one API.

🔹 ⚡ Fresh news — Retrieve the latest available coverage from upstream providers.

🔹 🧹 Automatic de-duplication — Reduce duplicate stories across different publishers.

🔹 🎯 Powerful filtering — Filter by country, language, category, provider, source, date, and more.

🔹 🔎 Advanced search — Search news across available providers with flexible filters.

🔹 🔥 Breaking & trending news — Build real-time news feeds and alerts.

🔹 🏢 Company monitoring — Track news related to companies and organizations.

🔹 📈 Financial news — Retrieve news related to stock ticker symbols.

🔹 🌍 Global coverage — Access country, regional, and local news.

🔹 🌎 Multi-language support — Request translated article content.

🔹 🖼️ Optional enrichment — Retrieve additional image and metadata information.

🔹 📊 Structured JSON — Consistent response format designed for applications, dashboards, mobile apps, and AI systems.

---

💡 Perfect For

API-News is designed for developers building:

📰 News & Media

• 🗞️ News websites
• 📱 News mobile applications
• 📰 Personalized news readers
• 🚨 Breaking-news platforms
• 📺 News dashboards

🤖 AI & Automation

• 🤖 AI news assistants
• 🧠 RAG applications
• 🪄 AI agents
• ✍️ Automated content systems
• 📚 Research assistants
• 📰 AI-powered news summarization

💰 Finance & Markets

• 📈 Stock-news dashboards
• 💹 Market intelligence
• 🏦 Financial applications
• 📊 Investment research platforms
• 🔔 Market monitoring systems

📣 Marketing & Business

• 👀 Brand monitoring
• 🕵️ Competitor monitoring
• 📢 PR monitoring
• 📊 Industry intelligence
• 🔎 Trend research
• 📝 Content research

⚙️ Automation

• 📧 Automated newsletters
• 📱 Social media content pipelines
• 🔔 News alerts
• 📰 Daily news digests
• 🔄 Content automation systems

---

🌟 Key Features

🌐 Multi-Source News Aggregation

Get news from multiple providers through one unified API.

The current provider architecture supports sources including Google News, BBC, The Guardian, NYT, Al Jazeera, NPR, Deutsche Welle, France 24, CNBC, Sky News, Wikipedia Current Events, Reddit, and optional API-based providers.

---

⚡ Latest News

Retrieve the latest available news across supported sources.

GET /api/v1/latest

Example:

/api/v1/latest?country=us&pageSize=20

You can also focus the feed on a specific subject using q.

---

🔥 Breaking News

Get very recent breaking stories.

GET /api/v1/breaking

Perfect for:

🚨 Breaking-news alerts 📱 Real-time applications 📺 Live news dashboards 🤖 Automated monitoring

The endpoint is designed around very recent coverage, including a latest-hour window.

---

📈 Trending News

Discover stories currently receiving significant attention.

GET /api/v1/trending

Use it to build:

🔥 Trending sections 📱 Discover feeds 📰 Popular-news pages 🤖 Trend detection systems

---

🗞️ Top Stories

Retrieve top stories for a country edition.

GET /api/v1/top

Example:

/api/v1/top?country=us

---

🔎 Powerful News Search

Search across available news providers.

GET /api/v1/search

Example:

/api/v1/search?q=artificial+intelligence

You can combine search with:

• 🌍 country
• 🗣️ lang
• ⏱️ when
• 📅 from
• 📅 to
• 🎯 sortBy
• 🔌 providers
• 📰 sources
• 🚫 excludeSources
• 🌎 translate
• 🖼️ enrich
• 📄 page
• 📊 pageSize

🎯 Search by relevance

sortBy=relevance

Great for research and discovery.

🕐 Search newest first

sortBy=publishedAt

Ideal for real-time news feeds.

---

🧠 Discover Related Coverage

🔍 Discover

GET /api/v1/discover

Find news coverage around a topic or subject.

🔗 Related Stories

GET /api/v1/related

Example:

/api/v1/related?q=Federal+Reserve+interest+rates

Useful for:

🧠 Research 📰 Related-news widgets 🤖 AI assistants 📊 Intelligence platforms

---

🌍 Global & Geographic News

🗺️ Countries

List supported countries:

GET /api/v1/countries

Retrieve news for a country:

GET /api/v1/countries/{code}

Example:

/api/v1/countries/us

Country codes use ISO-3166 alpha-2 format.

---

🌎 Regional News

GET /api/v1/regions/{region}

Example:

/api/v1/regions/europe

Regional results aggregate coverage across countries and de-duplicate stories.

---

📍 Local News

Get location-focused news:

GET /api/v1/local/{location}

Examples:

/api/v1/local/London
/api/v1/local/California

Perfect for:

📍 Local news apps 🏙️ City dashboards 🗺️ Location-based applications 📰 Regional publications

---

🏷️ Categories & Topics

📚 Categories

List available categories:

GET /api/v1/categories

Categories provide provider-independent classification such as:

• 💻 Technology
• 💼 Business
• ₿ Crypto
• 🌍 World
• 🏦 Finance
• 🏛️ Politics
• ⚽ Sports
• 🎬 Entertainment

The canonical category catalog is provider-agnostic.

📰 Category News

GET /api/v1/categories/{category}

Example:

/api/v1/categories/technology

---

🏢 Company & Organization News

🏢 Company News

GET /api/v1/companies/{name}

Example:

/api/v1/companies/OpenAI

The endpoint searches for coverage mentioning the company using exact-phrase matching.

Perfect for:

📊 Company monitoring 🕵️ Competitive intelligence 💼 Business research 📣 Brand monitoring

---

🏛️ Organization News

GET /api/v1/organizations/{name}

Retrieve news related to organizations and institutions.

---

📈 Financial & Stock News

💹 Stock Ticker News

GET /api/v1/tickers/{symbol}

Example:

/api/v1/tickers/AAPL

Build:

📈 Stock dashboards 💰 Investment research tools 🔔 Market alerts 📊 Financial intelligence platforms

---

📰 News Sources

📚 List Sources

GET /api/v1/sources

Returns the known publisher/source catalog.

📰 Get Source News

GET /api/v1/sources/{domain}

Examples:

/api/v1/sources/bbc

or:

/api/v1/sources/reuters.com

The endpoint supports source IDs and bare publisher domains.

---

🌎 Translation

Translate article content while preserving the original.

translate=fa

Example:

/api/v1/latest?country=us&translate=fa

The translated content is returned under the article's translation field while the original article remains available.

Useful for:

🌍 Multilingual applications 🇩🇪 German news apps 🇫🇷 French news apps 🇮🇷 Persian news applications 🤖 Multilingual AI agents

---

🖼️ Image & Metadata Enrichment

Enable optional publisher metadata enrichment:

enrich=true

Example:

/api/v1/search?q=technology&enrich=true

The API performs best-effort extraction of metadata such as og:image and descriptions.

⚠️ Note: Enrichment requires additional processing and can make requests slower.

---

⏱️ Time-Based News

Retrieve news from relative time windows:

1h
1d
7d

Example:

/api/v1/recent/1h

You can also query explicit date ranges:

from=2026-07-01
to=2026-07-08

The API supports both relative windows and explicit date ranges.

---

📄 Pagination

Most news endpoints support:

page=1
pageSize=20

Maximum:

pageSize=100

Alternative:

limit=20
offset=0

💡 Recommended

For normal feeds:

pageSize=20

For larger data collection:

pageSize=100

Only request as much data as your application actually needs.

---

📦 Clean & Consistent JSON

Every article is normalized into a predictable structure.

Example:

{
  "id": "75f8f2b5331ccdd2ee0f1b53d77f006e8ce7dcd0",
  "title": "Example headline",
  "description": "Example description",
  "url": "https://example.com/article",
  "source": {
    "name": "Example News",
    "domain": "example.com",
    "provider": "example"
  },
  "imageUrl": "https://example.com/image.jpg",
  "publishedAt": "2026-07-26T08:48:18.000Z",
  "lang": "en",
  "country": "us",
  "category": "technology"
}

The article schema provides normalized identifiers, source information, publication time, language, country, category, image information, and optional translation.

---

🧹 Automatic De-Duplication

When multiple providers report the same story, API-News generates stable article IDs to help identify duplicates.

Article identity can be derived from:

1. 🔗 Article URL
2. 🆔 Provider GUID
3. 📰 Article title

This makes API-News particularly useful for aggregation and monitoring applications.

---

📊 Provider & Response Metadata

API responses can expose information about provider execution:

{
  "providers": {
    "requested": 12,
    "succeeded": 12,
    "failed": []
  },
  "partial": false,
  "degraded": false
}

This helps applications determine whether all requested providers successfully returned data.

---

⚡ Performance & Caching

API-News uses short-term caching to improve performance while keeping news fresh.

Responses can include:

• ⚡ Cache hit status
• ⏳ Cache TTL
• 🕐 Request timing
• 🔌 Provider timing
• 🌐 Upstream timing
• 🌎 Translation timing
• 🖼️ Enrichment timing

🚀 Performance Tips

For best performance:

✅ Use targeted searches ✅ Use appropriate pageSize ✅ Restrict the time window when possible ✅ Avoid unnecessary enrich=true ✅ Request only the providers you need ✅ Cache frequently requested data in your application

---

❤️ Recommended API Workflow

A typical news application can use:

                    ┌───────────────┐
                    │ Your App 🤖   │
                    └───────┬───────┘
                            │
                            ▼
                    ┌───────────────┐
                    │  API-News 📰  │
                    └───────┬───────┘
                            │
             ┌──────────────┼──────────────┐
             ▼              ▼              ▼
          Search 🔎      Trending 🔥    Breaking 🚨
             │              │              │
             └──────────────┼──────────────┘
                            ▼
                  Aggregate & Normalize
                            │
                            ▼
                    De-duplicate 🧹
                            │
                            ▼
                     Filter & Rank 🎯
                            │
                            ▼
                      JSON Response 📦

---

🛠️ Complete Endpoint Reference

🧩 Endpoint	📌 Description
GET /api/v1/latest	⚡ Latest news
GET /api/v1/top	🏆 Top stories
GET /api/v1/trending	🔥 Trending news
GET /api/v1/breaking	🚨 Breaking news
GET /api/v1/headlines	🗞️ Headlines
GET /api/v1/search	🔎 Search news
GET /api/v1/discover	🧠 Discover coverage
GET /api/v1/related	🔗 Related stories
GET /api/v1/countries	🌍 List countries
GET /api/v1/countries/{code}	🗺️ Country news
GET /api/v1/countries/{code}/{category}	🏷️ Country category news
GET /api/v1/regions	🌎 List regions
GET /api/v1/regions/{region}	🌐 Regional news
GET /api/v1/categories	📚 List categories
GET /api/v1/categories/{category}	📰 Category news
GET /api/v1/topics	🧩 List topics
GET /api/v1/topics/{topic}	📰 Topic news
GET /api/v1/companies/{name}	🏢 Company news
GET /api/v1/organizations/{name}	🏛️ Organization news
GET /api/v1/tickers/{symbol}	📈 Ticker news
GET /api/v1/sources	📰 List sources
GET /api/v1/sources/{domain}	🔎 Source news
GET /api/v1/local/{location}	📍 Local news
GET /api/v1/recent/{window}	⏱️ Recent news
GET /api/v1/timerange	📅 Date-range news
GET /api/v1/date/{date}	📆 News for a date
GET /api/v1/health	💚 Health check
GET /api/v1/ready	✅ Readiness check
GET /api/v1/version	🔖 API version
GET /api/v1/meta	🧰 API metadata

---

🛡️ Error Handling

Errors follow a consistent structure:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "statusCode": 400,
    "retryable": false,
    "requestId": "request-id"
  }
}

The error schema includes a machine-readable error code, human-readable message, HTTP status, retryability information, and request ID.

🔄 Retryable Errors

When:

retryable = true

your application may retry according to its retry policy.

For non-retryable errors, correct the request before retrying.

---

🩺 Health & Monitoring

💚 Health Check

GET /api/v1/health

Checks whether the API service is running.

✅ Readiness

GET /api/v1/ready

Checks service readiness and upstream availability.

🔖 Version

GET /api/v1/version

Returns API version and provider capabilities.

🧰 Metadata

GET /api/v1/meta

Provides a machine-readable catalog of providers, topics, categories, countries, regions, and sources.

---

🚀 Start Building Today

Whether you're building a:

📰 News Platform 🤖 AI News Agent 📈 Financial Dashboard 🔎 Research Tool 🏢 Company Monitoring System 📱 Mobile News App 🔥 Trending News Feed 🚨 Breaking-News Alert System 📊 Market Intelligence Platform ⚙️ Content Automation System

API-News gives you a single, developer-friendly API for discovering and consuming fresh news from multiple sources.

🌍 One API.

🔎 Search Everything.

⚡ Get Fresh News.

🚀 Build Faster.