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. 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. Requires a single date and rejects hours that have not started. The current hour is allowed and describes publications so far; omit for the whole selected day.
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. Supply both bounds. Includes late arrivals without changing when the event happened. Cannot combine with reporting-date filters. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Exclusive end of API publication time, as an ISO UTC timestamp. Supply both bounds. Includes late arrivals without changing when the event happened. Cannot combine with reporting-date filters. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Typed selected root for a shared connected scope: entity or facility. Use with target_ids. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Comma-separated stable IDs for the selected roots (up to 25). Use with target_type; roots are unioned. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
direct matches the selected target. connected includes verified controlled subsidiaries for entities, or identified facility owners and authoritative parent paths for facilities. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.