Global news article search by GDELT — normalized fulltext search across worldwid
Global news article search by GDELT — normalized fulltext search across worldwide media (query syntax: phrases, OR, sourcecountry, theme, tone) returned as a clean snake_case envelope.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
600 msmedian answer time
$0.005listed price per call
$0.005price it asked us
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
GET https://gdelt.use.x402atlas.com/search
| Category | Search and research |
|---|---|
| Provider host | gdelt.use.x402atlas.com |
| Networks | eip155:137, eip155:42161, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
| Payment schemes | exact |
| Self-reported calls, 30 days | 13 from 5 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.005 | 600 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"maxrecords": 75,
"query": "\"supply chain\" (drought OR flood)",
"sort": "HybridRel",
"timespan": "3d"
},
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"maxrecords": {
"default": 75,
"description": "Number of articles to return, capped at 250",
"maximum": 250,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "GDELT query syntax \u2014 phrases, OR, -exclude, domain:, sourcelang:, sourcecountry:, theme:, tone>/<, near",
"maxLength": 1024,
"type": "string"
},
"sort": {
"default": "HybridRel",
"description": "Result ordering",
"enum": [
"DateDesc",
"DateAsc",
"ToneDesc",
"ToneAsc",
"HybridRel"
],
"type": "string"
},
"timespan": {
"default": "3d",
"description": "Relative window like 15min, 1h, 7d, 2w, 3m; capped at 90 days",
"pattern": "^[0-9]+(min|h|d|w|m)$",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"articles": {
"items": {
"properties": {
"domain": {
"type": "string"
},
"language": {
"type": "string"
},
"seen_at": {
"format": "date-time",
"type": "string"
},
"social_image": {
"description": "Article thumbnail URL, when GDELT has one",
"type": "string"
},
"source_country": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url",
"title",
"seen_at",
"domain",
"language",
"source_country"
],
"type": "object"
},
"type": "array"
},
"attribution": {
"description": "Mandatory GDELT licence credit line",
"type": "string"
},
"count": {
"description": "Number of articles returned",
"type": "integer"
},
"note": {
"description": "Present only on a sample response (empty/omitted query): a hint to pass a real query. The paid request ran; no upstream call was made.",
"type": "string"
},
"queried_at": {
"format": "date-time",
"type": "string"
},
"query": {
"description": "Echo of the request query",
"type": "string"
},
"timespan": {
"description": "Echo of the effective timespan",
"type": "string"
}
},
"required": [
"query",
"queried_at",
"timespan",
"count",
"articles",
"attribution"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}