{"uid":"cap_IpjMlJxFVaTxz6rbcYkco","slug":"gdelt-geographic-news-intelligence-location-mentions-by-topic-d22e5a0d","name":"GDELT Geographic News Intelligence — Location Mentions by Topic","description":"AI-friendly JSON API for global news intelligence. Built on GDELT (free public source), optimized for AI agents — clean responses, 5 use-case endpoints, parallel-aggregated entity graphs, no rate limits, no API keys. Pay-per-query in USDC on Base mainnet via x402.","url":"https://news-x402.com/news/geographic","method":"POST","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":["topic"],"properties":{"topic":{"type":"string","description":"Search query"},"timespan":{"type":"string","description":"Time window (default 24h)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["topic","timespan","locations"],"properties":{"topic":{"type":"string"},"timespan":{"type":"string"},"locations":{"type":"array","items":{"type":"object","required":["name","lat","lng","mention_count"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"},"name":{"type":"string"},"country_code":{"type":"string"},"mention_count":{"type":"integer"}}}}}}}}}},"responseSchema":{"type":"json","example":{"topic":"earthquake","timespan":"24h","locations":[{"lat":37.09,"lng":-95.71,"name":"United States","country_code":"","mention_count":42}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"topic":"artificial intelligence","timespan":"24h"}}},"response":{"topic":"artificial intelligence","timespan":"24h","locations":[]}},"exampleRequest":{"topic":"artificial intelligence","timespan":"24h"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_maW-VJdwh42GJ8ULBP-wd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of geographic locations (with coordinates and mention counts) where a given news topic is being discussed, drawn from global GDELT news data.","exampleAgentPrompt":"Show me which locations around the world are being mentioned most in news about wildfires over the last 24 hours — give me place names, coordinates, and how many times each was mentioned.","exampleUseCases":null,"resultDescription":"A JSON object containing the original topic, the timespan used, and an array of location objects — each with a place name, latitude, longitude, optional country code, and an integer mention count indicating how frequently that location appeared in matching news articles.","failureModes":["Missing required 'topic' query parameter returns a 400/422 error","Very niche or misspelled topic returns an empty locations array","Payment not received or malformed x402 payment header results in 402 Payment Required","Invalid timespan format may fall back to default 24h or return an error","GDELT source data lag may mean very recent events (< 15 min) are not yet indexed"],"whenToPreferThis":"Use this endpoint when you need to understand the geographic spread or hotspots of news coverage for a specific topic — e.g., mapping where a crisis, event, or keyword is being reported. Prefer this over general news search endpoints when the output you need is location-centric (coordinates, country, mention volume) rather than article headlines or entity lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:32:39.755Z","isFirstParty":false}