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.
Language & Translation
Every story in three language versions. 55+ languages across 195+ countries. Available on all tiers.
SRC (Source)
Original article in its native language, preserved exactly as published.
EN (English)
AI-translated English version with editorial accuracy and fact preservation.
COO (Country of Origin)
National language of the story's country of origin. 195+ country mappings.
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: 2026-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_2026" "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_2026'
}
});
const data = await response.json();
console.log(data.data); // Array of documentsExecute a request to see the response
Headline Scrolling Ticker
Embed a live-updating, scrolling news ticker powered by NUCLEUZ API. Works with all API tiers. Choose from all feeds, a specific feed, or a custom subset.
<!-- BLERBZ Headline Scrolling Ticker -->
<!-- Embed this snippet in your HTML. Replace YOUR_API_KEY with your NUCLEUZ API key. -->
<div id="blerbz-ticker" style="
background: #0a0a0a;
border: 1px solid rgba(255,255,255,0.08);
border-radius: 10px;
overflow: hidden;
position: relative;
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
">
<div style="
display: flex; align-items: center; gap: 8px;
position: absolute; left: 0; top: 0; bottom: 0;
padding: 0 16px; z-index: 2;
background: linear-gradient(90deg, #0a0a0a 85%, transparent);
font-family: 'SF Mono', Monaco, Inconsolata, monospace;
font-size: 9px; font-weight: 700; letter-spacing: 1.5px; color: #fff;
">
<span style="
width: 7px; height: 7px; border-radius: 50%;
background: #ef4444; box-shadow: 0 0 6px rgba(239,68,68,0.6);
animation: blerbzPulse 1.5s ease-in-out infinite;
"></span>
LIVE
</div>
<div style="
overflow: hidden; padding: 14px 16px 14px 90px;
mask-image: linear-gradient(90deg, transparent 0%, black 5%, black 95%, transparent 100%);
-webkit-mask-image: linear-gradient(90deg, transparent 0%, black 5%, black 95%, transparent 100%);
">
<div id="blerbz-ticker-track" style="
display: flex;
animation: blerbzScroll 80s linear infinite;
width: max-content; will-change: transform;
"></div>
</div>
</div>
<style>
@keyframes blerbzScroll {
0% { transform: translate3d(0, 0, 0); }
100% { transform: translate3d(-50%, 0, 0); }
}
@keyframes blerbzPulse {
0%, 100% { opacity: 1; transform: scale(1); }
50% { opacity: 0.7; transform: scale(0.9); }
}
#blerbz-ticker-track:hover { animation-play-state: paused; }
</style>
<script>
(function() {
const API_KEY = 'YOUR_API_KEY';
const API_BASE = 'https://api.blerbz.com/v2';
const ENDPOINT = '/feeds/latest?limit=25';
async function fetchHeadlines() {
const res = await fetch(API_BASE + ENDPOINT, {
headers: { 'Authorization': 'Bearer ' + API_KEY }
});
if (!res.ok) return [];
const data = await res.json();
return (data.items || data.data || []).map(item => ({
headline: item.headline || item.originalTitle || item.title || '',
source: item.source?.name || item.sourceName || item.source || 'News',
})).filter(h => h.headline.length > 10);
}
function render(headlines) {
const track = document.getElementById('blerbz-ticker-track');
if (!track || !headlines.length) return;
const items = [...headlines, ...headlines];
track.innerHTML = items.map(h =>
'<div style="display:flex;align-items:center;gap:4px;padding-right:32px;white-space:nowrap;flex-shrink:0">' +
'<span style="font-size:10px;font-weight:700;color:rgba(255,255,255,0.5);text-transform:uppercase;letter-spacing:0.5px">' + h.source + ':</span>' +
'<span style="font-size:13px;font-weight:500;color:#fff;max-width:420px;overflow:hidden;text-overflow:ellipsis">' + h.headline + '</span>' +
'<span style="color:rgba(255,255,255,0.15);font-size:8px;margin-left:22px">\u2022</span>' +
'</div>'
).join('');
}
fetchHeadlines().then(render);
setInterval(() => fetchHeadlines().then(render), 30000);
})();
</script>GET /v2/feeds/latestBearer token (all tiers)Per your plan tierRecommended: 15–30s intervalSimple, 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
- Multilingual Translation (SRC/EN/COO)
- BLERBZ100 Rankings
- Grok-Enhanced AI
- Social Accounts Links & Directory
- Unlimited BLERBZ Labs 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
- Multilingual Translation (SRC/EN/COO)
- BLERBZ100 Rankings
- Grok-Enhanced AI
- Social Accounts Links & Directory
- Unlimited BLERBZ Labs 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.