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 “/gov/awards” across all data families

Government & public records

Inspect official lists, political offices and government relationships.

Original publishers · OpenSanctions crawler code
GETFederal Awards (USAspending)/api/v2/gov/awards

US federal award exposure for an entity — USAspending prime awards (contracts + grants) resolved to the entity spine. Look a subject up three ways (at least one is required): a resolved spine entity_id (entity=), a SAM.gov Unique Entity Identifier (uei=), or a fuzzy recipient name (recipient=). Returns an aggregate summary (total obligated USD, award + recipient counts) with a per-UEI recipient_rollups breakdown (top 25 by obligated USD, each with its awarding agencies and first/last action dates), plus the recent awards timeline — every row cited to its USAspending permalink. **D&B carve-out:** keyed on the SAM.gov UEI only — Dun & Bradstreet's DUNS number and corporate-family (parent) tree are never ingested or surfaced. Plan-gated: requires the can_use_gov entitlement (Markets plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Reads are bounded key-prefix lookups on the current award snapshot (no all-time scan).

Response: query, summary, awards, meta, cross_source

Parameters and accepted values (4)
entity
A resolved spine entity id (e_… / wiki:… / cik:…). A bare name is rejected with 400 INVALID_ENTITY_ID — resolve it first via GET /api/v2/search. Returns that entity's federal awards.
uei
A SAM.gov Unique Entity Identifier (12-char). Case-insensitive.
recipient
Fuzzy (case-insensitive substring) recipient-name match — no id required.
limit
Award-timeline rows to return (max 500). The summary and recipient_rollups aggregate across ALL matching awards regardless of this cap.

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