API
NUCLEUZ APIAPI

Structured news enrichment + entity-linking API that converts raw stories into canonical, AI/machine-ready records.

Ingests upstream news stories and feeds
Performs extraction, normalization, and entity resolution
Outputs a linked context graph for fast indexing, search, and downstream automation
PeoplePlacesOrgsAuthorsSourcesGEOTopicsProductsTickersURLs
Live API Dashboard

Real-time metrics from NUCLEUZ API. Access these endpoints, feeds, and enriched data through a simple RESTful API.

CONNECTING• refresh 1s
0
Stories Today · All Feeds
24h12hnow
Health: 0%
Feed Breakdown
0
Window
0
Global
0
Local
0
BZ100
0
Crypto
0
Markets
Performance
0
Sources
0+
Topics
0.000s
Resp Time
0%
Cache Hit
Service Level MetricsOFFLINE
AvailabilityOK
100.0%
Target: 99.5%
Response TimeOK
0ms
Target: <500ms
Error RateOK
0.00%
Target: <0.5%
Data FreshnessOK
0s
Target: <30min

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:

  • 65+ Premium Sources: Reuters, AP, BBC, NYT, WSJ, and more
  • AI-Enhanced Content: Automatic topic tagging ("Blerbles"), sentiment analysis
  • Real-time Streaming: Server-Sent Events for breaking news
  • BLERBZ100 Rankings: Daily top 100 stories by engagement and virality
  • Base URL

    text
    https://api.blerbz.com/v2

    Rate Limits

    All endpoints include rate limit headers:

    text
    X-RateLimit-Limit: 300
    X-RateLimit-Remaining: 299
    X-RateLimit-Reset: 2026-01-01T00:00:00Z
    Last updated: February 2026 · NUCLEUZ API v2.0

    API 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
    curl -H "Authorization: Bearer nuc_demo_playground_2026" "https://api.blerbz.com/v2/documents?limit=10"
    Starter Code
    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 documents
    Response

    Execute a request to see the response

    Product Highlight

    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.

    Live Preview
    Feed SourceSelect one or more feeds to customize the ticker
    <!-- 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>
    EndpointGET /v2/feeds/latest
    AuthBearer token (all tiers)
    Rate LimitPer your plan tier
    RefreshRecommended: 15–30s interval

    Simple, Transparent Pricing

    Start building with NUCLEUZ API. Scale as you grow.

    MonthlyAnnualSave 20%
    🎁
    1 Month Free Trial on all plans — no charge until day 31

    Basic

    For hobbyists and small projects

    1 Month Free
    $10/mo
    200req/min
    200Kreq/mo
    • 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.

    Coming Soon

    Professional

    Enterprise-grade with SLA

    TBD
    1000req/min
    Unlimitedreq/mo

    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.