# GDELT News Articles by Topic

> GDELT News Articles by Topic is a paid API for AI agents from cycle-angela-lamp-hamburg.trycloudflare.com, paid per call via x402, $0.03/call, status down (last checked 2026-09-15).

Fetches the latest 25 global news articles for a given topic from GDELT, returning title, source, URL, and published time as a JSON array.

## Facts

- Endpoint: GET https://cycle-angela-lamp-hamburg.trycloudflare.com/api/sentiment/news
- Price: $0.03/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gdelt-news-articles-by-topic-0441aadd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cvOzqrOhEmWql7jUEaB9k

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-articles-by-topic-0441aadd
```

Example prompt: Pull the latest global news headlines about the Israel-Gaza conflict from GDELT so I can see what sources and narratives are dominating coverage right now.

## When to prefer this

Use this endpoint when you need a fast, broad sweep of recent global news coverage on any topic, powered by GDELT's near-real-time indexing of thousands of media sources worldwide. Prefer this over social media APIs when you need structured article metadata (title, source, URL, publish time) rather than social posts or sentiment scores. Ideal for narrative monitoring, competitive intelligence, and geopolitical awareness tasks.

## Known failure modes

- No articles found for obscure or misspelled topic — returns no_signals: true
- Missing or empty ?q= parameter may return an error or empty results
- GDELT indexing lag may mean very breaking news is not yet present
- Cloudflare tunnel may be temporarily unavailable, returning 5xx
- Rate limiting or payment failure returns 402 Payment Required

## How this service works

News articles and coverage for a topic: latest global news headlines, source, url, published time from GDELT. JSON array. Pass ?q=<topic>. News narrative monitoring.

## Output

A JSON object containing the queried topic, a boolean no_signals flag if no results found, a unix timestamp of when the payload was built, and an array of up to 25 recent articles each with title, source name, URL, and published datetime — all indexed by GDELT.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topic": {
   "type": "string"
  },
  "articles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "published": {
      "type": "string"
     }
    }
   },
   "description": "latest 25 GDELT-indexed articles"
  },
  "no_signals": {
   "type": "boolean"
  },
  "generated_at": {
   "type": "integer",
   "description": "unix seconds when payload was built"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gdelt-news-articles-by-topic-0441aadd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cycle-angela-lamp-hamburg.trycloudflare.com](https://www.zero.xyz/host/cycle-angela-lamp-hamburg.trycloudflare.com/llms.txt)