Documentation Index
Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt
Use this file to discover all available pages before exploring further.
Workflow
Event and Story list/summary endpoints default to confidence_profile=precise for analyst-ready results. Add confidence_profile=loose only when exhaustive/raw retrieval is required.
# Discover admin1 values
GET /api/v2/geo/admin1?country=United%20States
# Security baseline
GET /api/v2/events/summary?country=United%20States&admin1=District%20of%20Columbia&event_family=conflict&group_by=category&date_start=2026-04-01&date_end=2026-04-17
# Infrastructure and policy Events
GET /api/v2/events?country=United%20States&admin1=District%20of%20Columbia&event_family=cameoplus&domain=INFRASTRUCTURE&sort=significance
# Story evidence
GET /api/v2/stories?country=United%20States&admin1=District%20of%20Columbia&search=security%20infrastructure%20business%20operations&sort=significance
Risk Dimensions
- civil security and protest activity
- infrastructure and logistics reliability
- labor and social stability
- regulatory and political environment
- health and environmental risk
- market, FX, commodity, or sovereign context where relevant
Principle
Low conflict Event volume can be a positive stability signal when the geography and window are otherwise covered. Say that clearly rather than treating every absence as a failure.
Use web research for official local advisories and specialist sources. Use macro-finance for local market context. Use prediction markets for election, policy, or regulatory scenarios where available.
