curl --request GET \
--url https://gdeltcloud.com/api/v2/china/projects \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/china/projects"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"project_id": "61576",
"title": "China Eximbank Provides $3.6 Billion Loan for Coca Codo Sinclair Hydroelectric Project",
"country": "Ecuador",
"country_iso3": "ECU",
"region": "Americas",
"sector": "Energy",
"status": "Completion",
"flow_type": "Loan",
"flow_class": "ODA-like",
"intent": "Development",
"commitment_year": 2010,
"completion_year": 2016,
"amount_usd_constant": 2245100000,
"amount_usd_nominal": 1682700000,
"funders": [
"Export-Import Bank of China"
],
"co_financiers": [],
"lat": -0.130556,
"lon": -77.535833,
"geo_precision": "point",
"source_urls": [
"https://www.celec.gob.ec/cocacodosinclair/",
"https://www.reuters.com/article/ecuador-china-dam-idUSL1N1V40QJ"
]
},
{
"project_id": "58921",
"title": "China Development Bank Provides $1.5 Billion Loan for Mombasa-Nairobi Standard Gauge Railway (Phase 1)",
"country": "Kenya",
"country_iso3": "KEN",
"region": "Africa",
"sector": "Transport and Storage",
"status": "Completion",
"flow_type": "Loan",
"flow_class": "OOF-like",
"intent": "Mixed",
"commitment_year": 2014,
"completion_year": 2017,
"amount_usd_constant": 1612400000,
"amount_usd_nominal": 1500000000,
"funders": [
"China Development Bank"
],
"co_financiers": [
"Export-Import Bank of China"
],
"lat": -1.292066,
"lon": 36.821946,
"geo_precision": "ADM1",
"source_urls": [
"https://www.krc.co.ke/standard-gauge-railway/"
]
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": "25"
},
"sort": "amount_desc",
"applied_filters": {
"financier": "China Development Bank",
"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 projects
China overseas development-finance projects (AidData GCDF) — amounts, sector, status, financiers; joinable to the live event stream by country. 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 \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/china/projects"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"project_id": "61576",
"title": "China Eximbank Provides $3.6 Billion Loan for Coca Codo Sinclair Hydroelectric Project",
"country": "Ecuador",
"country_iso3": "ECU",
"region": "Americas",
"sector": "Energy",
"status": "Completion",
"flow_type": "Loan",
"flow_class": "ODA-like",
"intent": "Development",
"commitment_year": 2010,
"completion_year": 2016,
"amount_usd_constant": 2245100000,
"amount_usd_nominal": 1682700000,
"funders": [
"Export-Import Bank of China"
],
"co_financiers": [],
"lat": -0.130556,
"lon": -77.535833,
"geo_precision": "point",
"source_urls": [
"https://www.celec.gob.ec/cocacodosinclair/",
"https://www.reuters.com/article/ecuador-china-dam-idUSL1N1V40QJ"
]
},
{
"project_id": "58921",
"title": "China Development Bank Provides $1.5 Billion Loan for Mombasa-Nairobi Standard Gauge Railway (Phase 1)",
"country": "Kenya",
"country_iso3": "KEN",
"region": "Africa",
"sector": "Transport and Storage",
"status": "Completion",
"flow_type": "Loan",
"flow_class": "OOF-like",
"intent": "Mixed",
"commitment_year": 2014,
"completion_year": 2017,
"amount_usd_constant": 1612400000,
"amount_usd_nominal": 1500000000,
"funders": [
"China Development Bank"
],
"co_financiers": [
"Export-Import Bank of China"
],
"lat": -1.292066,
"lon": 36.821946,
"geo_precision": "ADM1",
"source_urls": [
"https://www.krc.co.ke/standard-gauge-railway/"
]
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": "25"
},
"sort": "amount_desc",
"applied_filters": {
"financier": "China Development Bank",
"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
Project title search.
Recipient country. Accepts a country name (Kenya), ISO-2 (KE), or ISO-3 (KEN) via the shared resolveCountryInput layer (comma-separated list allowed; combinable with region/continent). Alias recipient_country is accepted; an unresolvable value returns 400 INVALID_COUNTRY. Full value list: https://docs.gdeltcloud.com/reference/enums#country
"Kenya"
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
Recipient region — expanded to an ISO-3 country set and combinable with country/continent. Accepts the same plain-English region vocabulary as the events/stories region filter (e.g. Africa, East Asia, South America); 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 — expanded to an ISO-3 country set. Accepts 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, Suspended, Cancelled). An unknown value returns 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, Vague (Official Finance)). Unknown values return 0 rows. 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, Representational, Mixed). Unknown values return 0 rows. 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) — the marquee "who funded it" filter. 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), filtered on completion_year. Symmetric with year_min/year_max (which filter commitment year).
1990 <= x <= 2050Maximum project completion year (1990–2050), filtered on completion_year.
1990 <= x <= 2050amount_desc | recent. Full value list: https://docs.gdeltcloud.com/reference/enums#china_projects_sort
amount_desc, recent Rows per page.
Pagination cursor (opaque offset).