addedInput schema / properties / offset
Added value: +{
+ "default": 0,
+ "description": "Zero-based timestep offset — into the timeline, or into the timesteps named in points. Pass nextOffset from the preceding response, with otherwise identical inputs, to get the next page.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+}
changedInput schema / properties / points / description
Previous value: -"Timestep dates whose complete article list should be rendered in the text surface, e.g. [\"2024-01-05T12:00:00Z\"]. Take them verbatim from series[].data[].date in a prior response, or from the list an unknown_point error prints. Only affects volume_with_articles rendering — every timestep already carries its full article list in structuredContent regardless. Timesteps not named here show their first 3 links; a date matching no timestep is rejected rather than silently ignored."New value: +"Timestep dates to return alone, e.g. [\"2024-01-05T12:00:00Z\"]. Take them verbatim from series[].data[].date in a prior response, or from the list an unknown_point error prints. The response then carries only these timesteps, in timeline order, and in volume_with_articles mode each carries its complete article list instead of the first 3. A date matching no timestep is rejected rather than silently ignored."
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_point`: A date passed in the points input matches no timestep in a non-empty timeline. `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_point`: A date passed in the points input matches no timestep in a non-empty timeline. `offset_out_of_range`: The requested offset is at or beyond the last timestep of a non-empty timeline, or of the timesteps named in points. `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_point",
- "invalid_date_range",
- "invalid_query",
- "gdelt_rate_limited",
- "gdelt_unavailable"
-]New value: +[
+ "unknown_point",
+ "offset_out_of_range",
+ "invalid_date_range",
+ "invalid_query",
+ "gdelt_rate_limited",
+ "gdelt_unavailable"
+]
changedOutput schema / properties / expandedPoints / description
Previous value: -"Timestep dates whose full article list is rendered in the text surface instead of the first 3, echoing the points input. Omitted when points was not supplied. Purely a rendering concern — structuredContent carries every article for every timestep either way."New value: +"Timestep dates this response is restricted to, each carrying its full article list — echoing the points input. Omitted when points was not supplied."
addedOutput schema / properties / nextOffset
Added value: +{
+ "description": "Offset of the next page, for the same inputs. Absent when this page reaches the last timestep.",
+ "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 timeline 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 timesteps it returned out of how many. Absent when the whole timeline fit in one response."
changedOutput schema / properties / series / description
Previous value: -"One or more time series (typically one for volume/tone, one per label for breakdowns)."New value: +"One or more time series (typically one for volume/tone), holding the timesteps of this page."
changedOutput schema / properties / series / items / properties / data / description
Previous value: -"Time-ordered data points for this series."New value: +"Time-ordered data points of this series returned in this response."
changedOutput schema / properties / series / items / properties / data / items / properties / articles / description
Previous value: -"Top articles driving coverage at this timestep. Present only in volume_with_articles mode."New value: +"Top articles driving coverage at this timestep — the first 3, or all of them for a timestep named in points. Present only in volume_with_articles mode."
addedOutput schema / properties / series / items / properties / data / items / properties / referenceCount
Added value: +{
+ "description": "How many articles GDELT returned for this timestep; articles carries the first 3 unless the timestep was named in points. Present whenever articles is.",
+ "type": "number"
+}
addedOutput schema / properties / series / items / properties / peak
Added value: +{
+ "additionalProperties": false,
+ "description": "The point of the whole series with the largest absolute value, across every page — it may lie outside data. Omitted when the series has no points.",
+ "properties": {
+ "date": {
+ "description": "Timestep of the peak, in ISO 8601 format.",
+ "type": "string"
+ },
+ "value": {
+ "description": "Value at the peak timestep.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "date",
+ "value"
+ ],
+ "type": "object"
+}
addedOutput schema / properties / series / items / properties / pointCount
Added value: +{
+ "description": "Data points in the whole series, across every page — not only those in data. Present whenever the series has points.",
+ "type": "number"
+}
changedOutput schema / properties / totalCount / description
Previous value: -"Total number of data points across all series."New value: +"Total number of data points across all series of the full timeline, not this page."