{"uid":"cap_xwyTSCaTi8hVLeYN4k_AW","slug":"gdelt-news-search-via-x402helper-3ead3ff8","name":"GDELT News Search via x402helper","description":"X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.","url":"https://x402helper.xyz/89e509/gdelt/news?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"lang":{"type":"string","default":null,"description":"Source-language filter by name (english, russian, arabic, ...)."},"sort":{"enum":["datedesc","dateasc","relevance","tonedesc","toneasc"],"type":"string","default":null,"description":"Result ordering (default datedesc)."},"limit":{"type":"integer","default":null,"maximum":250,"minimum":1,"description":"Max articles (default 30, GDELT cap 250)."},"query":{"type":"string","default":null,"description":"Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."},"theme":{"enum":["protests","terrorism","conflict","war","inflation","sanctions","trade","elections","corruption","cyber","immigration","refugees","climate","disaster","epidemic","energy","economy","diplomacy","coup","unrest"],"type":"string","default":null,"description":"Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."},"country":{"type":"string","default":null,"description":"Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."},"timespan":{"type":"string","default":null,"description":"Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hEwDXWus8MeFMItsVDdzo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent GDELT news articles filtered by topic, theme, country, language, and timespan, paid via x402 USDC micropayment.","exampleAgentPrompt":"Can you pull up the latest GDELT news articles from the past week about sanctions, filtered to English-language sources, sorted by date descending, and give me up to 50 results?","exampleUseCases":[{"title":"Geopolitical conflict monitoring","prompt":"Fetch me the top 30 GDELT news articles about the 'conflict' theme from the last 3 days, sorted by most recent first."},{"title":"Country-specific election coverage","prompt":"Get me the latest GDELT news about elections coming out of India over the past week, in English, up to 50 articles."},{"title":"Climate disaster news search","prompt":"Search GDELT for recent news about climate disasters from the last month, sorted by relevance, give me up to 100 articles."}],"resultDescription":"A JSON object containing a list of news articles from the GDELT database matching the query parameters, including article metadata such as title, source, date, tone, and URL, along with a success flag.","failureModes":["Missing required 'input' wrapper causes 400 validation error","Exceeding the 250-article limit returns a schema validation error","Invalid country name not mapped to GDELT FIPS code returns empty results or error","Invalid theme enum value causes request rejection","Payment failure or insufficient USDC balance returns 402 Payment Required","Network timeout on GDELT upstream returns 503 or empty result"],"whenToPreferThis":"Choose this endpoint when you need structured, filterable access to GDELT's global news index with support for theme, country, language, and tone sorting — especially when paying per-call via x402 USDC micropayments is acceptable and you want curated theme mappings rather than raw GDELT API access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:52.547Z","isFirstParty":false,"canonicalSlug":"gdelt-news-search-via-x402helper-3ead3ff8"}