GDELT CloudGDELT Cloud
DATA & SOURCES / API CATALOG

Find your data.
Choose your endpoint.

Start with a data family, then inspect the records and filters. Open a working tool in API Arena when you’re ready to try a request.

See example workflows ↗Explore data & country coverage ↗

1 endpoint matching “/countries/” across all data families

Economics & country risk

Add dated economic observations, geography and country intelligence.

FRED / ALFRED · World Bank · country indicators
GETGet country context/api/v2/countries/{iso3}

Country activity, dated economic/resource fundamentals, facilities and political-office inventories with evidence links. Unknown values remain null. Country association does not imply citizenship or headquarters. Counts of people, office-holder records, facilities and units are qualified separately.

Response: CountryContextCard · MCP tool: get_country

Parameters and accepted values (5)
time_basis
Clock for date/hour filters and ordering: published preserves the serving/reference publication time; recorded uses the durable journal commit time and includes late publications when they become available. Omission retains published compatibility. Choose recorded explicitly for ongoing activity Monitors; source dates remain unchanged.

Accepted values: published, recorded

date_start
First UTC date in the selected time_basis. Defaults to today; future dates are rejected. Neither clock is Event occurrence time.
date_end
Last UTC date in the selected time_basis, inclusive. Defaults to date_start and cannot be later than the current UTC day.
hour
UTC hour selecting a publication bucket. Requires a single date and rejects hours that have not started. The current hour is allowed and describes publications so far; omit for the whole selected day.
basis
publication retains the activity journal clock. reporting uses distinct served Events by occurrence date and location country (country_match=location), and Stories by reporting date under every authoritative country association (the Stories summary country_attribution=all mode). Country buckets may overlap for Stories; totals are computed independently. Reporting has day precision and rejects hour.

UNDERSTAND THE SOURCE

Where the data comes from.

SEC EDGAR ↗

Retrieve SEC filer identity, filing records and evidence-backed company relationships through GDELT Cloud. Connect US registrants to reporting with resolved entity identifiers.

Read the source guideFRED ↗

Use FRED and ALFRED economic series through GDELT Cloud’s macro API. Inspect metadata, dated observations, source attribution and redistribution limits.

Read the source guideGlobal Energy Monitor ↗

Explore Global Energy Monitor facilities through a structured API. Filter by country or proximity, inspect capacity and registry dates, and connect reporting to infrastructure carefully.

Read the source guideSanctions & public records ↗

Inspect original-publisher sanctions and public-record sources through GDELT Cloud. Understand list coverage, entity connections and how MIT-licensed OpenSanctions crawler code is used.

Read the source guide