{"uid":"cap_qv56e3UtwjepLJuuPzNP2","slug":"gdelt-real-time-world-news-events-dd51fe77","name":"GDELT Real-Time World News Events","description":"World news events from the last 15 minutes, from the GDELT Project's global monitoring of news media: who did what to whom, where, with event type (CAMEO), tone, Goldstein impact score, number of mentions and a source article URL. Filter by country (FIPS code, e.g. NL, US, UK) or keyword in the actors. Use it for real-time situational awareness and risk monitoring.","url":"https://opendata402.com/v1/news/events?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","properties":{"q":{"type":"string","pattern":"^[A-Za-z0-9 '-]{2,40}$","description":"Keyword in actor names."},"limit":{"type":"string","pattern":"^([1-9]|[1-4][0-9]|50)$","description":"Max events (default 20, max 50), sorted by mentions."},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"FIPS 10-4 country code of the event location."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Cl-9eGm2q4SB56ggZeikZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns world news events from the last 15 minutes via GDELT, including who/what/where, CAMEO event type, tone, Goldstein impact score, mention count, and source article URL, filterable by country or actor keyword.","exampleAgentPrompt":"What news events have happened in the last 15 minutes involving Ukraine — show me up to 30, sorted by how many times they've been mentioned, with their CAMEO event type and Goldstein impact scores.","exampleUseCases":[{"title":"Geopolitical risk monitoring by country","prompt":"Pull the latest 15-minute GDELT news events for Iran and tell me which ones have the highest Goldstein impact scores and worst tone — I need a quick risk snapshot."},{"title":"Breaking news situational awareness","prompt":"What are the top 50 world news events from the last 15 minutes, sorted by number of mentions? I want to see who's doing what and where, with source links."},{"title":"Actor-specific news tracking","prompt":"Show me recent global news events from the last 15 minutes where NATO is one of the actors — I'm trying to track any significant developments."}],"resultDescription":"A list of news events from the past 15 minutes sourced from GDELT, each containing actor names (Actor1, Actor2), event location, CAMEO event type code, tone score, Goldstein scale impact score, number of media mentions, and a URL to a source article. Results are sorted by mention count and capped at the requested limit (default 20, max 50).","failureModes":["Invalid FIPS country code returns no results or error","Keyword query with special characters rejected by pattern validation","Limit parameter out of range (>50 or <1) causes validation failure","GDELT upstream data gap during very recent 15-minute window may return sparse results","No events matching narrow keyword/country combination returns empty list"],"whenToPreferThis":"Choose this endpoint when you need real-time (last 15 minutes) structured geopolitical news events with quantified impact metrics (Goldstein score, tone, mention count) and CAMEO event classification. Prefer it over general news search APIs when you need machine-readable event structure, actor extraction, and standardized event coding rather than raw article text. Best for risk monitoring dashboards, geopolitical alerting, and agent workflows that need to react to breaking international events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:38:33.359Z","isFirstParty":false,"canonicalSlug":"gdelt-real-time-world-news-events-dd51fe77"}