Newsroom: A Free Front-End for the World News API

Newsroom is a free, browser-based explorer for the World News API. It turns the API's endpoints into six interactive workspaces: an advanced article search, clustered top stories, 6,000+ newspaper front pages from 125+ countries, a 3D news globe, a live quota dashboard, and settings. Whether you're evaluating the API before integrating it, running a news monitoring workflow, feeding live news data into an AI agent, or just scanning today's headlines across the world, Newsroom gives you the full surface area of the data in a single UI — no code required.

Open Newsroom →

Why Newsroom exists

A news API is only as useful as the queries you can write against it. The API docs tell you what fields exist; Newsroom shows you what they do when combined. Every filter the World News API supports is a control in the UI, and every field in the response has a rendering — sentiment scores become sliders, extracted entities become filter chips, geocoded locations become markers on a globe. It's a functional showcase that doubles as a production-ready tool.

If you've been comparing news API options — newsapi.org, newsdata.io, gnews.io, newsapi.ai, the World News API — Newsroom lets you ground-truth your evaluation. Run real queries against your account, see actual response payloads, and decide whether coverage, freshness, and sentiment quality fit your use case before writing a line of integration code.

What Newsroom does

Newsroom is a progressive web app. You bring a World News API key; the app handles request throttling, live quota tracking, entity extraction, sentiment filtering, geographic rendering, and saved searches. Six workspaces cover the common ways people actually use global news data.

The search view exposes every filter the API supports in a single panel:

  • Free-text query with optional title-only mode
  • Category (politics, sports, business, entertainment, health, science, technology, etc.)
  • Sentiment score as a dual slider on a -1 to 1 scale (negative → positive)
  • Publication date range
  • Language — pick a language from dozens supported
  • Source country — pick one of 125+ countries
  • News source — filter to specific publications by domain
  • Author
  • Location + radius — pick a city (geocoded automatically) and a km radius to surface only articles whose extracted locations fall inside it

A typical combined query might be: "climate AND subsidy" in English-language business sources published in the last 7 days with sentiment between -0.5 and 0.1, centered on Brussels within 200 km. You compose it with controls; the app hits the API and renders.

Named searches

Save any filter combination as a named preset and reload it later. This is the core of the monitoring loop: define the query once, come back to it, scan the new results. Named searches are stored in browser state alongside your API key.

Top news

Top News surfaces clustered story groupings across multiple outlets, pivoted by country and language. Instead of deduplicating yourself, you see a single canonical story with its sibling articles underneath. Useful for “what's breaking in Japan right now” or “what's the German-language spin on this story”.

Newspaper front pages online

Front Pages browses 6,000+ scanned newspaper covers from 125+ countries with a historical date picker. Algorithmic feeds rank by engagement; newspaper editors rank by judgement. The two views answer different questions and work well side-by-side — use Top News to see what's viral, Front Pages to see what respected editors put above the fold.

3D news globe

The Globe view plots article locations on both mercator and globe projections. Switch between clustered and individual-marker modes; spin, zoom, and the visible story set updates live. Good for spotting news hotspots at a glance — where climate coverage concentrates in a given week, or which regions are dominating a breaking story geographically.

Named entity recognition

Every article returned by the API includes extracted entities. Newsroom surfaces them as color-coded filter chips on each card — indigo for people (PER), amber for organizations (ORG), teal for locations (LOC) — and aggregates the most-mentioned entities across the current result set in a side panel. Click any chip to filter the visible results client-side, with zero extra API cost.

Quota dashboard

The Stats view tracks your daily and monthly quota consumption against your plan limits in near-real time. It warns at 80% of your limit and blocks new requests once you hit 100%, so you don't burn through a trial or rack up overage charges accidentally. It also projects estimated monthly overage cost in USD, which is useful when picking a plan.

Who Newsroom is for

  • Developers evaluating a news API for developers — try endpoints through a real UI before integrating.
  • AI and LLM application builders who need live news data for AI agents — Newsroom is the fastest way to see what the API returns for a given query before you wire it into a RAG pipeline or agent tool.
  • Publishers and brand teams running competitive press tracking across markets.
  • Journalists and researchers who need multilingual search, entity extraction, and geographic views in one workspace.
  • Data and analytics teams producing dashboards from news content.

Newsroom vs. calling the API directly

Newsroom (this app) Raw World News API
Query compositionClick controlsWrite query strings / SDK calls
Sentiment filteringDual slider, -1 to 1min-sentiment / max-sentiment params
Location filteringGeocoded city picker + radiuslocation-filter lat/lon/radius
Entity browsingColor-coded chips, one-clickParse entities array yourself
Front pagesCalendar + country picker/retrieve-front-page endpoint
Quota trackingLive dashboard, 80% warningHeaders + your own monitoring
Request throttlingBuilt-inYou implement
CostFree, BYO keyPer plan pricing

