curl --request GET \
--url https://gdeltcloud.com/api/v2/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/activity"
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/activity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}Read publication activity
A change feed of records GDELT Cloud published to its API: Events, Stories, entities and other entitled sources. Use it to watch additions, updates and removals; it is not a customer API-request log, and its dates are not Event occurrence dates. Paginated observed evidence of successful serving/reference publication. Unchanged reloads and baseline inventories are excluded. Linked entities are mentions or participants according to the record; they are not newly created identities. Source dates retain their stated precision. Source capability and collection start are explicit; missing history is not zero. Reads are ordered by the selected time_basis, newest first. Only committed batches are visible; cursors pin committed source sequences across pages. A published-date query scans one UTC day per page; a page may be empty while next_cursor still points to an earlier day or past a filtered-out change. recorded_at retains journal availability time independently from published_at and source_date. For ongoing watches, choose time_basis=recorded. Exhausting next_cursor completes the observed journal at its publication cutoff, not all upstream source intake. Events/Stories replay watermarks are not source-wide coverage receipts, so their absent counts remain unknown and their windows are not exhaustive until such evidence is explicitly available; positive committed rows remain readable. Query Monitors may watch observed publication entries while retaining source/history qualifications; partial history cannot establish exhaustive all-source counts or quiet days. Failed, unavailable or capped journal reads cannot complete a Monitor checkpoint.
curl --request GET \
--url https://gdeltcloud.com/api/v2/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/activity"
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/activity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": []
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Clock for date/hour filters and ordering: published preserves the serving/reference publication time; recorded uses the durable journal commit time and includes late publications when they become available. Omission retains published compatibility. Choose recorded explicitly for ongoing activity Monitors; source dates remain unchanged. With time_basis=published: cannot be combined with recorded_start or recorded_end. A recorded interval is always read on the recorded clock. Full value list: https://docs.gdeltcloud.com/reference/enums#activity-time-basis
published, recorded First UTC date in the selected time_basis. Defaults to today; future dates are rejected. Neither clock is Event occurrence time. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Last UTC date in the selected time_basis, inclusive. Defaults to date_start and cannot be later than the current UTC day. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
UTC hour selecting a publication bucket on one UTC date. Rejects hours that have not started. The current hour is allowed and describes publications so far; omit for the whole selected day. Requires date_start and date_end to be equal when both are sent. An hour selects one UTC date.
0 <= x <= 23Known country attribution. Evidence distinguishes location, actor origin, reporting and source association. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#country
Published record type to include in activity evidence. Full value list: https://docs.gdeltcloud.com/reference/enums#activity-kind
event, story, entity, facility, list_entry, office_holder, filing, entity_relationship, facility_observation, facility_relationship Publication transition. Defaults to all substantive transitions. Full value list: https://docs.gdeltcloud.com/reference/enums#activity-change
added, updated, removed Selected entity ID from /api/v2/search; returns records linked to that identity. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Number of records to return on this page; pagination describes how to continue. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 100Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Inclusive start of API publication time, as an ISO UTC timestamp. Includes late arrivals without changing when the event happened. Requires recorded_end. Cannot be combined with date_start, date_end or hour. A recorded interval replaces the reporting window.
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$Exclusive end of API publication time, as an ISO UTC timestamp. Includes late arrivals without changing when the event happened. Requires recorded_start. Cannot be combined with date_start, date_end or hour. A recorded interval replaces the reporting window.
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$Typed selected root for a shared connected scope: entity or facility. Requires target_ids. Full value list: https://docs.gdeltcloud.com/reference/enums#target_type
entity, facility Comma-separated stable IDs of the target_type kind (up to 25); roots are unioned. Requires target_type. Cannot be combined with entity. Use either the legacy entity filter or a typed target scope.
direct matches the selected target. connected includes verified controlled subsidiaries for entities, or identified facility owners and authoritative parent paths for facilities. Requires target_type and target_ids. Full value list: https://docs.gdeltcloud.com/reference/enums#related_scope
direct, connected