{"uid":"cap_fYPIW9nkSsBVWB_QvVib7","slug":"gdelt-pulse-09a3bb5e","name":"GDELT Pulse","description":"Fusion intelligence for a world topic in ONE call: recent articles + coverage breakdowns (top source-countries, domains, languages) + a tone trend with the current average tone and direction — all normalized and cited. Saves 4-5 separate GDELT calls and their parsing. Research latency, not real-time trading.","url":"https://payai.agentstools.dev/gdelt/pulse","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"lang":{"type":"string","description":"Source-language filter by name (english, russian, arabic, ...)."},"limit":{"type":"integer","maximum":250,"minimum":1,"description":"Max articles in the fusion (default 30, GDELT cap 250)."},"query":{"type":"string","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","description":"Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."},"country":{"type":"string","description":"Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."},"timespan":{"type":"string","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":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kvqD2cI4TgOOXnZUPHexD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches fused GDELT intelligence for a world topic in one call: recent articles, coverage breakdowns by country/domain/language, and tone trend with direction.","exampleAgentPrompt":"Pull the GDELT pulse on 'Gaza ceasefire' for the past week — I want recent articles, the top source countries and domains covering it, and whether the media tone is trending more positive or negative.","exampleUseCases":[{"title":"Geopolitical conflict media briefing","prompt":"Give me a GDELT pulse on the Russia-Ukraine war for the past 3 days — show me the top countries and languages covering it, the most active domains, and whether the overall tone is getting better or worse."},{"title":"Election coverage sentiment monitor","prompt":"What does global media coverage look like for the 2024 US elections right now? Pull GDELT articles for the last 24 hours, break down the top source countries and domains, and tell me the current tone and which direction it's trending."},{"title":"Crisis theme tone trend analysis","prompt":"Use GDELT to check coverage of the 'terrorism' theme this week — I want to see the top source countries, major domains reporting on it, and whether the average media tone has been getting more negative or positive over time."}],"resultDescription":"A single normalized JSON response containing: a list of recent GDELT articles (titles, URLs, sources, dates), coverage breakdowns by top source countries, domains, and languages (with share percentages), and a tone trend object with the current average GDELT tone score and its directional movement (rising/falling/stable) — all cited and pre-parsed from 4-5 underlying GDELT API calls.","failureModes":["No articles found for the query/theme/country combination in the requested timespan — returns empty result set","Invalid or unsupported country name that cannot be mapped to a GDELT FIPS 10-4 code — returns 400-level error","GDELT upstream unavailability or rate limiting causing delayed or partial responses","Query too broad returning low-signal noise across many unrelated articles","Timespan too narrow (e.g. 15min) for low-volume topics returning insufficient data for tone trend"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, pre-fused GDELT intelligence snapshot for a topic in a single call — saving the overhead of making and parsing 4-5 separate GDELT API requests. Ideal for research agents, journalism tools, geopolitical dashboards, and briefing generators that need articles + coverage geography + sentiment trend together. Not suitable for real-time trading signals or sub-minute latency requirements; use direct GDELT streaming for those.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:55:16.797Z","isFirstParty":false}