# GDELT News Intelligence API — Translingual News Search

> GDELT News Intelligence API — Translingual News Search is a paid API for AI agents from gdelt-x402-api.planbdj.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Fetches global news articles on a topic aggregated by language, sourced from GDELT, organized into per-language buckets with metadata

## Facts

- Endpoint: POST https://gdelt-x402-api.planbdj.workers.dev/news/translingual
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gdelt-news-intelligence-api-translingual-news-search-9007794d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_120NnZCXjTPQNxBlYMWI0

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 gdelt-news-intelligence-api-translingual-news-search-9007794d -d '<json body>'
```

Example prompt: Search for global news articles about 'AI regulation' from the past 48 hours, grouped by language, so I can see how different countries are covering the topic.

## When to prefer this

Choose this endpoint when you need news articles segmented by language and need cross-lingual or translingual perspective on a topic — especially for international affairs, geopolitical events, or policy topics where different language communities may have distinct coverage. Prefer this over a single-language news API when the user wants to understand global media reactions or compare reporting across countries. It is particularly useful for AI agents doing multilingual media monitoring or cross-border topic research.

## Known failure modes

- Topic query returns no results if GDELT has no recent indexed articles for that term
- Sentiment scores may be null if GDELT did not compute them for a given article
- Image URLs may be null for many articles as GDELT does not always index images
- Payment failure via x402 if USDC balance on Base mainnet is insufficient
- High-volume or very broad topic queries may return incomplete coverage due to GDELT indexing lag
- Rate of GDELT data freshness varies; breaking news may not appear immediately

## How this service works

AI-friendly JSON API for global news intelligence. Built on GDELT (free public source), optimized for AI agents — clean responses, 5 use-case endpoints, parallel-aggregated entity graphs, no rate limits, no API keys. Pay-per-query in USDC on Base mainnet via x402.

## Output

A JSON object containing the queried topic, a timespan in hours, and an array of language buckets — each bucket includes the language name, article count, and a list of articles with URL, title, source name, language label, image URL (nullable), publication timestamp, source country code, and sentiment score (nullable).

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "topic"
     ],
     "properties": {
      "hours": {
       "type": "integer",
       "maximum": 72,
       "minimum": 1,
       "description": "Lookback window in hours (default 24, max 72)"
      },
      "topic": {
       "type": "string",
       "description": "Search query"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "topic",
      "timespan_hours",
      "by_language"
     ],
     "properties": {
      "topic": {
       "type": "string"
      },
      "by_language": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "language",
         "article_count",
         "articles"
        ],
        "properties": {
         "articles": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "url": {
             "type": "string"
            },
            "title": {
             "type": "string"
            },
            "source": {
             "type": "string"
            },
            "language": {
             "type": "string"
            },
            "image_url": {
             "type": [
              "string",
              "null"
             ]
            },
            "published_at": {
             "type": [
              "string",
              "null"
             ]
            },
            "first_seen_at": {
             "type": [
              "string",
              "null"
             ]
            },
            "source_country": {
             "type": "string"
            },
            "sentiment_score": {
             "type": [
              "number",
              "null"
             ]
            }
           }
          }
         },
         "language": {
          "type": "string"
         },
         "article_count": {
          "type": "int
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "topic": "AI regulation",
  "by_language": [
   {
    "articles": [
     {
      "url": "...",
      "title": "...",
      "source": "...",
      "language": "English",
      "image_url": null,
      "published_at": "...",
      "source_country": "US",
      "sentiment_score": null
     }
    ],
    "language": "English",
    "article_count": 12
   }
  ],
  "timespan_hours": 48
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gdelt-news-intelligence-api-translingual-news-search-9007794d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gdelt-x402-api.planbdj.workers.dev](https://www.zero.xyz/host/gdelt-x402-api.planbdj.workers.dev/llms.txt)