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 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.