curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/relations \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/relations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/filings/relations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}Filers that name a company
Relations extracted from SEC filings, read from the counterparty’s side: which filers name a company as a supplier, customer, partner or counterparty, with the filer CIK and name, the accession, the verbatim evidence and the extraction confidence. Each row says how its object was tied to the entity in resolution_source: ingest (the registry id stored at extraction), serve_consensus (the table’s own majority id for that exact object name, as /filings/{cik}/relations reports it) or, only with match=name, name_match. meta.coverage counts each source, reports what the name match checked and withheld, and gives the share of stored relations bound to a registry id by relation kind. Without entity, the counterparty’s country or the commodity selects relations across the 500 filers that filed matching relations most recently; meta.truncation says when that cap applied.
curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/relations \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/relations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/filings/relations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
The named company: a registry e_ id, or a news wiki:/llm: id bridged to the registry. Rows stored under any id that has since merged into it are included. A bare name is refused (INVALID_ENTITY_ID); resolve it first with /api/v2/filings/resolve?q= (its entity_id) or /api/v2/entities?q=. Also accepts: entity_id.
^(?:e_[A-Fa-f0-9]{8,64}|wiki:[A-Fa-f0-9]{8,64}|llm:[A-Fa-f0-9]{8,64})$Relation kinds to read, comma-separated. Omitted: supplier,customer,partner,counterparty. subsidiary reads the filers whose Exhibit 21 lists the company. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_rel_type
subsidiary, supplier, customer, counterparty, partner, jurisdiction_exposure, risk_factor resolved admits relations tied to the entity by a stored registry id or by the table's name consensus. name also admits relations whose unresolved object name equals one of the entity's registry names (after dropping corporate suffixes and a trailing acronym in parentheses) and no other registry entity's. Those rows carry resolution_source: name_match and matched_name; an exact name is evidence, not proof, so read the quote. With match=name: requires entity. a name match needs the entity whose registry names it compares Full value list: https://docs.gdeltcloud.com/reference/enums#filings_relation_match
resolved, name relation: one row per stored relation (a filer can name a company in several filings and sections). filer: one row per filer and relation kind, carrying its most recent, most confident relation plus relation_count, filing_count, first_file_date and last_file_date. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_relation_group_by
relation, filer Counterparty (object) country, comma-separated: a name, ISO-2 or ISO-3 code. Matches the country the extraction recorded for the named company, not the filer's country. Also accepts: country_iso3. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Counterparty region, expanded to its countries and applied like country. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#region
Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean Counterparty continent, expanded to its countries and applied like country. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#continent
Africa, Asia, Europe, North America, South America, Oceania What is supplied, as the extraction recorded it (wafers, memory, crude oil …): a case-insensitive substring of object_commodity, at least 3 characters. Open vocabulary; most customer and partner relations carry none.
^.{3,}$Rows per page (relations, or filers with group_by=filer); page on with cursor.
1 <= x <= 200Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page. Also accepts: offset.