Read publication activity
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. recorded_at retains journal availability time independently from published_at and source_date. Exhausting next_cursor completes the observed journal at its publication cutoff, not all upstream source intake. 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.
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.
Optional UTC hour, 0–23. 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 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 publication records per page, from 1 to 100. 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 <= 100Opaque next_cursor from the previous response. Keep the other filters unchanged. 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 journal availability time, as an ISO UTC timestamp. Supply both bounds. Includes late arrivals without changing their original reporting dates. 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 journal availability time, as an ISO UTC timestamp. Supply both bounds. Includes late arrivals without changing their original reporting dates. 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.