Getting Started
The NewsRank API gives you programmatic access to real-time news intelligence — articles, stories, entities, and search across thousands of sources.
What is NewsRank?
NewsRank monitors 270+ professional news sources worldwide in real-time. Every article is enriched with full-text content, AI summaries, and tagged entities (people, organizations, places). Related articles are automatically clustered into stories using semantic similarity — giving you "the event" rather than individual reports about it.
Everything is accessible through a simple REST API. All endpoints return JSON, support pagination, and can be filtered by category, date, source, entity type, and more.
Core Concepts
Articles
Individual news articles from thousands of sources. Each includes title, source, category, publication date, full-text content, AI-generated summary, and entity tags.
Stories
When multiple articles cover the same event, they're grouped into a "story" with a headline, summary, timeline, contributing sources, and related entities.
Entities
People, organizations, and locations mentioned across articles. Each entity has a type, description, Wikipedia link, and mention history. Sub-types include politicians, companies, and more.
Sources
Thousands of news outlets — Reuters, AP, BBC, and more. Each source has quality and authority rankings, article counts, and category breakdowns.
Search
Full-text search across all articles, plus entity-aware search that auto-detects entity names in queries. Autocomplete endpoint for building search UIs.
Graphs
Relationship networks between entities, stories, and topics. Entity-to-entity connections, story-to-entity mappings, and topic clusters for visualization and discovery.
For a deeper dive into each concept, see the Concepts reference.
Base URL
All API requests use the following base URL:
Quick Start
- 1
Create an account
Sign up at newsrank.ai/login. Free tier includes 1,000 credits/month.
- 2
Get your API key
Generate a key from your dashboard. Keys start with
nrf_. Pass it as a query parameter or Bearer token. - 3
Make your first request
Fetch the latest stories with the example below. Every endpoint page has a Try It panel you can use to test live.
Your First Request
Fetch the 5 most recent stories:
curl "https://api.newsrank.ai/v1/stories?limit=5" \
-H "Authorization: Bearer nrf_your_api_key"Example Response
Paginated results include total, offset, and limit fields.
{
"stories": [
{
"id": 1042,
"title": "Supreme Court Rules on Landmark Climate Case",
"summary": "The Supreme Court issued a 6-3 decision limiting EPA authority...",
"article_count": 47,
"category": "politics",
"top_source": "Reuters",
"entities": ["Supreme Court", "EPA", "United States"],
"first_seen": "2026-02-24T08:30:00Z",
"last_updated": "2026-02-24T14:15:00Z"
},
{
"id": 1038,
"title": "Tech Giants Report Record Q4 Earnings",
"summary": "Apple, Microsoft, and Google parent Alphabet all exceeded...",
"article_count": 32,
"category": "business",
"top_source": "Bloomberg",
"entities": ["Apple", "Microsoft", "Alphabet"],
"first_seen": "2026-02-23T16:00:00Z",
"last_updated": "2026-02-24T09:45:00Z"
}
],
"total": 284,
"offset": 0,
"limit": 5
}What Can You Build?
News Aggregator
Build a reader app with real-time articles, source diversity, and story clustering.
Trading Bot
Feed market-moving news into trading algorithms with low-latency article and entity data.
Real-time Alerts
Monitor topics, entities, or keywords and trigger instant notifications when news breaks.
Media Monitoring
Track mentions of companies, people, or topics across thousands of sources.
Entity Tracker
Follow politicians, organizations, or locations and see every article that mentions them.
Trend Analysis
Analyze which topics, entities, and stories are trending over time.
Source Comparison
Compare how different outlets cover the same story with per-source breakdowns.
Knowledge Graph
Visualize entity relationships and topic clusters with our graph endpoints.
Explore the API
Articles
List, search, and filter individual news articles.
Stories
Browse clustered news events with timelines and sources.
Entities
Query people, organizations, and locations in the news.
Search
Full-text and entity-aware search with autocomplete.
Sources
Browse news outlets with quality rankings and stats.
Graphs
Entity networks, story mappings, and topic clusters.
AI Integration
Building with an AI coding assistant? Point it at our machine-readable API reference to get instant integration help.
These follow the llms.txt standard — paste the URL into ChatGPT, Claude, Cursor, or any AI tool to help write integration code.