Global Knowedge Graph (gkg) full text search
Update 3.1.2020: Rest Querys and examples updated
Original Documentation:
http://blog.gdeltproject.org/announcing-the-gdelt-full-text-search-api/
The gkg fulltext table is filled as followed:
Content to a given topic
For each article, the title, source outlet, date/time converted to the user’s time zone, article language, and source outlet location are displayed.
Rest Query: (example here: in german about Ethiopia)
- Title
- source
- datetime
- country published
- country lang
Sample Data:
Volume for a given topic
Since news volume naturally varies through the course of the day, the Y axis is normalized by dividing the number of matching articles in a given 15 minute increment by the total global volume of coverage monitored by GDELT in that same interval, yielding what amounts to a “global news volume intensity” indicator.
1 |
http://api.gdeltproject.org/api/v1/search_ftxtsearch/search_ftxtsearch?query=sourcecountry:germany%20ethiopia&dropdup=true&output=timelinecsv&dropdup=true&outputtype=tone&outputtype=volume |
Sample Data:
1 2 3 4 |
DateTime,DateTimeHuman,Value 20170513160000,5/13/2017 16:00:00 UTC,0.0000 20170513161500,5/13/2017 16:15:00 UTC,0.0000 20170513171500,5/13/2017 17:15:00 UTC,0.0145 |
Tone to a given topic
This is a simple timeline that shows the average sentiment/tone (from “very happy” to “very sad”) of all matching coverage in 15 minute increments, allowing you to rapidly spot major changes in the tone of coverage of interest.
1 |
http://api.gdeltproject.org/api/v1/search_ftxtsearch/search_ftxtsearch?query=sourcecountry:germany%20ethiopia&dropdup=true&output=timelinecsv&dropdup=true&outputtype=tone&outputtype=tone |
Sample Data:
1 2 3 4 |
DateTime,DateTimeHuman,Value 20170513160000,5/13/2017 16:00:00 UTC,0.0000 20170513161500,5/13/2017 16:15:00 UTC,0.0000 20170513171500,5/13/2017 17:15:00 UTC,-2.7027 |
Geo v2
Detailed description of the API: GDELT GEO 2.0 API Debuts!
- source_Country properties name
- source_count: properties count
- source_url: properties html
- inserted: time the data was inserted in datacoll
- location coordinates
Nice map of the news coverage on Ethiopia:
https://api.gdeltproject.org/api/v2/geo/geo?query=Ethiopia
The same as GeoJson:
https://api.gdeltproject.org/api/v2/geo/geo?query=Ethiopia&format=GeoJSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
{ "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": { "name": "Ethiopia", "count": 1631, "shareimage": "", "html": "<a href=\"http://cul.china.com.cn/2020-01/03/content_41021250.htm\" title=\"探访非洲博物馆\" target=\"_blank\">探访非洲博物馆</a><br><br>" }, "geometry": { "type": "Point", "coordinates": [38.0000, 8.0000] } }, { "type": "Feature", "properties": { "name": "Egypt", "count": 468, "shareimage": "http://english.ahram.org.eg/Media/News/2020/1/2/2020-637135828131702771-170.jpg", "html": "<a href=\"http://www.arabnet5.com/news/2/431338/%CD%ED%E4-%DE%C7%E1-%C7%E1%D3%ED%D3%ED-%E1%C8%D8%D1%ED%D1%DF-%C5%CB%ED%E6%C8%ED%C7-%CD%CC%ED%C8-100-%E3%E1%ED%E6%E4-%E6%C3%CC%ED%E1%DF%E3\" title=\"حين قال السيسي لبطريرك إثيوبيا : حجيب 100 مليون وأجيلكم\" target=\"_blank\">حين قال السيسي لبطريرك إثيوبيا : حجيب 100 مليون وأجيلكم</a><br><br><a href=\"http://english.ahram.org.eg/NewsContent/1/64/358784/Egypt/Politics-/Sudan-PM-says-Khartoum,-Cairo-on-same-page-on-GERD.aspx\" title=\"Sudan PM says Khartoum , Cairo on same page on GERD - Politics - Egypt\" target=\"_blank\">Sudan PM says Khartoum , Cairo on same page on GERD - Politics - Egypt</a><br><br><a href=\"https://www.aljazeera.net/news/politics/2020/1/2/%D9%85%D8%B5%D8%B1-%D8%A8%D9%8A%D9%86-%D8%A7%D9%86%D8%B3%D8%AF%D8%A7%D8%AF-%D8%B3%D9%8A%D8%A7%D8%B3%D9%8A-%D9%88%D8%A7%D9%82%D8%AA%D8%B5%D8%A7%D8%AF-%D9%85%D8%AA%D8%A3%D8%B1%D8%AC%D8%AD\" title=\"مصر 2020 .. بين انسداد سياسي واقتصاد متأرجح\" target=\"_blank\">مصر 2020 .. بين انسداد سياسي واقتصاد متأرجح</a><br><br>" }, "geometry": { "type": "Point", "coordinates": [30.0000, 27.0000] } } } |
Table | Description | Link |
Theme | http://data.gdeltproject.org/api/v2/guides/LOOKUP-GKGTHEMES.TXT | |
Language | http://data.gdeltproject.org/api/v2/guides/LOOKUP-LANGUAGES.TXT | |
Country | http://data.gdeltproject.org/api/v2/guides/LOOKUP-COUNTRIES.TXT | |
Admin1 | Administrative area (more detailed than country) | http://data.gdeltproject.org/api/v2/guides/LOOKUP-ADM1S.TXT |
Image Web Tag | http://data.gdeltproject.org/api/v2/guides/LOOKUP-IMAGEWEBTAGS.TXT | |
Image Tags | http://data.gdeltproject.org/api/v2/guides/LOOKUP-IMAGETAGS.TXT | |
GNS or GNIS FeatureID | http://www.dlib.org/dlib/september12/leetaru/09leetaru.html | |