Events and media / Global news metadata
GDELT global news mentions matching Tbilisi
GDELT DOC 2.0 can search worldwide monitored news for Tbilisi and return article-level metadata in JSON. A one-week query returned five representative articles in Chinese, English, Armenian and Russian, including Tbilisi flooding and a municipal demolition decision. Records contain URL, optional mobile URL and social image, title, first-seen timestamp, publisher domain, detected article language and source-country label. This is media-monitoring metadata, not verified event ground truth or a geocoded Tbilisi-event table.
Provenance and access
How the data is reached
Unauthenticated JSON API with query, mode, maximum records, timespan or explicit timestamps. First rapid request returned HTTP 429 with an instruction to limit calls to one every five seconds; a delayed retry returned JSON.
GDELT data/metadata are provided for open use, but linked article text, titles and social images remain subject to publisher copyright and terms. Store links and metadata, not copied articles.
Validated one-week query
https://api.gdeltproject.org/api/v2/doc/doc?query=Tbilisi&mode=artlist&maxrecords=5&format=json×pan=1week ↗- Method
- GET
- Format
- JSON
- Authentication
- None
Throttle to one request per five seconds
DOC 2.0 API documentation
https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/ ↗- Method
- GET
- Format
- HTML documentation
- Authentication
- None
Field-level detail
What is actually returned
DOC response
Article-list mode response.
| Field / path | Type | Null? | Example | Meaning | Freshness |
|---|---|---|---|---|---|
articles[] | array<object> | No | 5 records | Matching monitored articles | live |
Article
Every field returned in the validated article-list response.
| Field / path | Type | Null? | Example | Meaning | Freshness |
|---|---|---|---|---|---|
url | URL string | No | https://www.archdaily.com/… | Canonical or monitored article URL | reference |
url_mobile | URL string | Yes | Mobile-version URL when discovered | reference | |
title | string | No | Studio Fuksas Rike Park Cultural Complex Approved for Demolition by Tbilisi City Hall | Article headlinePublisher copyrighted text | live |
seendate | YYYYMMDDTHHMMSSZ string | No | 20260717T114500Z | Time GDELT first/most relevantly saw article | live |
socialimage | URL string | Yes | https://armtimes.com/static/article/…jpg | Detected social-preview imagePublisher copyrighted and may disappear | reference |
domain | hostname string | No | archdaily.com | Publisher domain | reference |
language | string | No | English | Detected article language | derived |
sourcecountry | string | No | United States | GDELT country attribution for source outletNot the event location | derived |
Representative evidence
Sample records
Tbilisi municipal-decision article metadata
Retrieved 2026-07-22 14:01 Asia/Tbilisi
{"url":"https://www.archdaily.com/1148847/studio-fuksas-rike-park-cultural-complex-approved-for-demolition-by-tbilisi-city-hall","url_mobile":"","title":"Studio Fuksas Rike Park Cultural Complex Approved for Demolition by Tbilisi City Hall","seendate":"20260717T114500Z","socialimage":"","domain":"archdaily.com","language":"English","sourcecountry":"United States"}Boundaries
Reliability, caveats, and privacy
What held up
- Delayed retry returned current multilingual article records
- Machine-readable first-seen timestamp and domain support deduplication
- Explicit query/time window makes retrieval reproducible
What can go wrong
- Keyword match can refer to Tbilisi without describing an event located there
- sourcecountry is outlet origin, not article subject location
- Duplicate/syndicated stories and machine translation occur
- Article and image copyrights remain with publishers
- API enforces throttling and returned 429 during validation
- News claims need source verification
Privacy boundary
- News may name individuals; avoid republishing personal details or treating mentions as verified allegations
Cross-source possibilities
Ideas using this source
Source trail
Primary pages and documentation
- DocumentationGDELT DOC 2.0 API ↗
https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/ - PrimaryGDELT data site ↗
https://www.gdeltproject.org/data.html