# x402 News Headlines Search (GDELT, 72h)

> x402 News Headlines Search (GDELT, 72h) is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-23).

Returns recent news headlines from the last 72 hours matching a keyword query, sourced from GDELT, with metadata including tone, people, organizations, and images.

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/news-headlines?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-news-headlines-search-gdelt-72h-daaf43ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WZTLQvcGChBFHIw-5y7NS

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 x402-news-headlines-search-gdelt-72h-daaf43ae -d '<json body>'
```

Example prompt: Find me the top 20 most recent news headlines mentioning 'Apple earnings' from the last 48 hours, sorted by most recent first.

## When to prefer this

Use this endpoint when you need recent (within 72 hours), English-language news headlines about a specific keyword, person, company, or topic with structured metadata including sentiment tone and named entities. Prefer this over general web search when you need structured article metadata (tone, people, organizations) from a consistent news corpus. Do not use for full article text, non-English news, paywalled sources, or news older than 72 hours.

## Known failure modes

- Query string too short (under 2 chars) or too long (over 200 chars) returns validation error
- Hours parameter outside 1-72 range returns validation error
- Limit parameter outside 1-50 range returns validation error
- No matching articles found returns empty articles array with count 0
- Invalid domain filter returns empty results or validation error
- Payment failure or insufficient USDC balance returns 402 error
- GDELT data lag may mean very recent events (last few minutes) are missing

## How this service works

Use when you need news articles or headlines from the last 72 hours about a topic, company or person. Do not use for full article text, paywalled sources, non-English coverage or news older than 72 hours. Returns JSON with recent news articles matching keywords: headline, URL, source, publish time, authors, tone, image and the people and organizations named, from GDELT for 0.008 USDC per call. Typical response time 600 ms (p95). Category: Search.

## Output

A JSON object containing the query, hours window, article count, and an array of articles each with headline, URL, source domain, publish timestamp, authors, sentiment tone score, image URL, named persons, and named organizations. Also includes a lastIngestAt timestamp, GDELT attribution, and a suggested next-call hint.

## 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": [
      "query"
     ],
     "properties": {
      "sort": {
       "enum": [
        "recent",
        "relevance"
       ],
       "type": "string",
       "description": "recent (default) or relevance"
      },
      "hours": {
       "type": "integer",
       "maximum": 72,
       "minimum": 1,
       "description": "How far back to look, in hours (1-72, 24 when omitted)"
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Maximum articles to return (1-50, 20 when omitted)"
      },
      "query": {
       "type": "string",
       "maxLength": 200,
       "minLength": 2,
       "description": "Keywords to find in headlines, people and organizations, e.g. nvidia earnings (all words must match)"
      },
      "domain": {
       "type": "string",
       "maxLength": 253,
       "description": "Only articles from this source domain, e.g. reuters.com"
      }
     }
    },
    "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": [
      "query",
      "hours",
      "count",
      "articles",
      "lastIngestAt",
      "attribution"
     ],
     "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",
         "descripti
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "hours": 24,
  "query": "climate finance",
  "articles": [
   {
    "url": "https://openthemagazine.com/india/india-urges-rich-nations-to-deliver-climate-finance-ahead-of-cop31",
    "tone": 2.65,
    "image": "https://media.openthemagazine.com/openthemagazine/2026-10-17/d23k6yzu/CLIMATE.jpg?&ar=40:21&auto=format,compress&ogImage=true&mode=crop&enlarge=true&overlay=false&overlay_position=bottom&overlay_width=100",
    "title": "India Calls on Rich Nations to Fulfill Climate Finance Commitments Ahead of COP31",
    "domain": "openthemagazine.com",
    "themes": [
     "ALLIANCE",
     "CONSTITUTIONAL",
     "LEADER",
     "TAX_FNCACT_PRESIDENT",
     "USPEC_POLITICS_GENERAL1",
     "WB_1458_HEALTH_PROMOTION_AND_DISEASE_PREVENTION",
     "WB_1462_WATER_SANITATION_AND_HYGIENE",
     "WB_635_PUBLIC_HEALTH"
    ],
    "authors": "Open Bureau",
    "persons": [
     "Soumya Nair",
     "Jal Shakti Abhiyan",
     "Surya Ghar"
    ],
    "publishedAt": "2026-10-17T06:15:00.000Z",
    "organizations": [
     "National Green Hydrogen Mission",
     "International Solar Alliance",
     "United Nations",
     "Counsellor At India Permanent Mission",
     "Global Biofuels Alliance"
    ]
   }
  ],
  "attribution": "Source: The GDELT Project (https://www.gdeltproject.org/)",
  "lastIngestAt": "2026-10-17T06:18:11.598Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-news-headlines-search-gdelt-72h-daaf43ae/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)