Skip to main content
GET
cURL

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
entity_id
string
required

Entity ID returned by Search Entities or an entity_refs array. Wikipedia URLs are valid IDs and must be URL-encoded.

Query Parameters

​
date_start
string<date>

Inclusive start date in YYYY-MM-DD, matched against the event or story date. Alias start_date is accepted for compatibility. Omit dates for the default recent window; explicit windows may not exceed 30 days.

Example:

"2026-04-11"

​
date_end
string<date>

Inclusive end date in YYYY-MM-DD, matched against the event or story date. Alias end_date is accepted for compatibility. Omit dates for the default recent window; explicit windows may not exceed 30 days.

Example:

"2026-04-17"

​
limit
integer
default:10

Number of linked records to return.

Required range: 1 <= x <= 50
Example:

10

​
include_images
boolean
default:true

Set false to skip best-effort Wikipedia thumbnail/avatar enrichment.

​
include_tone
boolean
default:false

Admin/internal preview: include cached Entity Tone coverage when available. Missing tone returns entity_tone.tone_status = not_available and should not be interpreted as neutral.

​
include_registry
boolean
default:false

Overlay the canonical registry sections (SEC filings / energy / screening / China) on the entity profile. Plan-gated (no admin bypass): requires a plan carrying registry access (can_use_filings, can_use_screening, can_use_china, or can_use_exposure), otherwise returns 403 PLAN_REQUIRED. Legacy bundled flag — prefer the per-source sources map, where each section is gated by its own plan flag.

Response

Entity detail

​
success
enum<boolean>
Available options:
true
​
data
object

One canonical Entity, deduplicated by Wikipedia URL across raw_name variants on the public list surface. Low-quality matches (disambiguation pages, common nouns, extraction artifacts) are filtered server-side. GDELT-derived per-article metrics (mention_count, avg_salience) are not part of the public contract — story_count, article_count, and event_count are the canonical activity signals. Entity detail can include cached Entity Tone metadata when include_tone=true; missing tone is reported as not_available, not neutral.