addedInput schema / properties / offset
Added value: +{
+ "default": 0,
+ "description": "Zero-based series offset — into the ranked top 10, or into the series named in series. Pass nextOffset from the preceding response, with otherwise identical inputs, to get the next page.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+}
changedInput schema / properties / series / description
Previous value: -"Exact series labels to additionally return in full, e.g. [\"Portuguese\", \"Vietnamese\"]. Take them verbatim from otherSeriesLabels (the series folded into \"Other\") or topSeries[].label in a response, or from the label list an unknown_series error prints. Each one comes back complete under selectedSeries, on top of the usual top-10 overview; a label that matches nothing is rejected rather than silently skipped. Omit to get the overview alone."New value: +"Exact series labels to return instead of the ranked overview, e.g. [\"Portuguese\", \"Vietnamese\"]. Take them verbatim from otherSeriesLabels or topSeries[].label in a response, or from the label list an unknown_series error prints. Each one comes back complete under selectedSeries, in the order requested; a label that matches nothing is rejected rather than silently skipped. Omit to get the ranked overview."
changedOutput schema / anyOf
Previous value: -[
- {
- "not": {
- "required": [
- "error"
- ]
- },
- "required": [
- "topSeries",
- "effectiveQuery",
- "breakdownBy",
- "totalCount"
- ]
- },
- {
- "required": [
- "error"
- ]
- }
-]New value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "effectiveQuery",
+ "breakdownBy",
+ "totalCount"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_series`: A label passed in the series input matches no series in a non-empty breakdown. `invalid_date_range`: Only one of startDatetime / endDatetime was supplied, one of them is not a real UTC calendar timestamp, or startDatetime is not earlier than endDatetime. `invalid_query`: GDELT rejected the query string as malformed — bad keyword length, unbalanced parentheses, or an illegal character. `gdelt_rate_limited`: GDELT rejected the request for its one-request-per-five-seconds limit, or too many requests were already queued for this one to start in time. `gdelt_unavailable`: GDELT DOC API is unreachable or temporarily returned no usable data. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `unknown_series`: A label passed in the series input matches no series in a non-empty breakdown. `offset_out_of_range`: The requested offset is at or beyond the last series of a non-empty overview (the top 10), or of the series named in series. `invalid_date_range`: Only one of startDatetime / endDatetime was supplied, one of them is not a real UTC calendar timestamp, or startDatetime is not earlier than endDatetime. `invalid_query`: GDELT rejected the query string as malformed — bad keyword length, unbalanced parentheses, or an illegal character. `gdelt_rate_limited`: GDELT rejected the request for its one-request-per-five-seconds limit, or too many requests were already queued for this one to start in time. `gdelt_unavailable`: GDELT DOC API is unreachable or temporarily returned no usable data. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "unknown_series",
- "invalid_date_range",
- "invalid_query",
- "gdelt_rate_limited",
- "gdelt_unavailable"
-]New value: +[
+ "unknown_series",
+ "offset_out_of_range",
+ "invalid_date_range",
+ "invalid_query",
+ "gdelt_rate_limited",
+ "gdelt_unavailable"
+]
addedOutput schema / properties / nextOffset
Added value: +{
+ "description": "Offset of the next page, for the same inputs. Absent when this page reaches the last series.",
+ "type": "number"
+}
changedOutput schema / properties / notice / description
Previous value: -"Guidance when the query matched no coverage in the window — how to broaden the query or extend the window. Absent when breakdown data was returned."New value: +"Guidance when the query matched no coverage in the window — how to broaden the query or extend the window — or, when this response is one page of several, which series it returned out of how many. Absent when every series fit in one response."
removedOutput schema / properties / otherAggregated
Removed value: -{
- "description": "Combined time series for all series beyond the top 10. Omitted when all series fit.",
- "items": {
- "additionalProperties": false,
- "description": "A single aggregated data point for the \"Other\" bucket.",
- "properties": {
- "date": {
- "description": "Timestep in ISO 8601 format.",
- "type": "string"
- },
- "value": {
- "description": "Aggregated normalized coverage volume for all remaining series — a share of media output, not an absolute article count.",
- "type": "number"
- }
- },
- "required": [
- "date",
- "value"
- ],
- "type": "object"
- },
- "type": "array"
-}
changedOutput schema / properties / otherSeriesLabels / description
Previous value: -"Label of every series folded into otherAggregated, ranked by total volume — the identities the \"Other\" bucket would otherwise dissolve. Pass any of them to the series input to retrieve that series' complete data. Omitted when all series fit in the top 10."New value: +"Label of every series beyond the top 10, ranked by the sum of its values, on every overview page. Pass any of them to the series input to retrieve that series' complete data. Omitted when all series fit in the top 10, or when the series input selects series instead."
changedOutput schema / properties / selectedSeries / description
Previous value: -"Complete, untruncated time series for each label requested via the series input, in the order requested. Omitted when series was not supplied."New value: +"Complete, untruncated time series for the labels requested via the series input — those of this page, in the order requested. Omitted when series was not supplied."
changedOutput schema / properties / topSeries / description
Previous value: -"Top 10 series by total coverage volume."New value: +"The ranked overview: the top 10 series by the sum of their values, those of this page in rank order. Omitted when the series input selects series instead."
changedOutput schema / properties / totalCount / description
Previous value: -"Total number of series returned before truncation to top 10."New value: +"Total number of series GDELT returned, before ranking into the top 10 or paging."