curl "https://gdeltcloud.com/api/v2/entities/https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FExample" \
-H "Authorization: Bearer $GDELT_API_KEY"import requests
url = "https://gdeltcloud.com/api/v2/entities/{entity_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/entities/{entity_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"id": "https://en.wikipedia.org/wiki/United_Nations",
"url": "https://gdeltcloud.com/entities/e_united_nations",
"name": "United Nations",
"type": "organization",
"wikipedia_url": "https://en.wikipedia.org/wiki/United_Nations",
"story_refs": [],
"event_refs": []
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Get Entity
Fetch one Entity profile with linked Stories and Events. include_tone=true attaches media-tone coverage with explicit unavailable status. include_registry=true overlays entitled registry sections and corporate_context: bounded, typed parent/child relationships and separately attributed parent SEC identifiers and global-list counts. Facility data is separately gated by can_use_facilities: its total counts directly owned registry units, its 60-card preview and by_type values are bounded, and participation is a separate six-site preview of source-reported roles. Corporate context requires can_use_exposure; parent SEC/list summaries independently require can_use_filings/can_use_screening. Read status and truncation: incomplete graph coverage is not evidence of no parent, GLEIF consolidation is not percentage ownership, and a parent record never becomes a subsidiary record.
curl "https://gdeltcloud.com/api/v2/entities/https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FExample" \
-H "Authorization: Bearer $GDELT_API_KEY"import requests
url = "https://gdeltcloud.com/api/v2/entities/{entity_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/entities/{entity_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"id": "https://en.wikipedia.org/wiki/United_Nations",
"url": "https://gdeltcloud.com/entities/e_united_nations",
"name": "United Nations",
"type": "organization",
"wikipedia_url": "https://en.wikipedia.org/wiki/United_Nations",
"story_refs": [],
"event_refs": []
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
Entity ID returned by Search Entities or an entity_refs array. Wikipedia URLs are valid IDs and must be URL-encoded.
Query Parameters
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.
"2026-04-11"
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.
"2026-04-17"
Number of linked records to return.
1 <= x <= 5010
Set false to skip best-effort Wikipedia thumbnail/avatar enrichment.
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.
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
true One canonical Entity with resolved news coverage in the requested window. Explicit name search can retain reference entities without measured news coverage. Entity Tone may be included on detail; unavailable tone is not neutral.
Show child attributes
Show child attributes