Find your data.
Choose your endpoint.
Start with a data family, then inspect the records and filters. Open a working tool in API Arena when you’re ready to try a request.
2 endpoints matching “/china/” across all data families
Events & news
Discover developments, grouped reporting and the evidence behind them.
GDELT article stream · GDELT Cloud classificationPeople & organizations
Find identities and connect their reporting, hierarchy and public roles.
Resolved identities · GLEIF legal entitiesCompany filings
Retrieve registrants, financial facts and filing-backed business relationships.
SEC EDGAR · XBRLInfrastructure & maritime
Explore sites, energy assets, ports and vessel activity.
Global Energy Monitor · NGA World Port Index · maritime recordsEconomics & country risk
Add dated economic observations, geography and country intelligence.
FRED / ALFRED · World Bank · country indicatorsGETChina dev-finance projects/api/v2/china/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.
Response: success, data, pagination, sort, applied_filters
Parameters and accepted values (18)
- search
- Project title search.
- country
- 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
- sector
- 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
- 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.
Accepted values: 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
- continent
- Recipient continent — expanded to an ISO-3 country set. Accepts Africa, Asia, Europe, North America, South America, or Oceania.
Accepted values: Africa, Asia, Europe, North America, South America, Oceania
- status
- 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
- 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
- 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
- Match a funding agency or co-financier (case-insensitive substring) — the marquee "who funded it" filter. Alias: funder.
- min_amount_usd
- Constant-USD floor on the project amount; 0 is a no-op. Alias: min_amount.
- geocoded_only
- When true, restrict to projects that carry geocoordinates.
- year_min
- Minimum commitment year (1990–2035).
- year_max
- Maximum commitment year (1990–2035).
- completion_year_min
- Minimum project completion year (1990–2050), filtered on completion_year. Symmetric with year_min/year_max (which filter commitment year).
- completion_year_max
- Maximum project completion year (1990–2050), filtered on completion_year.
- sort
- amount_desc | recent. Full value list: https://docs.gdeltcloud.com/reference/enums#china_projects_sort
Accepted values: amount_desc, recent
- limit
- Rows per page.
- cursor
- Pagination cursor (opaque offset).
GETChina dev-finance rollup/api/v2/china/projects/summary
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.
Response: success, group_by, data, applied_filters
Parameters and accepted values (17)
- country
- 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
- 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
- search
- Project title search (alias q).
- region
- 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.
Accepted values: 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
- continent
- Recipient continent — Africa, Asia, Europe, North America, South America, or Oceania.
Accepted values: Africa, Asia, Europe, North America, South America, Oceania
- status
- 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
- 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
- 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
- Match a funding agency or co-financier (case-insensitive substring). Alias: funder.
- min_amount_usd
- Constant-USD floor on the project amount; 0 is a no-op. Alias: min_amount.
- geocoded_only
- When true, restrict to projects that carry geocoordinates.
- year_min
- Minimum commitment year (1990–2035).
- year_max
- Maximum commitment year (1990–2035).
- completion_year_min
- Minimum project completion year (1990–2050).
- completion_year_max
- Maximum project completion year (1990–2050).
- group_by
- 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
Accepted values: country, sector, status, year, flow_class, intent
- summary_limit
- Max buckets returned (1–500, default 100), ordered by total committed USD then project count.
Government & public records
Inspect official lists, political offices and government relationships.
Original publishers · OpenSanctions crawler codeAI & compute
Research models, hardware, data centers and the organizations building them.
Epoch AIMonitors & API tools
Inspect saved monitoring workflows and the API’s supported values and costs.
GDELT CloudUNDERSTAND THE SOURCE
Where the data comes from.
Retrieve SEC filer identity, filing records and evidence-backed company relationships through GDELT Cloud. Connect US registrants to reporting with resolved entity identifiers.
Read the source guideFRED ↗Use FRED and ALFRED economic series through GDELT Cloud’s macro API. Inspect metadata, dated observations, source attribution and redistribution limits.
Read the source guideGlobal Energy Monitor ↗Explore Global Energy Monitor facilities through a structured API. Filter by country or proximity, inspect capacity and registry dates, and connect reporting to infrastructure carefully.
Read the source guideSanctions & public records ↗Inspect original-publisher sanctions and public-record sources through GDELT Cloud. Understand list coverage, entity connections and how MIT-licensed OpenSanctions crawler code is used.
Read the source guide