Skip to main content
GET
China dev-finance projects

Authorizations

​
Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

​
search
string

Project title search.

​
country
string

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

Example:

"Kenya"

​
sector
string

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

​
region
enum<string>

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.

Available options:
Africa,
Asia,
Middle East,
Northern Africa,
Western Africa,
Eastern Africa,
Middle Africa,
Southern Africa,
Europe,
Eastern Europe,
South Asia,
Southeast Asia,
East Asia,
Central Asia,
North America,
Central America,
Caribbean,
South America,
Oceania
​
continent
enum<string>

Recipient continent — expanded to an ISO-3 country set. Accepts Africa, Asia, Europe, North America, South America, or Oceania.

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
​
status
string

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

​
flow_class
string

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

​
intent
string

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

​
financier
string

Match a funding agency or co-financier (case-insensitive substring) — the marquee "who funded it" filter. Alias: funder.

​
min_amount_usd
integer

Constant-USD floor on the project amount; 0 is a no-op. Alias: min_amount.

Required range: x >= 0
​
geocoded_only
boolean

When true, restrict to projects that carry geocoordinates.

​
year_min
integer

Minimum commitment year (1990–2035).

Required range: 1990 <= x <= 2035
​
year_max
integer

Maximum commitment year (1990–2035).

Required range: 1990 <= x <= 2035
​
completion_year_min
integer

Minimum project completion year (1990–2050), filtered on completion_year. Symmetric with year_min/year_max (which filter commitment year).

Required range: 1990 <= x <= 2050
​
completion_year_max
integer

Maximum project completion year (1990–2050), filtered on completion_year.

Required range: 1990 <= x <= 2050
​
sort
enum<string>

amount_desc | recent. Full value list: https://docs.gdeltcloud.com/reference/enums#china_projects_sort

Available options:
amount_desc,
recent
​
limit
integer
default:25

Rows per page.

​
cursor
string

Pagination cursor (opaque offset).

Response

China dev-finance projects.

​
success
boolean
​
data
object[]
​
pagination
object
​
sort
string
​
applied_filters
object