Skip to main content
GET
China dev-finance rollup

Authorizations

Authorization
string
header
required

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

Query Parameters

country
string

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
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

Project title search (alias q).

region
enum<string>

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.

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 — 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). 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

flow_class
string

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

intent
string

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

financier
string

Match a funding agency or co-financier (case-insensitive substring). 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).

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

Maximum project completion year (1990–2050).

Required range: 1990 <= x <= 2050
group_by
enum<string>
default:country

Bucket 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

Available options:
country,
sector,
status,
year,
flow_class,
intent
summary_limit
integer
default:100

Max buckets returned (1–500, default 100), ordered by total committed USD then project count.

Required range: 1 <= x <= 500

Response

China dev-finance rollup.

success
boolean
group_by
string
data
object[]
applied_filters
object