# News250

> Real-time global news, deduplicated and AI-summarized. One event, one payload.

News250 ingests news from hundreds of sources worldwide, clusters duplicate coverage of the same event into a single unified record, and generates a concise AI summary per cluster. The data is accessible via a REST API.

## Product

- [Home](https://news250.com/): Live news explorer — browse deduplicated clusters in real time
- [API Reference](https://news250.com/api): Interactive endpoint explorer with request/response schemas
- [Documentation](https://news250.com/docs): Authentication, rate limits, pagination, and integration examples
- [Pricing](https://news250.com/pricing): Starter, Pro, and Enterprise plans

## API

Base URL: https://news250.com/api/v1

Public endpoint (no key required):
- GET /api/v1/public/clusters — latest deduplicated news clusters, up to 50 results

Authenticated endpoints (Bearer token required):
- GET /api/v1/clusters — paginated cluster feed, up to 100 per page, filterable by language/country/category
- GET /api/v1/clusters/{id} — single cluster by ID
- GET /api/v1/clusters/{id}/sources — all source articles for a cluster
- GET /api/v1/search?q= — full-text search across headlines and summaries
- GET /api/v1/entities — trending named entities (orgs, persons, locations)
- GET /api/v1/user/usage — API key usage stats

## Cluster Schema

Each cluster contains:
- cluster_id: unique identifier (e.g. cl_1234567)
- headline: the main headline
- summary_250: concise AI-generated summary of the event
- language: ISO language code (EN, ES, FR, IT, etc.)
- country: ISO country code of the primary source
- sources: list of deduplicated source articles with domain, url, title, published_at
- entities: extracted organizations, persons, and locations
- timestamps: first_seen, last_updated, cluster_date
- dedup: source_count and similarity_score

## Legal

- [Privacy Policy](https://news250.com/privacy)
- [Terms of Service](https://news250.com/terms)