← Back to catalog
gdelt.search
mock data$0.001 / callSearch Global News
Search global news articles across 65 languages from 300K+ sources worldwide. Filter by time, language, tone. Returns title, URL, domain, country. 100% free, no auth (GDELT Project)
Input schema
sort
stringSort order: DateDesc (newest), ToneDesc (most positive), HybridRel (relevance)
limit
integerNumber of articles (default 10, max 75)
queryrequired
stringSearch query — keywords, phrases, or boolean (e.g. "climate change", "AI regulation"). Min 3 chars.
language
stringSource language filter (e.g. "english", "spanish", "chinese")
timespan
stringTime window: "15min", "1h", "4h", "1d", "7d", "30d", "3m" (default: all recent)
Call via REST
curl -X POST https://unifyapi.pro/api/call/gdelt.search \
-H "Authorization: Bearer uak_live_..." \
-H "Content-Type: application/json" \
-d '{"sort":"<sort>","limit":0,"query":"<query>","language":"<language>","timespan":"<timespan>"}'