curl --request GET \
--url https://gdeltcloud.com/api/v2/china/projects/summary \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/china/projects/summary"
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/china/projects/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"group_by": "country",
"data": [
{
"country_iso3": "PAK",
"country": "Pakistan",
"project_count": 142,
"amount_usd_total": 47218900000
},
{
"country_iso3": "AGO",
"country": "Angola",
"project_count": 97,
"amount_usd_total": 42960300000
}
],
"applied_filters": {
"sector": "Energy",
"group_by": "country",
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}China dev-finance rollup
Rollup of China overseas development finance by country, sector, status, commitment year, flow class, or funding intent — counts + total committed USD. Requires a plan with China development finance access (can_use_china) — see Pricing for the plans that include it.
curl --request GET \
--url https://gdeltcloud.com/api/v2/china/projects/summary \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/china/projects/summary"
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/china/projects/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"group_by": "country",
"data": [
{
"country_iso3": "PAK",
"country": "Pakistan",
"project_count": 142,
"amount_usd_total": 47218900000
},
{
"country_iso3": "AGO",
"country": "Angola",
"project_count": 97,
"amount_usd_total": 42960300000
}
],
"applied_filters": {
"sector": "Energy",
"group_by": "country",
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Recipient country filter. Accepts a country name, ISO-2, or ISO-3 via the shared resolveCountryInput layer (comma-separated list allowed; combinable with region/continent); an unresolvable value returns 400 INVALID_COUNTRY.
Sector filter. Observed vocabulary, measured 2026-08-10 (24 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/china/projects/summary?group_by=sector. AidData's OECD-DAC sector name, stored verbatim and matched case-insensitively. Ours to serve, not ours to define — it changes when AidData republishes GCDF. The filter does not validate, so an unlisted sector returns an empty 200. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#china_sector
Project title search (alias q).
Recipient region — expanded to an ISO-3 country set and combinable with country/continent. Same plain-English region vocabulary as the events/stories region filter; an unresolvable value returns 400.
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 Recipient continent — Africa, Asia, Europe, North America, South America, or Oceania.
Africa, Asia, Europe, North America, South America, Oceania Project status, matched case-insensitively (e.g. Completion, Implementation, Pipeline: Commitment). Unknown values return 0 rows rather than a 400. Observed vocabulary, measured 2026-08-10 (6 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/china/projects/summary?group_by=status. AidData's project status. Note the two Pipeline: … values contain a colon and a space — a picker that offers a slugified form will silently match nothing. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#china_status
OECD-style flow class, matched case-insensitively (e.g. ODA-like, OOF-like). Observed vocabulary, measured 2026-08-10 (3 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/china/projects/summary?group_by=flow_class. AidData's ODA-like / OOF-like concessionality class. Unvalidated at the serve layer. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#china_flow_class
Funding intent, matched case-insensitively (e.g. Development, Commercial, Mixed). Observed vocabulary, measured 2026-08-10 (4 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/china/projects/summary?group_by=intent. AidData's donor-intent classification. Unvalidated at the serve layer. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#china_intent
Match a funding agency or co-financier (case-insensitive substring). Alias: funder.
Constant-USD floor on the project amount; 0 is a no-op. Alias: min_amount.
x >= 0When true, restrict to projects that carry geocoordinates.
Minimum commitment year (1990–2035).
1990 <= x <= 2035Maximum commitment year (1990–2035).
1990 <= x <= 2035Minimum project completion year (1990–2050).
1990 <= x <= 2050Maximum project completion year (1990–2050).
1990 <= x <= 2050Bucket dimension. Each row is keyed by the active dimension (see the response schema). Full value list: https://docs.gdeltcloud.com/reference/enums#china_projects_group_by
country, sector, status, year, flow_class, intent Max buckets returned (1–500, default 100), ordered by total committed USD then project count.
1 <= x <= 500