Returns a GDELT Entity Graph (GEG) profile for a Wikipedia-linked entity with compact reference cards linking to other API products. Linked stories are cluster reference cards (use media-events/cluster to hydrate). Co-occurrences are entity reference cards (use entity-geg to hydrate). Supports progressive disclosure via the detail parameter: summary (~300 tokens) for compact discovery, standard (~1200 tokens) with more refs + timeline, or full (~1500 tokens, default) with paginated stories + timeline. limit and offset paginate linked story clusters (full detail only).
API key format: gdelt_sk_<64-hex-chars>. Generate in Dashboard → Settings → API Keys.
Entity canonical name in lowercase (e.g. 'donald trump', 'elon musk').
"donald trump"
Entity type.
person, organization Anchor/end date for the lookback window (YYYY-MM-DD). Defaults to today UTC.
"2025-02-20"
Lookback window in days from date. Default 1, max 30.
1 <= x <= 307
Response detail level. summary (~300 tokens): entity basics (name, type, wiki_url, total_articles), 3 story ref cards (cluster_id + label + category + scope + count), 10 co-occ ref cards (name, type, count). No timeline. standard (~1200 tokens): full entity master, 20 story ref cards (+ time_bucket), 25 co-occ ref cards (+ salience, last_seen), timeline. full (~1500 tokens, default): full entity master, paginated story ref cards, 50 co-occ ref cards, timeline.
summary, standard, full Number of linked story clusters to return. Default 10, max 50.
1 <= x <= 50Story cluster pagination offset. Pass offset=10 for page 2.
x >= 010
Advanced filter — omit for best results. GDELT covers global media in 65+ languages; filtering by a single language significantly reduces coverage and is rarely what users want. Only set this when you specifically need single-language sources. Accepts full language name ('English', 'Spanish', 'French') or two-letter ISO-639-1 code ('en', 'es', 'fr', 'ar').
"English"
Filter linked stories by topic category.
conflict_security, politics_governance, crime_justice, economy_business, science_health, disaster_emergency, society_culture, technology Filter linked stories by geographic scope.
local, national, global Success
Entity master record. Summary returns lean subset (name, display_name, wiki_url, type, total_articles); standard/full return all fields.
Compact cluster reference cards. Summary: 3 cards (cluster_id, label, category, scope, count). Standard: 20 cards (+ time_bucket). Full: paginated cards (+ time_bucket). Use media-events/cluster to hydrate any story.
Compact entity reference cards for co-occurring entities. Summary: 10 cards (name, type, count). Standard: 25 cards (+ salience, last_seen). Full: 50 cards (+ salience, last_seen). Use entity-geg to hydrate any entity.
Daily activity timeline (standard/full only). Omitted in summary.