Webz.io News API

Webz.io News API

The Webz.io News API returns structured, machine-readable articles from news sites worldwide, enriched with news-specific signals like sentiment, named entities, categories, and social engagement metrics. It's used for media monitoring, risk and financial intelligence, and grounding AI applications in fresh news.

Endpoint: https://api.webz.io/api/news · Docs: docs.webz.io/docs/webz/news · Pricing: webz.io/pricing

Authentication

Every request needs your token, found in your Webz.io dashboard — your account must be enabled for the News API. Pass it as a query parameter. Sign up at webz.io to get started; the News API Lite tier is free for evaluation.

Your First Request

The q parameter combines free-text terms, field:value filters, and Boolean operators (AND, OR, NOT). Filter values are case-insensitive; quote values that contain spaces. Remember to URL-encode q in real requests.

curl -G "https://api.webz.io/api/news" \
  --data-urlencode "token=YOUR_TOKEN" \
  --data-urlencode 'q="artificial intelligence" language:english category:Tech'

Python

import requests

resp = requests.get(
    "https://api.webz.io/api/news",
    params={
        "token": "YOUR_TOKEN",
        "q": '"electric vehicles" language:english country:US',
    },
)
data = resp.json()
for post in data["posts"]:
    print(post["title"], "—", post["url"])

JavaScript

const params = new URLSearchParams({
  token: 'YOUR_TOKEN',
  q: '"interest rates" language:english sentiment:negative',
});

const res = await fetch(`https://api.webz.io/api/news?${params}`);
const data = await res.json();
data.posts.forEach((p) => console.log(p.title, p.published));

Response Format

The endpoint returns JSON with a posts array plus paging metadata:

Field	Description
posts	Array of matching articles
total_results	Total documents matching the query
more_results_available	How many results remain beyond this page
next	Path to the next page of results
requests_left	Remaining quota on your plan

Pagination: append the next value to https://api.webz.io and call it again; repeat until more_results_available reaches 0.

Time range: by default the API searches the last 3 days. To go further back, pass a ts timestamp; searching beyond 31 days also requires allowNewsHistory=true. Historical data up to 5 years is available via the Archive API.

Filtering with q

Narrow results using documented field:value filters, for example:

Filter	Example	Purpose
language:	language:english	Article language
category:	category:Politics	IPTC-based content category
topic:	topic:elections	Fine-grained topic
sentiment:	sentiment:negative	Document sentiment (positive / negative / neutral)
country:	country:US	Source country (ISO 3166-1 alpha-2)
site: / site_full:	site:reuters.com	Restrict to a domain
domain_rank:	domain_rank:<10000	Source popularity (Tranco rank)
person: / organization: / location:	organization:"Federal Reserve"	Named-entity filters (with .positive / .negative / .neutral variants)
trust.category:	trust.category:trusted_news	Trusted, fake, or satirical news
title: / text:	title:"rate cut"	Match within the headline or body

Post Fields

Each item in posts includes the article's uuid, url, title, text (full content), author, published, and language, plus enrichments: document and entity-level sentiment, extracted entities (persons, organizations, locations), categories and topics, external_links, and a thread object describing the source site (site, country, domain_rank, social/engagement metrics, and more).

Use Cases

• Media intelligence — brand, competitor, and topic monitoring at global scale
• Risk & compliance — adverse-media screening, AML, and ESG signals
• Financial analysis — market-moving news, sentiment, and event detection
• AI & LLMs — grounding retrieval-augmented apps in fresh, licensed news

Read the full News API docs →