Skip to main content
GET
/
api
/
v2
/
entities
/
{entity_id}
cURL
curl "https://gdeltcloud.com/api/v2/entities/https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FExample" \
  -H "Authorization: Bearer $GDELT_CLOUD_API_KEY"
{
  "success": true,
  "data": {
    "id": "https://en.wikipedia.org/wiki/United_Nations",
    "url": "https://gdeltcloud.com/entity-geg/organization/United%20Nations",
    "name": "United Nations",
    "type": "organization",
    "wikipedia_url": "https://en.wikipedia.org/wiki/United_Nations",
    "story_refs": [],
    "event_refs": []
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt

Use this file to discover all available pages before exploring further.

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. Alias start_date is accepted for compatibility.

Example:

"2026-04-11"

date_end
string<date>

Inclusive end date in YYYY-MM-DD. Alias end_date is accepted for compatibility.

Example:

"2026-04-17"

limit
integer
default:10

Number of linked records to return.

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

10

Response

Entity detail

success
enum<boolean>
Available options:
true
data
object