Webz.io logoDocs
MCPs
Overview
Webz.io MCPs
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
Introduction
Quickstart
Filters
Response Format
API Reference
MCP Server
Framework SDKs
Agent Skill
News Answers API
Firehose
Cyber API
Data Breaches API
Leaked Cookies API
Non-Human Identities (NHI) API
Domain Exposure API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)
Webz.io logo
MCPs
Overview
Webz.io MCPs
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
Introduction
Quickstart
Filters
Response Format
API Reference
MCP Server
Framework SDKs
Agent Skill
News Answers API
Firehose
Cyber API
Data Breaches API
Leaked Cookies API
Non-Human Identities (NHI) API
Domain Exposure API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)
Webz.io DocumentationContact our team© 2026

Response Format

A successful request returns HTTP 200:

json
{
  "score": 7.1,
  "article": {
    "article_id": "32445ab27737dcdad9119b67fb1d379908a41ecf",
    "url": "https://www.example.com/edition/",
    "title": "Article Title",
    "published_at": "2026-08-27T07:07:00.000+03:00",
    "summary": "Article's extractive summary",
    "main_image": "https://media.example.com/image.png"
  },
  "chunk": {
    "chunk_id": "32445ab27737dcdad9119b67fb1d379908a41ecf_6",
    "chunk_index": 6,
    "text": "Relevant chunk matching the query."
  },
  "metadata": {
    "language": "english",
    "country": "US",
    "category": [
      "Economy, Business and Finance"
    ],
    "sentiment": "positive",
    "domain": "example.com",
    "site_type": "news",
    "topic": [
      "business reporting and performance",
      "business information",
      "business strategy and marketing"
    ],
    "person": [
      "Elon Musk"
    ],
    "organization": [
      "nexen tire",
      "porsche",
      "aiming",
      "bmw"
    ],
    "location": [
      "United States"
    ],
    "ticker": [
      "P911",
      "BMW"
    ],
    "source_type": "local_news",
    "political_bias": "left",
    "trust_category": "trusted_news",
    "domain_rank": 193
  }
}
FieldDescription
queryThe submitted query
total_resultsNumber of matching articles, up to k
resultsMatching article results
requests_leftRemaining credit balance
credits_usedCredits used by this search
results[].scoreMatch quality, 0-10
results[].articleArticle ID, URL, title, publish date, and summary
results[].chunk.textThe most relevant article excerpt
results[].metadataLanguage, country, category, sentiment, domain, source type, topic, person, organization, location, ticker, political_bias, trust_category, domain_rank

Get the full article text

Use article.article_id as the News API uuid: query. Set ts to the Unix timestamp in milliseconds from 30 days before the request so the News API searches the full News Search coverage window.

GET

https://api.webz.io/api/news?token=YOUR_TOKEN&q=uuid:ARTICLE_UUID&ts=YOUR_TIMESTAMP_30_DAYS_AGO

Replace ARTICLE_UUID with article.article_id from the News Search response. The News API returns the original article document, including its full text.

Last updated: August 30, 2026
PreviousFiltersNextAPI Reference