Skip to main content
GET
SearchGdeltDocuments

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

query
string
required

Search query string.

max_records
integer<int32>

Maximum number of articles to return. Defaults to 10 when omitted or <= 0. The handler caps returned results at 20, so values above 20 (though accepted, up to the validation limit of 250) still return at most 20 articles.

timespan
string

Time span filter (e.g., "15min", "1h", "24h"). Accepted but currently ignored; no-op until this handler supports the parameter.

tone_filter
string

Tone filter appended to query (e.g., "tone>5" for positive, "tone<-5" for negative). Left empty to skip tone filtering. Accepted but currently ignored; no-op until this handler supports the parameter.

sort
string

Sort mode: "DateDesc" (default), "ToneDesc", "ToneAsc", "HybridRel". Accepted but currently ignored; no-op until this handler supports the parameter.

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

SearchGdeltDocumentsResponse contains GDELT article search results.

articles
object[]
query
string

Echo of the search query.

error
string

Error message if the search failed.