addedInput schema / properties / dateres
Added value: +{
+ "description": "Optional GDELT aggregation resolution. Omit to let GDELT choose from the query window; the effective recognized or inferred resolution is returned as dateResolution.",
+ "enum": [
+ "hour",
+ "day",
+ "week",
+ "month",
+ "year"
+ ],
+ "type": "string"
+}
addedInput schema / properties / limit
Added value: +{
+ "default": 500,
+ "description": "Maximum timeline points returned in this response (1–500).",
+ "maximum": 500,
+ "minimum": 1,
+ "type": "integer"
+}
changedInput schema / properties / normalize / description
Previous value: -"When true (default), values are normalized as % of total airtime, enabling cross-station comparison. When false, returns raw coverage volume."New value: +"When true (default), values are normalized as % of total airtime, enabling cross-station comparison. When false, returns raw matching 15-second clip counts."
addedInput schema / properties / offset
Added value: +{
+ "default": 0,
+ "description": "Zero-based point offset into the deterministic date-then-station ordering. Use nextOffset from the preceding response with the same query inputs to retrieve the next page.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+}
changedInput schema / properties / stations / description
Previous value: -"Station IDs to filter to (e.g. [\"CNN\", \"FOXNEWS\", \"MSNBC\"]). The GDELT TV API requires at least one station — supply it here, or embed a station: selector directly in query. Omitting both is rejected; it does not fall back to all stations. Use gdelt_list_tv_stations to see valid station IDs."New value: +"Up to 10 station IDs to filter to (e.g. [\"CNN\", \"FOXNEWS\", \"MSNBC\"]). The GDELT TV API requires at least one station — supply it here, or embed a station: selector directly in query. Omitting both is rejected; it does not fall back to all stations. Use gdelt_list_tv_stations to see valid station IDs."
addedInput schema / properties / stations / maxItems
Added value: +10
changedOutput schema / anyOf
Previous value: -[
- {
- "not": {
- "required": [
- "error"
- ]
- },
- "required": [
- "dateResolution",
- "timeRange",
- "series",
- "normalized",
- "effectiveQuery",
- "totalCount"
- ]
- },
- {
- "required": [
- "error"
- ]
- }
-]New value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "dateResolution",
+ "timeRange",
+ "series",
+ "normalized",
+ "totalPoints",
+ "offset",
+ "limit",
+ "effectiveQuery",
+ "totalCount"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]
changedOutput schema / properties / dateResolution / enum
Previous value: -[
- "hour",
- "day",
- "month"
-]New value: +[
+ "hour",
+ "day",
+ "week",
+ "month",
+ "year"
+]
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `no_tv_coverage`: No TV coverage found for the query in the specified time range. `invalid_date_range`: Exactly one of startDatetime / endDatetime was supplied. `invalid_query`: GDELT rejected the query — no station was selected, or the query string is malformed. `gdelt_rate_limited`: GDELT rejected the request because its one-request-per-five-seconds limit was reached. `gdelt_unavailable`: GDELT TV 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: `no_tv_coverage`: No TV coverage found for the query in the specified time range. `invalid_date_range`: Exactly one of startDatetime / endDatetime was supplied. `offset_out_of_range`: The requested point offset is at or beyond the end of a non-empty timeline. `invalid_query`: GDELT rejected the query — no station was selected, or the query string is malformed. `gdelt_rate_limited`: GDELT rejected the request because its one-request-per-five-seconds limit was reached. `gdelt_unavailable`: GDELT TV 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: -[
- "no_tv_coverage",
- "invalid_date_range",
- "invalid_query",
- "gdelt_rate_limited",
- "gdelt_unavailable"
-]New value: +[
+ "no_tv_coverage",
+ "invalid_date_range",
+ "offset_out_of_range",
+ "invalid_query",
+ "gdelt_rate_limited",
+ "gdelt_unavailable"
+]
addedOutput schema / properties / limit
Added value: +{
+ "description": "Maximum points requested for this page.",
+ "type": "number"
+}
addedOutput schema / properties / nextOffset
Added value: +{
+ "description": "Offset for the next page using the same query inputs. Absent when this is the final page.",
+ "type": "number"
+}
addedOutput schema / properties / offset
Added value: +{
+ "description": "Zero-based offset of this point page.",
+ "type": "number"
+}
changedOutput schema / properties / series / description
Previous value: -"One coverage series per explicitly selected station."New value: +"Station series represented in this point page."
changedOutput schema / properties / series / items / properties / data / items / properties / value / description
Previous value: -"Coverage value (normalized % or raw count)."New value: +"Coverage value (normalized % or raw matching 15-second clip count)."
changedOutput schema / properties / timeRange / description
Previous value: -"Date range spanned by the returned data."New value: +"Date range spanned by this returned point page."
addedOutput schema / properties / totalPoints
Added value: +{
+ "description": "Total points available across all matched station series before pagination.",
+ "type": "number"
+}