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/fara” across all data families

Government & public records

Inspect official lists, political offices and government relationships.

Original publishers · OpenSanctions crawler code
GETForeign Agents (FARA)/api/v2/gov/fara

US foreign-influence graph — DOJ FARA registrations linking a US registrant (law/lobby/PR firm) to the foreign principal it represents, resolved to the entity spine. Filter by a resolved entity (matches EITHER side of the link), a fuzzy registrant or foreign_principal name, or a country; adversary_only restricts to adversary governments and sanctioned_only to the killer cross — US firms registered as agents for a **sanctioned** entity (the foreign principal is matched to our screening lists — OFAC SDN / BIS Entity / DoD 1260H / OFAC CMIC / UK — with the specific fp_sanction_lists + fp_sanction_programs). At least one filter is required. Plan-gated: requires can_use_gov (Markets plan and up); non-entitled plans receive 403 PLAN_REQUIRED. US Public Domain (DOJ NSD FARA eFile).

Response: query, summary, links, meta, cross_source

Parameters and accepted values (8)
entity
A resolved spine entity id (e_…). Matches the registrant OR the foreign principal side of the link.
registrant
Fuzzy (case-insensitive) US-registrant name match.
foreign_principal
Fuzzy foreign-principal name match.
country
Country/location represented, as published by FARA (upper-case). Observed vocabulary, measured 2026-08-10 (265 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/gov/fara?entity=<id> — read country on each foreign principal. The foreign principal's country AS FARA SPELLS IT — KOREA, SOUTH, MYANMAR (BURMA), GREAT BRITAIN. The country= filter resolves your input to ISO-3 and then matches every stored spelling that maps to it, so you may send an ISO code or an English name; these are the raw values you will see in a response. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#fara_country
adversary_only
Restrict to adversary-government links (RU/CN/IR/KP/SY/CU/VE/BY/MM).
sanctioned_only
Restrict to links whose foreign principal is on a sanctions/restricted list.
active_only
Restrict to still-active registrations (no termination date).
limit
Link rows to return (max 500). Summary aggregates across ALL matching links.

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