Api Endpoint

d21 news_search

News Search ($0.009): multi-language, multi-country news headline search plus an optional volume/tone timeline, built entirely on the GDELT Project's free, keyless DOC 2.0 API (100+ languages, updated every 15min). Body { query } required; optional timespan (1h..3m), language, country, domain filters, min_tone/max_tone, sort (date|relevance), max_records (1-50). Pass mode:"timeline" for a per-period volume+tone series instead of an article list. Headlines/URLs/metadata only -- never relays…

Open interactive test console

Offering

Provider
draconic21-x402-api.onrender.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Web Search Research
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://draconic21-x402-api.onrender.com/v1/news_search
MIME type
application/json
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
News, headlines, gdelt, Search, media-monitoring

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.009 USDC
Atomic price: 9000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.009 USDC
Atomic price: 9000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "9000",
    "payTo": "0x1520Ef5530AA71350049BE2903Cf078B38c40AE5"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "9000",
    "payTo": "6mc4GhWFyNcMh7gAVDWrKeYjDqFtEKWKQuZ9RTw2VkfM"
  }
]

Observed health

Status
Healthy
Latest latency
131 ms
Average latency
375 ms
HTTP status
204
Last checked
Reachability
100% over 8 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "POST"
      ]
    },
    "bodyType": {
      "type": "string",
      "enum": [
        "json",
        "form-data",
        "text"
      ]
    },
    "body": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Search query, e.g. 'bitcoin etf'. Required."
        },
        "mode": {
          "type": "string",
          "enum": [
            "articles",
            "timeline"
          ],
          "description": "Default 'articles' (deduped headline list). 'timeline' returns a volume+avg-tone series instead."
        },
        "timespan": {
          "type": "string",
          "enum": [
            "1h",
            "6h",
            "12h",
            "1d",
            "2d",
            "3d",
            "1w",
            "2w",
            "1m",
            "3m"
          ],
          "description": "Lookback window. Default '1d'."
        },
        "language": {
          "type": "string",
          "description": "GDELT source-language name, single token, e.g. 'english', 'spanish'. Optional."
        },
        "country": {
          "type": "string",
          "description": "GDELT source-country name, single token, e.g. 'unitedstates'. Optional."
        },
        "domain": {
          "type": "string",
          "description": "Restrict to one publishing domain, e.g. 'nytimes.com'. Optional."
        },
        "min_tone": {
          "type": "number",
          "description": "Only articles with GDELT tone above this value (-100..100). Optional."
        },
        "max_tone": {
          "type": "number",
          "description": "Only articles with GDELT tone below this value (-100..100). Optional."
        },
        "sort": {
          "type": "string",
          "enum": [
            "date",
            "relevance"
          ],
          "description": "articles mode only. Default 'date'."
        },
        "max_records": {
          "type": "integer",
          "description": "articles mode only, 1-50. Default 20."
        }
      },
      "required": [],
      "additionalProperties": true
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object",
      "properties": {
        "mode": {
          "type": "string",
          "enum": [
            "articles",
            "timeline"
          ]
        },
        "articles": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "domain": {
                "type": "string"
              },
              "seen_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "language": {
                "type": "string"
              },
              "source_country": {
                "type": "string"
              },
              "image": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "article_count": {
          "type": "integer"
        },
        "points": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "volume_pct": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "avg_tone": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        },
        "caveats": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "mode",
        "caveats"
      ]
    }
  },
  "required": [
    "type"
  ]
}