Use when you need news articles or headlines from the last 72 hours about a topi

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.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://x402-gateway.blackwoodstate8.workers.dev/v1/news-headlines

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "limit": 3,
    "query": "climate finance"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "domain": {
              "description": "Only articles from this source domain, e.g. reuters.com",
              "maxLength": 253,
              "type": "string"
            },
            "hours": {
              "description": "How far back to look, in hours (1-72, 24 when omitted)",
              "maximum": 72,
              "minimum": 1,
              "type": "integer"
            },
            "limit": {
              "description": "Maximum articles to return (1-50, 20 when omitted)",
              "maximum": 50,
              "minimum": 1,
              "type": "integer"
            },
            "query": {
              "description": "Keywords to find in headlines, people and organizations, e.g. nvidia earnings (all words must match)",
              "maxLength": 200,
              "minLength": 2,
              "type": "string"
            },
            "sort": {
              "description": "recent (default) or relevance",
              "enum": [
                "recent",
                "relevance"
              ],
              "type": "string"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": false,
          "properties": {
            "articles": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "authors": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "domain": {
                    "type": "string"
                  },
                  "image": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "organizations": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "persons": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "publishedAt": {
                    "type": "string"
                  },
                  "themes": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "title": {
                    "type": "string"
                  },
                  "tone": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "title",
                  "url",
                  "domain",
                  "publishedAt",
                  "authors",
                  "tone",
                  "image",
                  "persons",
                  "organizations",
                  "themes"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "attribution": {
              "type": "string"
            },
            "count": {
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "hours": {
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "lastIngestAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "next": {
              "additionalProperties": false,
              "description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
              "properties": {
                "method": {
                  "enum": [
                    "GET",
                    "POST"
                  ],
                  "type": "string"
                },
                "sample": {
                  "description": "Free fixed sample of the whole family",
                  "type": "string"
                },
                "service": {
                  "description": "Service id of the suggested next paid call",
                  "type": "string"
                },
                "tool": {
                  "description": "MCP tool name of the same call",
                  "type": "string"
                },
                "url": {
                  "description": "Paid route of the next call",
                  "type": "string"
                },
                "useWhen": {
                  "description": "When the next call is the right one",
                  "type": "string"
                }
              },
              "required": [
                "service",
                "tool",
                "method",
                "url",
                "useWhen",
                "sample"
              ],
              "type": "object"
            },
            "query": {
              "type": "string"
         

This page as JSON