Summarize filings
Rollup of filings by form type, date, or filer — counts + distinct filers. Requires a plan with SEC filings access (can_use_filings) — the Corporate & Supply Chain plan and above.
Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Window start YYYY-MM-DD (≤30-day window).
Window end YYYY-MM-DD.
Anchor date YYYY-MM-DD (use with days).
Trailing N-day window (1–30).
1 <= x <= 30form_type | date | filer.
form_type, date, filer Filter to one or more form types.
10-K, 10-Q, 8-K, 13F-HR, SCHEDULE 13D, SCHEDULE 13G, 3, 4, 5, DEF 14A, S-1, 20-F, 6-K Filer business-address country — name / ISO-2 / ISO-3 / alias, comma-separated. Filters on biz_country_iso2, which is populated for ~45% of filings and is almost entirely US, so non-US values such as CN/JP currently return 0 rows.
Region expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.
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 expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.
Africa, Asia, Europe, North America, South America, Oceania Max buckets returned; pagination.truncated=true when total_buckets exceeds it.
1 <= x <= 500Response
Filing counts bucketed by group_by (form_type | date | filer), highest count first. Each row carries the bucket key (form_type, date, or cik), filings (count) and — except when grouping by filer — filers (distinct CIKs). Envelope: { success, group_by, data, applied_filters }.