changedInput schema / properties / maxRecords / description
Previous value: -"Maximum number of clips to fetch (1–3000); the response carries as many of them as fit its 48,000-byte budget. 3000 is GDELT's hard per-call ceiling, not a page size — there is no cursor past it, so a query that fills 3000 must be split into narrower startDatetime/endDatetime windows instead."New value: +"Maximum number of clips to fetch (1–3000; a value up to 30000 runs at 3000, and the response says so in limitClamp). The response carries as many of them as fit its 48,000-byte budget. 3000 is GDELT's hard per-call ceiling, not a page size — there is no cursor past it, so a query that fills 3000 must be split into narrower startDatetime/endDatetime windows instead."
changedInput schema / properties / maxRecords / maximum
Previous value: -3000New value: +30000
changedOutput schema / properties / clips / items / properties / station / description
Previous value: -"Station ID (e.g. \"CNN\")."New value: +"Station ID — the value the stations input and the station: operator take (e.g. \"FOXNEWS\"). Absent when GDELT's label for the station could not be resolved to an ID; notice says why."
addedOutput schema / properties / clips / items / properties / stationName
Added value: +{
+ "description": "GDELT's display label for the station (e.g. \"FOX News\"). Empty when GDELT returned the clip without one; notice says so.",
+ "type": "string"
+}
changedOutput schema / properties / clips / items / required
Previous value: -[
- "show",
- "station",
- "date",
- "snippet",
- "archiveUrl"
-]New value: +[
+ "show",
+ "stationName",
+ "date",
+ "snippet",
+ "archiveUrl"
+]
addedOutput schema / properties / limitClamp
Added value: +{
+ "additionalProperties": false,
+ "description": "Present only when the requested count exceeded the per-call cap: the call ran exactly as a call at the cap, and every count, notice, and continuation in this response reflects the applied value.",
+ "properties": {
+ "applied": {
+ "description": "The per-call cap the call ran with instead.",
+ "type": "number"
+ },
+ "parameter": {
+ "description": "The count input that was clamped.",
+ "enum": [
+ "maxRecords",
+ "limit"
+ ],
+ "type": "string"
+ },
+ "requested": {
+ "description": "The value the call asked for.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "parameter",
+ "requested",
+ "applied"
+ ],
+ "type": "object"
+}
changedOutput schema / properties / notice / description
Previous value: -"Guidance on an incomplete or empty result. When no clips matched, the resolved timespan window and how to target the 2009–October 2024 archive or verify station IDs. When GDELT returned clips aired outside the requested window (it answers whole clock hours), how many were dropped. When the response was cut to its 48,000-byte budget, how many clips it withheld and the route to them. When the maxRecords cap was reached on an uncut response, that more clips may exist — a higher maxRecords below the 3000 ceiling, or a narrower date window at it. Absent when a non-empty result set fit under both the cap and the budget."New value: +"Guidance on an incomplete or empty result. When no clips matched, the resolved timespan window and how to target the 2009–October 2024 archive or verify station IDs. When GDELT returned clips aired outside the requested window (it answers whole clock hours), how many were dropped. When the response was cut to its 48,000-byte budget, how many clips it withheld and the route to them. When the maxRecords cap was reached on an uncut response, that more clips may exist — a higher maxRecords below the 3000 ceiling, or a narrower date window at it. When a returned clip has no station ID, why: GDELT returned it without a station label, or its station catalog did not load or has no entry for the named label — with how to look the ID up. Absent when a non-empty result set fit under both the cap and the budget, no clip was dropped as out of window, and every clip carries its station ID."