Feeds API
Multiple curated feeds with cursor-based pagination and score breakdowns.
Real-time Feed
Stream breaking news with sub-second latency via Server-Sent Events.
BLERBZ100 Rankings
Daily top 100 stories ranked by engagement, velocity, and viral detection.
Trending Detection
Velocity-based trending with configurable time windows (1h, 6h, 24h).
Filtering & Discovery
Powerful filtering options to find exactly the content you need.
Topic Filtering
Filter content by AI-extracted topic tags (blerbles) for focused feeds.
Source Filtering
Filter by specific news sources like Reuters, BBC, AP, and 200+ more.
Social Voices
X.com content feed with posts, threads, and long-form articles.
Markets Feed
AI-classified stocks, indices, economic indicators, and finance news.
Crypto Feed
AI-classified Bitcoin, Ethereum, blockchain, DeFi, and NFT stories.
Documents API
Canonical document objects with rich metadata and cross-source intelligence.
Canonical Documents
SDK-friendly document format with ETag support and conditional GET.
Free Alternatives
Find free versions of paywalled content from 2-4 alternative sources.
Cross-source Dedup
Automatic deduplication identifies same story across multiple sources.
Developer Experience
Built for performance with modern API conventions.
Smart Caching
Multi-tier caching with 94%+ hit rates for blazing fast responses.
Incremental Sync
Cursor-based sync API to efficiently track document changes.
Sparse Fieldsets
Request only the fields you need to minimize payload size.
API Documentation
Everything you need to integrate NUCLEUZ into your app
NUCLEUZ API Overview
NUCLEUZ is a real-time news intelligence API that powers BLERBZ. Get access to:
Base URL
https://api.blerbz.com/v2Rate Limits
All endpoints include rate limit headers:
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 2025-01-01T00:00:00ZAPI Playground
Try the NUCLEUZ API right here. No account required for public endpoints.
List canonical story documents with pagination
Using demo API key with liberal limits. No account required.
Parameters
Number of items
Pagination cursor
Filter by date (YYYY-MM-DD)
Filter by sources (comma-separated)
curl -H "Authorization: Bearer nuc_demo_playground_2025" "https://api.blerbz.com/v2/documents?limit=10"
const response = await fetch('https://api.blerbz.com/v2/documents?limit=10', {
headers: {
'Authorization': 'Bearer nuc_demo_playground_2025'
}
});
const data = await response.json();
console.log(data.data); // Array of documentsExecute a request to see the response
Simple, Transparent Pricing
Start building with NUCLEUZ API. Scale as you grow.
Basic
For hobbyists and small projects
- Read Access
- Trending Feed
- Full-Text Search
- Local News Network
- BLERBZ100 Rankings
- Grok-Enhanced AI
- Unlimited Blerbz AI Credits
- Webhooks
- SLA Guarantee
- Dedicated Support
No charge for 30 days. Cancel anytime.
Advanced
For startups and production apps
- Read Access
- Trending Feed
- Full-Text Search
- Local News Network
- BLERBZ100 Rankings
- Grok-Enhanced AI
- Unlimited Blerbz AI Credits
- Webhooks
- SLA Guarantee
- Dedicated Support
No charge for 30 days. Cancel anytime.
Professional
Enterprise-grade with SLA
Need a custom solution?
Contact us for enterprise pricing, custom SLAs, and dedicated infrastructure.
Ready to build with NUCLEUZ API?
Get started with our documentation and try the live playground above.