Newsroom doesn't replace programmatic access — it complements it. Explore in the UI, then lift the filter combination into code when you're ready to ship.

Getting started

  1. Create a free World News API key at your console.
  2. Open Newsroom, paste your key into the onboarding screen — it stores in your browser's local storage and is sent only to api.worldnewsapi.com, never proxied through a third party.
  3. Pick a workspace: Search, Top News, Front Pages, Globe, Stats, or Settings.

That's it. First query takes about two seconds.

A quick code pairing

The same filters you compose in Newsroom translate directly to API calls. In Python:

import requests

resp = requests.get(
    "https://api.worldnewsapi.com/search-news",
    params={
        "text": "climate AND subsidy",
        "language": "en",
        "min-sentiment": -0.5,
        "max-sentiment": 0.1,
        "earliest-publish-date": "2026-04-12",
        "number": 20,
    },
    headers={"x-api-key": "YOUR_KEY"},
)
print(resp.json()["news"][0]["title"])

Or in JavaScript (browser or Node 18+):

const params = new URLSearchParams({
  text: "climate AND subsidy",
  language: "en",
  "min-sentiment": "-0.5",
  "max-sentiment": "0.1",
  number: "20",
});

const res = await fetch(
  `https://api.worldnewsapi.com/search-news?${params}`,
  { headers: { "x-api-key": "YOUR_KEY" } },
);
const { news } = await res.json();

Use Newsroom to iterate on the filter combination, then copy the parameters into your code.

Frequently asked questions

What is a news API?

A news API is an HTTP endpoint you query for structured news articles — title, body, source, published date, language, and typically enriched fields like sentiment score and extracted entities. Unlike RSS or scraped feeds, a news API gives you reliable JSON, consistent schemas, query parameters, and rate limits you can plan around. The World News API aggregates articles from thousands of sources worldwide and exposes them through a single query layer.

Is there a free API for news?

Yes. The World News API has a free plan with a daily points quota; most endpoints cost 1 point per call. Newsroom tracks your usage live against the plan limit and warns before you hit the ceiling. The free plan is enough to use every feature in the app for evaluation and light personal projects.

Which news API offers the best real-time updates?

Freshness depends on the source; the World News API continuously ingests articles and most appear within minutes of publication. Use the earliest-publish-date filter in Newsroom's Advanced Search to narrow to the last hour or day and see the freshness characteristics for yourself rather than taking a marketing page's word for it.

Which API provides live news data for AI agents?

Newsroom is a debugging UI for exactly this use case. You construct a query interactively, confirm the returned articles are the ones your agent should see, then port the filter parameters into your agent's tool definition or RAG ingestion step. The World News API returns clean, deduplicated JSON with language tags, entities, and sentiment — well-shaped for LLM consumption.

How does news sentiment analysis work in Newsroom?

Every article in the API response carries a sentiment score between -1 (negative) and 1 (positive). Newsroom exposes the score as a dual-handled slider in Advanced Search: set a range, and only articles whose tone falls inside it are returned. Combine it with source-country and language filters for tone-aware monitoring — for example, negative-leaning coverage of a given brand in a specific market.

Does Newsroom offer a separate news sentiment API?

No — the sentiment scores come from the underlying World News API payload, so the same values are available programmatically. Newsroom is the UI; the API is the source of truth.

What does named entity recognition look like?

Each article card lists extracted entities as chips: indigo for people, amber for organizations, teal for locations. A side panel aggregates the most-frequent entities across your current result set. Click any chip to filter locally — no additional API call.

Can I see front pages of newspapers today from any country?

Yes. Front Pages covers 6,000+ titles across 125+ countries. Use the country filter plus the date picker to pull today's covers or any historical date the API has archived.

Is the interactive news map open source?

The map view uses open-source rendering; tiles and article data come from the World News API.

Does it work on mobile?

Yes — the layout collapses filter panels on small screens and the app is installable from supported browsers.

How is my API key stored?

The key is saved in your browser's local storage and sent only in the x-api-key header on requests to api.worldnewsapi.com. There's no intermediate server proxying your requests or holding your key. Clear your browser storage (or use the Settings view) to remove it.

Try the World News API with Newsroom

Newsroom is the fastest way to see what the World News API can actually do. Bring a key, open the app, compose a query, and see real results in seconds.

Open Newsroom →