> ## 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.
# Data catalog
> Every dataset behind the API — what we produce, what we ingest, the licence, the coverage window, and the known gap.
GDELT Cloud sells two different things through one API, and the difference decides how far you should trust a given number.
## Core — Endpoints we produce & fuse
We code the events, cluster the stories, resolve the entities and score the tone. The upstream GDELT article stream is an **input** to that pipeline, not a dataset we resell — every event is re-coded under our own taxonomy and every article re-clustered. Nothing in Core is passed through.
## Open Feeds — Raw open sources we ingest — many fused into Core
Published public registries, ingested and cleaned. We did not create these and we do not claim to; the value we add is that they are **resolved onto the same entity spine as Core**, so one entity id reaches an event, a filing, a sanctions listing and a physical asset. Each row below names its originating authority and its licence.
## Intel — Atlas indices and intelligence products built on the data
Products built on both. Atlas indices are computed from our own coded events; briefs are assembled from whatever the question needs.
Coverage figures were last measured against production on **2026-07-20**. Every limitation below is measured, not estimated — if one stops matching production the number gets fixed, not the wording.
## What we produce
The core datasets are GDELT Cloud’s own output — we code the events, cluster the stories, resolve the entities and score the tone. The raw article stream they are coded from is an input, not a dataset we resell.
| Dataset | Surface | Source | Licence | Coverage | Refresh |
| --------------------------------- | ----------------------------------------------------------------------- | ----------- | ----------- | ------------------------------------------------------------------- | --------------------------------- |
| **Events** | `Core Data · /api/v2/events` | GDELT Cloud | Proprietary | March 2026 → present | Hourly |
| **Conflict events (ACLED-style)** | `Core Data · /api/v2/events` | GDELT Cloud | Proprietary | March 2026 → present | Hourly |
| **Stories** | `Core Data · /api/v2/stories` | GDELT Cloud | Proprietary | March 2026 → present | Hourly |
| **Entities** | `Core Data · /api/v2/entities, /api/v2/search` | GDELT Cloud | Proprietary | March 2026 → present | Hourly, with daily reconciliation |
| **Media tone & share of voice** | `Core Analytics · /api/v2/entity-tone, /api/v2/share-of-voice` | GDELT Cloud | Proprietary | March 2026 → present | Hourly |
| **Atlas geopolitical indices** | `Intelligence · /api/v2/intelligence/gpr, /api/v2/intelligence/posture` | GDELT Cloud | Proprietary | World and continent daily from April 2026; country coverage is thin | Daily |
**Coded from:** GDELT article stream — a raw feed we code from, not a dataset we resell. None of the upstream provider's own derived products is an input.
Every event is coded by GDELT Cloud under our own CAMEO+ taxonomy, not taken from an upstream event feed. History before March 2026 is being backfilled and is incomplete. Event geography is city-level at best — most events resolve to a country or regional centroid, so they should not be treated as point locations.
**Coded from:** GDELT article stream — a raw feed we code from, not a dataset we resell. None of the upstream provider's own derived products is an input.
Independently coded using ACLED’s published methodology and taxonomy. Not sourced from, endorsed by, or affiliated with ACLED, and not comparable row-for-row with ACLED’s own dataset. Beta.
**Coded from:** GDELT article stream — a raw feed we code from, not a dataset we resell. None of the upstream provider's own derived products is an input.
Article clusters we build ourselves. They are re-evaluated as coverage arrives, so a story’s article set can change within its first day.
**Coded from:** GDELT article stream + public registries — a raw feed we code from, not a dataset we resell. None of the upstream provider's own derived products is an input.
Our resolved entity spine, cross-walked to public registry identifiers where they exist. An entity with no registry match resolves on name alone and is weaker, and an unresolvable name returns no match rather than a guess.
**Coded from:** GDELT article stream + Bluesky posts — a raw feed we code from, not a dataset we resell. None of the upstream provider's own derived products is an input.
Scored by us. Tone is measured only where an entity is actually covered — an absent bucket means no measured coverage, never a neutral reading. Evidence is news coverage plus, for some entity-days, recent Bluesky posts. The model reads both in one pass and returns three readings: the blended headline score, plus news\_tone\_score and social\_tone\_score over each source alone. Social is attached only to entities already present in the news stream and never scored alone, but where it is present it is often the majority of the evidence — so read social\_tone\_score against scored\_social\_story\_count, which is usually a small fraction of the scored total. The split is served per story, per day and per language, and it is FORWARD-ONLY: scores written before 2026-08-22 report null for both components rather than a fabricated zero, and cannot be backfilled. Early access.
**Coded from:** Our own coded events and stories — our own output, not an ingested feed.
Experimental. The API and MCP tools are gated on the Intelligence plan (can\_use\_intelligence) — they are no longer Admin-only — but the baseline is provisional because the underlying event history only begins in March 2026. Country-level coverage is the binding limit: measured over 107 days, only 2 countries clear the per-country coverage floor on 90+ days and 12 clear it on most days, so every other country is returned as null rather than a fabricated score. Treat world and continent as usable and country as preview. Not derived from, or comparable to, the Federal Reserve’s published GPR index.
## What we fuse
Multiple public registries joined into one keyed surface and resolved against the entity spine.
| Dataset | Surface | Source | Licence | Coverage | Refresh |
| ------------------------ | -------------------------------- | ------------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------- | --------------------- |
| **Facilities directory** | `Core Data · /api/v2/facilities` | Global Energy Monitor + NGA World Port Index + Epoch AI | CC-BY-4.0 (GEM, Epoch AI) · US Public Domain (NGA) | Power, industry, fuel transport, ports and data centers | On source publication |
About 99% carry coordinates; the remainder are pipelines and oil & gas fields, which are lines and areas rather than points. Roughly half carry an owner resolved to the entity spine — strongest for heavy industry and data centers, weakest for power. Ports carry no owner at all: the World Port Index is a navigational dataset with no ownership layer, so this is a boundary of the source, not a backlog.
## Open feeds we ingest
Public datasets we ingest, clean, and — where the source supports an identifier — resolve onto the same entity spine as everything else.
| Dataset | Surface | Source | Licence | Coverage | Refresh |
| ---------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------- |
| **Federal awards** | `Open Feeds · /api/v2/gov/awards` | [USAspending.gov](https://www.usaspending.gov/) | US Public Domain | Prime awards, keyed on UEI | Weekly |
| **Foreign influence** | `Open Feeds · /api/v2/gov/fara` | [DOJ NSD — FARA eFile](https://efile.fara.gov/) | US Public Domain | Registrant ↔ foreign-principal links | Weekly |
| **Corporate filings** | `Open Feeds · /api/v2/filings` | [SEC EDGAR](https://www.sec.gov/edgar) | US Public Domain | Filing index and XBRL financials | Hourly, within SEC fair-access limits |
| **Legal entities & corporate hierarchy** | `Open Feeds · /api/v2/gleif/*` | [GLEIF — Global LEI Index](https://www.gleif.org/en/lei-data/gleif-golden-copy) | CC0 1.0 (public domain) | LEI reference data (L1), consolidation relationships (L2), and LEI↔ISIN mappings | Daily delta, full swap weekly |
| **AI & compute** | `Open Feeds · /api/v2/epoch/*` | [Epoch AI](https://epoch.ai) | CC-BY-4.0 | Models, hardware, data centers, chip sales | On source publication |
| **Energy assets** | `Open Feeds · /api/v2/energy/*` | [Global Energy Monitor](https://globalenergymonitor.org) | CC-BY-4.0 | Power, fuel transport and heavy-industry trackers | On GEM release |
| **Governance & democracy** | `Structural indicators · powers the Atlas Posture structural axis` | [World Bank (WDI / Worldwide Governance Indicators) + V-Dem Institute](https://www.v-dem.net/data/the-v-dem-dataset/) | CC-BY-4.0 (World Bank) · Open with citation requested (V-Dem) | 176 countries, 1990–2025, annual | On source publication (annual) |
| **Markets & macro** | `Open Feeds · /api/v2/macro/*` | [Federal Reserve Bank of St. Louis (FRED / ALFRED)](https://fred.stlouisfed.org/) | Mixed — per-series; redistribution-restricted series are excluded | Series with true point-in-time vintages | Daily |
| **Restricted-party lists** | `Open Feeds · /api/v2/lists, /api/v2/screening/match` | [trade.gov Consolidated Screening List (OFAC, BIS, State), UN Security Council, UK Sanctions List, US DoD Section 1260H](https://www.trade.gov/consolidated-screening-list) | US Public Domain (CSL, 1260H) · open publication (UN, UK) | 14 lists, with a daily change feed | Daily |
| **Maritime** | `Open Feeds · /api/v2/maritime/*` | NGA World Port Index + terrestrial AIS | US Public Domain (NGA port index) | Ports, chokepoint transits, port dwell, dark-gap detection | Continuous |
| **China development finance** | `Open Feeds · /api/v2/china/*` | [AidData Global Chinese Development Finance](https://www.aiddata.org/) | ODC-By | Commitments through 2021 | On AidData release |
Prime awards only. Sub-award chains are not ingested, so exposure through subcontractors is not represented.
Reflects what registrants filed. Non-registration is not observable, so absence is not evidence of no relationship.
US registrants only — a private or foreign-only company has no EDGAR footprint. Supplier and subsidiary relations extracted from filing text are our interpretation of the document, not statements by the filer.
Hierarchy is accounting consolidation as self-reported to the Global LEI System — not percentage ownership, and it excludes natural persons, so it is not beneficial-ownership data. Coverage is partial: filers may declare a reporting exception instead of naming a parent, and an entity that never registered for an LEI does not appear at all.
Epoch’s data-center registry is a curated set of the largest known clusters, not a census. Coordinates are geocoded from published addresses, not supplied by the source.
Capacity units differ by tracker — power is MW while heavy industry is tonnes per annum — so capacity is not summable across asset classes.
Annual and lagged — V-Dem v16 carries a 2025-03-10 vintage and the World Bank indicators trail by one to two years, so these describe a country’s standing condition and can never move on the news. V-Dem indices are expert-coded survey aggregates with published uncertainty intervals; we store the point estimate only. V-Dem publishes no formal licence — its FAQ grants free use for anyone without permission and asks to be cited, which is how these rows are marked.
Series whose upstream terms restrict redistribution are filtered out of every query rather than served with a caveat. GDELT Cloud is not endorsed or certified by the Federal Reserve Bank of St. Louis. Observations cannot predate 1970.
Analytical coverage, not an audit-grade compliance control — use a compliance-grade provider for screening decisions. Country filtering is derived from address text on the US lists and is not complete; two State Department lists carry no country or address at all and cannot be filtered by geography. A list we do not carry returns an explicit error, never an empty result.
Terrestrial AIS only — no satellite feed — so coverage is strongest near shore and thins in open ocean. Accrues forward from June 2026; there is no history before that date.
A periodic research release, not a live feed. It ends in 2021 and will not reflect anything more recent until AidData publishes again.
## Reaching a feed
Each Open Feed is gated by its own entitlement flag. An endpoint your workspace does not carry returns an explicit error naming the flag it needs — never an empty result, which would be indistinguishable from "there is no data for you". The flag is stated on each family in the [API reference](/api-reference), and the error itself is in the [error reference](/reference/errors).