/top-news

GET /top-news

Endpoint

curl -X GET "https://api.newsdatahub.com/v1/top-news" \
  -H "X-Api-Key: your_api_key_here" \
  -H "User-Agent: docs-top-news/1.0-curl"

Retrieve curated top news from trusted publishers. Articles are limited to a 24-72 hour window and prioritize core topics including politics, technology, business, finance, government, crime, health, sports, economy, international, law, and science.

Learn More

• Complete /top-news Guide — Full tutorial with code examples and best practices
• Advanced Search & Filtering — Boolean search with AND/OR/NOT operators

Access Requirements

This endpoint is available on free and paid plans. Free-tier /top-news requests count against the same daily quota pool as /news. This endpoint automatically filters to recent articles (24-72 hours) from the top-news source profile.

Unique Parameters

The /top-news endpoint includes two special parameters not available on the standard /news endpoint:

Parameter	Type	Description
hours	integer	Time window for top news coverage. Accepts 24, 48, or 72 hours. Defaults to 48. This filters articles to only those published within the specified recent time period.
require_media	boolean	When set to true, only returns articles that include media assets (images or videos). Defaults to false. Useful for creating visually-rich content feeds.

Query Parameters

The /top-news endpoint supports most filtering options from the /news endpoint. Source type is automatically restricted to digital_native, mainstream_news, newspaper, and news_agency.

Parameter	Type	Description
q	string	Full-text search with Boolean operators (AND/OR/NOT)
search_in	string	Specify which fields to search: all (default), title, description, content, or comma-separated values
topic	string	Filter by topics (comma-separated or repeated). Defaults to: politics, technology, business, finance, government, crime, health, sports, economy, international, law, science
language	string	ISO 639-1 language code (e.g., en, es, fr). See available languages
country	string	ISO 3166-1 alpha-2 country codes (comma-separated). See available countries
source	string	Filter by source name (comma-separated or repeated)
exclude_source	string	Exclude specific sources from results (comma-separated or repeated)
political_leaning	string	Filter by source political bias: left, center_left, center, center_right, right, far_left, far_right
per_page	integer	Results per page (max 100). Default depends on tier: free 10, starter 30, paid tiers 50
cursor	string	Pagination cursor from previous response
sort_by	string	Sort order: relevance (default) or date (newest first)
fields	string	Comma-separated list of fields to include
deduplicate	boolean	Remove duplicate articles with the same title. When true, only one article per unique title is returned (default: false)

See the Filtering Articles section for detailed documentation of shared parameters with examples.

Response data follows the same plan-based content restrictions as the /news endpoint.

Response Format

Top-news responses share the same structure as the general news endpoint.

{
  "next_cursor": "MTc0MTA5NDI4MDAwMCw5NTI1OTMwNQ==",
  "total_results": 1245,
  "per_page": 50,
  "data": [
    {
      "id": "5b710ed2-caf0-4e33-bdf7-c9ff0eb37989",
      "title": "France investigates oil tanker linked to Russia's shadow fleet",
      "source_title": "Reuters",
      "source_link": "https://www.reuters.com",
      "article_link": "https://www.reuters.com/world/europe/france-investigates-oil-tanker-2025-09-30",
      "keywords": ["shadow fleet", "Russian oil"],
      "topics": ["politics", "energy", "sanctions"],
      "language": "en",
      "description": "French authorities are investigating...",
      "pub_date": "2025-09-30T14:30:00Z",
      "creator": "Reuters Staff",
      "content": "Full article content...",
      "media_url": "https://example.com/image.jpg",
      "media_type": "image/jpeg",
      "sentiment": {
        "pos": 0.02,
        "neg": 0.068,
        "neu": 0.912
      },
      "source": {
        "id": "reuters",
        "country": "GB",
        "political_leaning": "center",
        "reliability_score": 9.0,
        "type": "news_agency"
      }
    }
  ]
}