> ## 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.

# Plans & Data Modules

> Which plan unlocks which data module, and what a 403 PLAN_REQUIRED means.

GDELT Cloud plans are packaged around **use-cases**. Every plan includes the core data — stories, coded events (CAMEO+/ACLED), resolved entities, and Global Energy Monitor assets — and higher plans add **data modules** on top. Current prices and limits always live on the [pricing page](https://gdeltcloud.com/pricing); this page documents how module access maps to the API.

## Data modules

| Module                         | What it unlocks                                                                                                                                      | API surface                                                                                                      |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Media Intelligence**         | Entity tone (API) + Share of Voice against a custom peer set                                                                                         | `/api/v2/entity-tone*`, `/api/v2/entities/{id}/tone`, `/api/v2/share-of-voice`, `include_entity_tone` on stories |
| **SEC Filings**                | SEC EDGAR filings, XBRL financials, AI-extracted corporate relations (subsidiaries / suppliers / customers)                                          | `/api/v2/filings*`                                                                                               |
| **Maritime**                   | AIS chokepoint transit activity, dwell time, AIS-dark gaps + energy-asset overlays                                                                   | `/api/v2/maritime/*`                                                                                             |
| **Markets & Macro**            | Point-in-time FRED/ALFRED series; Epoch AI compute, data centers, chip sales                                                                         | `/api/v2/macro/*`, `/api/v2/epoch/*`                                                                             |
| **Facilities**                 | Unified physical-asset directory — GEM energy assets + World Port Index ports + Epoch AI data centers on one keyed surface, resolved to spine owners | `/api/v2/facilities*`                                                                                            |
| **Risk Context** (best-effort) | Screening-list context, ownership exposure lenses, China-Abroad development finance                                                                  | `/api/v2/screening/match`, `/api/v2/exposure`, `/api/v2/lists*`, `/api/v2/china/*`                               |

<Note>
  **Risk Context is reference context, not a compliance product.** Matches are cited, best-effort signals — not a compliance determination, not a system of record, and not legal advice. See the [methodology](https://gdeltcloud.com/methodology) for provenance and appropriate-use boundaries.
</Note>

## Which plans include which capabilities

Plans are a **strict ladder** — each tier includes everything below it — and they are grouped the same
way the [API Arena](https://gdeltcloud.com/api-arena) groups endpoints: what we produce, then what we
ingest and fuse, then what we derive.

| Plan         | \$/mo  | QU/mo   | Core Data | Core Analytics | Open Feeds | Intel |
| ------------ | ------ | ------- | --------- | -------------- | ---------- | ----- |
| Free         | 0      | 100     | ✓         | —              | —          | —     |
| Builder      | 79     | 2,500   | ✓         | —              | —          | —     |
| Analyst      | 299    | 20,000  | ✓         | ✓              | —          | ✓     |
| Intelligence | 899    | 100,000 | ✓         | ✓              | ✓          | ✓     |
| Enterprise   | custom | custom  | ✓         | ✓              | ✓          | ✓     |

* **Core Data** — coded events, clustered stories, resolved entities, energy & heavy-industry assets,
  and the fused facilities directory. Included on every tier, including Free.
* **Core Analytics** — cross-language media tone and Share of Voice.
* **Open Feeds** — government exposure (USAspending + FARA), SEC filings, AI & compute (Epoch AI),
  markets & macro (FRED/ALFRED), risk & screening (OFAC/BIS, AidData), and maritime AIS.
* **Intel** — Monitoring Briefs, alerts, the research agent, and Atlas indices.
* **Enterprise** additionally unlocks point-in-time (`as_of`) data, custom QU and request-rate limits,
  and per-contract seat counts.

<Note>
  **Sizing QU.** Our data refreshes **hourly**, so keeping one entity, topic or query current costs about
  **750 QU/month** — polling faster returns the same answer. Divide a plan's QU by 750 for the number of
  things you can keep current (\~3 on Builder, \~27 on Analyst, \~137 on Intelligence). Briefs are metered
  separately and never draw down query units.
</Note>

<Note>
  **Retired tiers.** Monitor, Media Intelligence, Corporate & Supply Chain and Global Intelligence are no
  longer sold. Existing subscribers keep their plan, price and every feature — these tiers continue to
  resolve exactly as before, and the à-la-carte module storefront has been retired in favour of the
  bundled ladder above.
</Note>

## How gating behaves in the API

* Every `/api/v2` route authenticates with your API key and evaluates your plan's module flags. Calling a module endpoint without the module returns **`403`** with `code: "PLAN_REQUIRED"` and a message naming the module. Your key is not blocked — non-module endpoints keep working.
* **MCP inherits the same gates.** MCP tools call the same `/api/v2` routes with your API key, so tool availability follows your plan automatically.
* Entity pages and `/api/v2/entities/{id}` return a per-source `sources` map: sources your plan includes report real availability; others return a uniform locked state.
* Share of Voice requests are bounded for reliability: at most **25 entities** per request and a **92-day** window (`ENTITY_LIMIT_EXCEEDED` / `WINDOW_TOO_LARGE` otherwise).

## Rate limits and metering

Query Units (QU) meter usage: 1 QU per REST/MCP call, 5 QU per in-app Agent tool call. Each plan carries a monthly QU allowance, per-minute rate limit (RPM), alert and Brief allowances — see [pricing](https://gdeltcloud.com/pricing) for current numbers. Briefs meter separately in Brief Units and never draw down QU.