Back to Browse
GDELT News Intelligence API — Entity Graph
x402
GDELT News Intelligence API — Entity Graph is a paid API for AI agents from news-x402.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).
Returns an entity-centric graph of news coverage for a named person, organization, or location, including sentiment trend, top sources, and geographic mention distribution over a configurable time window.
Price / call$0.05
Success—
StatusUnknown
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 entity name, timespan, a chronological sentiment trend array (date + avg_tone scores), a ranked list of top news source domains with mention counts, and a list of top geographic locations with coordinates and mention counts.
Example use cases
Example prompt
“Pull up the GDELT entity graph for Elon Musk over the last 7 days — I want to see sentiment trends, which news outlets are covering him most, and where in the world the coverage is coming from.”
Technical details
Endpoint
POSThttps://news-x402.com/news/entity-graphWhen to prefer
Use this endpoint when you need a structured, aggregated view of how a specific named entity (person, org, or place) is covered across global news, including geographic spread and sentiment over time. Prefer this over raw news search when you want parallel-aggregated entity graphs rather than individual articles. Especially useful for monitoring reputation, tracking geopolitical coverage, or feeding downstream analysis pipelines.
Side effects
- Missing required 'entity' query parameter — returns 400 or validation error
- Entity name too ambiguous or not found in GDELT — returns empty arrays or minimal results
- Invalid timespan format — defaults to 7d or returns error
- Payment not completed via x402/USDC — returns 402 Payment Required
- GDELT upstream data delay — results may lag real-time by minutes to hours
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"entity": "Elon Musk",
"timespan": "7d",
"top_sources": [
{
"domain": "ft.com",
"mention_count": 12
}
],
"top_locations": [
{
"lat": 37.09,
"lng": -95.71,
"name": "United States",
"country_code": "",
"mention_count": 30
}
],
"sentiment_trend": [
{
"date": "2026-04-30T00:00:00",
"avg_tone": -1.5
}
]
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"