# Blackwood News Briefing

> Blackwood News Briefing is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-19).

Returns a structured research briefing on a topic by fetching, reading, and summarizing up to 3 recent GDELT news articles in a single call

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/news-briefing?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackwood-news-briefing-40941c81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uUHiy21pPLunJU2Zols80

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blackwood-news-briefing-40941c81 -d '<json body>'
```

Example prompt: Give me a news briefing on stablecoin regulation from the last 48 hours — summarize the most recent press coverage in English.

## When to prefer this

Use this endpoint when you need a synthesized research briefing with full article summaries on a topic — not just headlines. Prefer it over raw news search endpoints when you want the articles read and summarized in one call. Do not use for breaking news (too slow), paywalled articles, or fetching a single known article URL (use the webpage markdown endpoint instead).

## Known failure modes

- No recent GDELT articles found for the topic within the time window
- Article URL is paywalled or inaccessible — appears in skipped list with reason
- Topic string too short or too long (violates minLength/maxLength)
- Hours value out of range (must be 1–72)
- Slow response due to live article fetching — p95 around 15 seconds
- Payment failure if USDC balance is insufficient

## How this service works

Use when you need a news briefing, a research summary of recent coverage or an analysis of what the press says about a topic or company. Do not use for breaking news, paywalled pages or one known article (use blackwood_webpage_markdown). Returns JSON with a research briefing on a topic in one call: up to 3 recent GDELT news articles, each read and summarized, with source and link, below the price of separate calls for 0.04 USDC per call. Typical response time 15000 ms (p95). Category: Search.

## Output

A JSON object containing the topic queried, the hours window searched, an array of up to 3 articles each with a summary, source name, and URL, a list of skipped URLs with reasons, attribution notes, and a suggested next call for continuing the research loop.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "topic"
     ],
     "properties": {
      "hours": {
       "type": "integer",
       "maximum": 72,
       "minimum": 1,
       "description": "How far back to look for news, in hours, 1 to 72 (24 when omitted), e.g. 48"
      },
      "topic": {
       "type": "string",
       "maxLength": 200,
       "minLength": 2,
       "description": "Topic, company or person to research, e.g. stablecoin regulation"
      },
      "language": {
       "type": "string",
       "maxLength": 30,
       "minLength": 2,
       "description": "Language of the summaries (English when omitted), e.g. Portuguese"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "topic",
      "hours",
      "articles",
      "skipped",
      "attribution",
      "note"
     ],
     "properties": {
      "next": {
       "type": "object",
       "required": [
        "service",
        "tool",
        "method",
        "url",
        "useWhen",
        "sample"
       ],
       "properties": {
        "url": {
         "type": "string",
         "description": "Paid route of the next call"
        },
        "tool": {
         "type": "string",
         "description": "MCP tool name of the same call"
        },
        "method": {
         "enum": [
          "GET",
          "POST"
         ],
         "type": "string"
        },
        "sample": {
         "type": "string",
         "description": "Free fixed sample of the whole family"
        },
        "service": {
         "type": "string",
         "description": "Service id of the suggested next paid call"
        },
        "useWhen": {
         "type": "string",
         "description": "When the next call is the right one"
        }
       },
       "desc
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Each article was read from its page and summarized by Blackwood State with Workers AI (granite-4.0-h-micro); open the link for the full text. Articles come from the GDELT news search, one per source.",
  "hours": 24,
  "topic": "bitcoin",
  "skipped": [
   {
    "url": "https://www.openpr.com/news/4665025/bitcoin-s-quantum-transition-won-t-stop-at-bitcoin",
    "reason": "http_403"
   }
  ],
  "articles": [
   {
    "url": "https://econotimes.com/Bitcoin-Price-Holds-Above-81K-as-ETF-Outflows-Raise-Concerns-1756044",
    "title": "Bitcoin Price Holds Above $81K as ETF Outflows Raise Concerns",
    "source": "econotimes.com",
    "bullets": [],
    "summary": "Bitcoin maintained its position above $81,000 on October 17, 2026, as investors weighed fluctuating U.S. spot Bitcoin ETF flows, institutional demand concerns, and expectations of further Federal Reserve interest rate hikes. The world's largest cryptocurrency climbed 0.6% to $81,544.8, recovering from a volatile trading week that briefly pushed prices below the crucial $80,000 support level.",
    "publishedAt": "2026-10-17T20:05:00.000Z"
   },
   {
    "url": "https://www.newsbtc.com/bitcoin-news/bitcoin-etfs-lose-82-million-as-blackrock-leads-friday-s-withdrawals/",
    "title": "Bitcoin ETFs Lose $82 Million As BlackRock Leads Friday's Withdrawals",
    "source": "newsbtc.com",
    "bullets": [],
    "summary": "Bitcoin ETFs experienced a significant loss of $82 million as BlackRock led withdrawals on Friday, signaling a shift in investor sentiment. Meanwhile, MemeToro, a new meme coin launch in 2026, aims to benefit from a broader altcoin rotation in the cryptocurrency market.",
    "publishedAt": "2026-10-17T12:13:00.000Z"
   },
   {
    "url": "https://www.aol.com/articles/really-owns-bitcoin-inside-blackrock-160038000.html",
    "title": "Who Really Owns the Bitcoin Inside BlackRock's ETF?",
    "source": "aol.com",
    "bullets": [
     "A Delaware trust holds the actual Bitcoin, with Coinbase Custody managing the private keys.",
     "IBIT shareholders gain Bitcoin price exposure but cannot withdraw or spend the coins personally.",
     "Share creations and redemptions drive Bitcoin supply dynamics, with IBIT mirroring Bitcoin's price movements."
    ],
    "summary": "BlackRock's Bitcoin ETF, IBIT, does not give investors direct ownership of the Bitcoin it holds; instead, a separate Delaware trust legally owns the Bitcoin, while Coinbase Custody hol
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackwood-news-briefing-40941c81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)
