Skip to main content

Documentation Index

Fetch the complete documentation index at: https://newscatcherinc-docs.mintlify.dev/docs/llms.txt

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

Breaking news represents important stories rapidly gaining traction across multiple sources. News API identifies these events by analyzing coverage patterns and grouping articles by content similarity — surfacing high-impact events as they emerge.

​
How it works

1

Clustering

Recently published articles are automatically grouped based on content similarity.
2

Validation

Each cluster is analyzed for breaking news signals: sudden spikes in publication frequency, coverage across multiple publishers, and presence of high-ranking news sources.
3

Deduplication

Duplicate content within clusters is filtered out while preserving source diversity.
4

Historical analysis

New candidates are compared against recent breaking news to track continuing stories.
5

AI evaluation

An AI analysis step confirms whether a cluster represents a significant event.
6

Classification

Clusters meeting the breaking news criteria receive a special flag in the system.
When you query /breaking_news, you receive the most representative article from each breaking news cluster. Results are ordered by cluster size, so the most widely covered stories appear first.

​
Query endpoint

curl -X POST "https://v3-api.newscatcherapi.com/api/breaking_news" \
  -H "x-api-token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "theme": "Business",
    "page_size": 100,
    "top_n_articles": 5
  }'

​
Response format

{
  "status": "ok",
  "total_hits": 465,
  "page": 1,
  "total_pages": 5,
  "page_size": 100,
  "breaking_news_events": [
    {
      "event_id": "15610469432059813057",
      "articles_count": 5842,
      "articles": [
        {
          "title": "...",
          "author": "...",
          "published_date": "...",
          "link": "...",
          "domain_url": "..."
        }
      ]
    }
  ]
}
For a full description of response fields, see the Breaking news endpoint reference.

​
Comparison with other endpoints

Breaking newsSearchLatest headlines
PurposeDiscover high-impact emerging storiesFind specific contentRetrieve recent headlines
Time scopeFixed at 24 hoursConfigurable with from_ and to_Configurable with when
Result groupingClustered by eventIndividual articlesIndividual articles
Primary sortingBy cluster sizeBy relevance, date, or rankBy publication date
Use casesMedia monitoring, market intelligence, crisis monitoringContent curation, research, entity trackingNews feeds, topic monitoring

​
Use cases

  • Media monitoring — quickly identify emerging stories without tracking multiple sources manually.
  • Content curation — surface trending stories for newsletters, apps, or websites based on coverage traction.
  • Market intelligence — detect potentially market-moving events as they gain media coverage.
  • Crisis monitoring — identify sudden surges in coverage about topics of concern.

​
See also