changedInput schema / properties / region / description
Previous value: -"ISO 3166-1 alpha-2 country whose publishers to search (JP, KR, GB). Default: the language's home edition."New value: +"Accepted for compatibility; GDELT does not record a publisher's country, so use language."
changedInput schema / properties / symbol / description
Previous value: -"Optional ticker (AAPL, 7203.T, 005930.KS) for that stock's own news feed."New value: +"Optional US ticker (AAPL, MSFT): searches the company's name from the SEC ticker table."
changedOutput schema / properties / result / properties / articles / items / properties / feed / description
Previous value: -"Which feed it came from."New value: +"Which source it came from."
changedOutput schema / properties / result / properties / articles / items / properties / feed / enum
Previous value: -[
- "google_news",
- "yahoo_finance"
-]New value: +[
+ "gdelt"
+]
changedOutput schema / properties / result / properties / articles / items / properties / feed / examples
Previous value: -[
- "google_news"
-]New value: +[
+ "gdelt"
+]
addedOutput schema / properties / result / properties / articles / items / properties / language
Added value: +{
+ "description": "Article language (BCP-47).",
+ "examples": [
+ "ja"
+ ],
+ "type": [
+ "string",
+ "null"
+ ]
+}
changedOutput schema / properties / result / properties / articles / items / properties / published_at / description
Previous value: -"Publication time (UTC)."New value: +"When GDELT first saw it (UTC, 15-minute batches)."
changedOutput schema / properties / result / properties / articles / items / properties / published_at / examples
Previous value: -[
- "2026-09-27T02:32:00Z"
-]New value: +[
+ "2026-09-27T02:30:00Z"
+]
changedOutput schema / properties / result / properties / articles / items / properties / source_name / description
Previous value: -"Publisher."New value: +"Publisher domain."
changedOutput schema / properties / result / properties / articles / items / properties / source_name / examples
Previous value: -[
- "日本経済新聞"
-]New value: +[
+ "nikkei.com"
+]
changedOutput schema / properties / result / properties / articles / items / properties / source_url / examples
Previous value: -[
- "https://www.nikkei.com"
-]New value: +[
+ "https://nikkei.com"
+]
changedOutput schema / properties / result / properties / articles / items / properties / summary / description
Previous value: -"Plain-text summary when the feed carries one."New value: +"Summary; GDELT carries none, so null."
changedOutput schema / properties / result / properties / articles / items / properties / summary / examples
Previous value: -[
- "半導体関連株が..."
-]New value: +[
+ null
+]
changedOutput schema / properties / result / properties / articles / items / properties / title / description
Previous value: -"Headline, publisher suffix removed."New value: +"Headline in its original language."
changedOutput schema / properties / result / properties / articles / items / properties / url / description
Previous value: -"Article link (Google News links resolve to the publisher)."New value: +"The publisher's article link."
changedOutput schema / properties / result / properties / articles / items / properties / url / examples
Previous value: -[
- "https://news.google.com/rss/articles/CBMi..."
-]New value: +[
+ "https://www.nikkei.com/article/DGXZQO..."
+]
changedOutput schema / properties / result / properties / articles / items / required
Previous value: -[
- "title",
- "url",
- "source_name",
- "source_url",
- "published_at",
- "summary",
- "feed"
-]New value: +[
+ "title",
+ "url",
+ "source_name",
+ "source_url",
+ "published_at",
+ "summary",
+ "language",
+ "feed"
+]
addedOutput schema / properties / result / properties / attribution
Added value: +{
+ "description": "The citation GDELT's licence requires with every use.",
+ "properties": {
+ "text": {
+ "description": "Required citation.",
+ "examples": [
+ "Source: The GDELT Project"
+ ],
+ "type": "string"
+ },
+ "url": {
+ "description": "Required link.",
+ "examples": [
+ "https://www.gdeltproject.org/"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "url"
+ ],
+ "type": "object"
+}
removedOutput schema / properties / result / properties / edition
Removed value: -{
- "description": "The Google News edition used; null when no query was given.",
- "properties": {
- "ceid": {
- "description": "Edition id.",
- "examples": [
- "JP:ja"
- ],
- "type": "string"
- },
- "gl": {
- "description": "Country edition.",
- "examples": [
- "JP"
- ],
- "type": "string"
- },
- "hl": {
- "description": "Google News language code.",
- "examples": [
- "ja"
- ],
- "type": "string"
- },
- "verified": {
- "description": "True for the 71 editions verified to answer; false for a pair tried on request.",
- "examples": [
- true
- ],
- "type": "boolean"
- }
- },
- "required": [
- "hl",
- "gl",
- "ceid",
- "verified"
- ],
- "type": [
- "object",
- "null"
- ]
-}
changedOutput schema / properties / result / properties / language / description
Previous value: -"BCP-47 language the edition was chosen for."New value: +"BCP-47 language asked for; null when none."
changedOutput schema / properties / result / properties / language / type
Previous value: -"string"New value: +[
+ "string",
+ "null"
+]
addedOutput schema / properties / result / properties / language_filter
Added value: +{
+ "description": "Language the articles were limited to; null when every language was searched.",
+ "examples": [
+ "ja"
+ ],
+ "type": [
+ "string",
+ "null"
+ ]
+}
changedOutput schema / properties / result / properties / notes / items / examples
Previous value: -[
- "Edition XX:yy returned nothing for this query; results are from the en/US edition."
-]New value: +[
+ "GDELT does not record a publisher's country, so region is not a filter."
+]
changedOutput schema / properties / result / properties / since_hours / description
Previous value: -"Window applied, in hours; null when none."New value: +"Window searched, in hours."
changedOutput schema / properties / result / properties / since_hours / examples
Previous value: -[
- 24
-]New value: +[
+ 72
+]
changedOutput schema / properties / result / properties / since_hours / type
Previous value: -[
- "integer",
- "null"
-]New value: +"integer"
changedOutput schema / properties / result / properties / sources_failed / description
Previous value: -"Feeds that did not answer, with the reason; never silently dropped."New value: +"Searches that did not answer, with the reason; never silently dropped."
changedOutput schema / properties / result / properties / sources_failed / items / description
Previous value: -"A feed that failed for this call."New value: +"A search that failed for this call."
changedOutput schema / properties / result / properties / sources_failed / items / properties / reason / examples
Previous value: -[
- "Yahoo Finance RSS (7203.T) timed out"
-]New value: +[
+ "Symbol news covers US-listed tickers"
+]
changedOutput schema / properties / result / properties / sources_failed / items / properties / source / description
Previous value: -"Feed id."New value: +"Search id."
changedOutput schema / properties / result / properties / sources_failed / items / properties / source / examples
Previous value: -[
- "yahoo_finance:7203.T"
-]New value: +[
+ "gdelt:symbol:7203.T"
+]
changedOutput schema / properties / result / properties / sources_ok / description
Previous value: -"Feeds that answered."New value: +"Searches that answered."
changedOutput schema / properties / result / properties / sources_ok / examples
Previous value: -[
- [
- "google_news:JP:ja"
- ]
-]New value: +[
+ [
+ "gdelt:query"
+ ]
+]
changedOutput schema / properties / result / properties / sources_ok / items / description
Previous value: -"Feed id."New value: +"Search id."
changedOutput schema / properties / result / properties / sources_ok / items / examples
Previous value: -[
- "google_news:JP:ja"
-]New value: +[
+ "gdelt:query"
+]
changedOutput schema / properties / result / properties / sources_searched / description
Previous value: -"Feeds this call asked."New value: +"Searches this call ran."
changedOutput schema / properties / result / properties / sources_searched / examples
Previous value: -[
- [
- "google_news:JP:ja"
- ]
-]New value: +[
+ [
+ "gdelt:query"
+ ]
+]
changedOutput schema / properties / result / properties / sources_searched / items / description
Previous value: -"Feed id."New value: +"Search id."
changedOutput schema / properties / result / properties / sources_searched / items / examples
Previous value: -[
- "google_news:JP:ja"
-]New value: +[
+ "gdelt:query"
+]
changedOutput schema / properties / result / properties / symbol / description
Previous value: -"Ticker whose own feed was read; null when none."New value: +"Ticker whose company name was searched; null when none."
changedOutput schema / properties / result / properties / symbol / examples
Previous value: -[
- "7203.T"
-]New value: +[
+ "AAPL"
+]
changedOutput schema / properties / result / required
Previous value: -[
- "query",
- "symbol",
- "language",
- "edition",
- "sources_searched",
- "sources_ok",
- "sources_failed",
- "articles",
- "article_count",
- "limit",
- "since_hours",
- "notes",
- "checked_at"
-]New value: +[
+ "query",
+ "symbol",
+ "language",
+ "language_filter",
+ "sources_searched",
+ "sources_ok",
+ "sources_failed",
+ "articles",
+ "article_count",
+ "limit",
+ "since_hours",
+ "attribution",
+ "notes",
+ "checked_at"
+]