Deep-dive into a single media event cluster with progressive disclosure. Returns voting articles (top 5 ranked), common entities, and resolved metrics. Supports detail for response size control and filters (actor_country, location, language, domain, category) to explore specific angles of a story. Pass the same date and days used in the discovery call for efficient partition-scoped queries.
API key format: gdelt_sk_<64-hex-chars>. Generate in Dashboard → Settings → API Keys.
The cluster ID to fetch (from a media-events response).
Anchor/end date (YYYY-MM-DD). Should match the date used in the media-events discovery call. Defaults to today UTC.
"2025-02-27"
Lookback window in days from date. Should match the days used in the media-events discovery call. Default 1.
1 <= x <= 30Response detail level. summary (~500 tokens): voting articles (URL, title, domain, date, geo) + top 10 common entities + resolved metrics. standard (~1500 tokens): adds event metrics/actors, top 5 entities per voting article, paginated additional articles. full (~3000+ tokens): all entities per voting article, top 10 per paginated article, quad_classes.
summary, standard, full ISO-3 code to filter articles by actor nationality (e.g. 'CHN' to see how China is involved).
"CHN"
FIPS 2-letter code to filter articles by event geo location (e.g. 'IR' for Iran).
"IR"
ISO 639-1 code to filter articles by source language (e.g. 'en', 'fr', 'ar').
"en"
Filter articles to a specific source domain.
"reuters.com"
Filter articles by topic category.
conflict_security, politics_governance, crime_justice, economy_business, science_health, disaster_emergency, society_culture, technology Number of additional articles beyond voting articles (standard/full only). Default 10.
1 <= x <= 50Pagination offset for additional articles (standard/full only).
x >= 0Success
CAMEO metrics resolved from top-ranked voting articles.
Top 5 ranked articles. Shape depends on detail level.
Top GEG entities across voting articles (10 in summary, 20 in standard, all in full).
Paginated additional articles beyond the top 5 voting articles (standard/full only). Each article includes source URL, title, domain, date, and enrichment data depending on detail level.