Skip to main content
GET
/
api
/
v2
/
entities
cURL
curl "https://gdeltcloud.com/api/v2/entities" \
  -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": []
    }
  ],
  "pagination": {
    "limit": 25,
    "cursor": null,
    "next_cursor": "eyJvZmZzZXQiOjI1fQ=="
  }
}

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

Query Parameters

​
search
string

Entity name or phrase to search for.

​
type
enum<string>

Optional entity type filter.

Available options:
person,
organization,
location
​
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:25

Number of records to return.

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

25

​
cursor
string

Pagination cursor from pagination.next_cursor.

Response

200 - application/json

Entity cards

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