Global News Monitor (GDELT)
Freenews:gdelt
Search news headlines from media worldwide, and see the coverage volume and tone of a topic over time.
No key yet? Sign up free
GET/v1/news:gdelt/coverage
Daily coverage volume, as a percentage of all monitored news.
Cache 21600 s
1 quota / request
news.gdelt.coverage
cURL
curl -H "x-api-key: ga_live_..." "https://kajidata.artonlabs.com/v1/news:gdelt/coverage?q=inflation&country=indonesia"
Python
import requests
response = requests.get(
"https://kajidata.artonlabs.com/v1/news:gdelt/coverage",
params={"q": "inflation", "country": "indonesia"},
headers={"x-api-key": "ga_live_..."},
timeout=30,
)
body = response.json()
print(body["data"] if body["ok"] else body["error"])
JavaScript
const params = new URLSearchParams({"q": "inflation", "country": "indonesia"});
const response = await fetch(`https://kajidata.artonlabs.com/v1/news:gdelt/coverage?${params}`, {
headers: { "x-api-key": "ga_live_..." },
});
const body = await response.json();
console.log(body.ok ? body.data : body.error);
PHP
<?php
$ch = curl_init('https://kajidata.artonlabs.com/v1/news:gdelt/coverage?' . http_build_query(['q' => 'inflation', 'country' => 'indonesia']));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ga_live_...'],
CURLOPT_TIMEOUT => 30,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body['ok'] ? $body['data'] : $body['error']);
Go
package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("q", "inflation")
params.Set("country", "indonesia")
req, _ := http.NewRequest("GET", "https://kajidata.artonlabs.com/v1/news:gdelt/coverage?"+params.Encode(), nil)
req.Header.Set("x-api-key", "ga_live_...")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
var body map[string]any
json.NewDecoder(res.Body).Decode(&body)
fmt.Println(body["data"])
}
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://kajidata.artonlabs.com/v1/news:gdelt/coverage?q=inflation&country=indonesia"))
.header("x-api-key", "ga_live_...")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
Ruby
require "net/http"
require "json"
uri = URI("https://kajidata.artonlabs.com/v1/news:gdelt/coverage")
uri.query = URI.encode_www_form({"q" => "inflation", "country" => "indonesia"})
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "ga_live_..."
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
body = JSON.parse(response.body)
puts body["ok"] ? body["data"] : body["error"]
C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "ga_live_...");
var json = await client.GetStringAsync("https://kajidata.artonlabs.com/v1/news:gdelt/coverage?q=inflation&country=indonesia");
Console.WriteLine(json);GET/v1/news:gdelt/search
Search recent news headlines.
Cache 3600 s
1 quota / request
news.gdelt.search
cURL
curl -H "x-api-key: ga_live_..." "https://kajidata.artonlabs.com/v1/news:gdelt/search?q=inflation&limit=5&country=indonesia"
Python
import requests
response = requests.get(
"https://kajidata.artonlabs.com/v1/news:gdelt/search",
params={"q": "inflation", "limit": "5", "country": "indonesia"},
headers={"x-api-key": "ga_live_..."},
timeout=30,
)
body = response.json()
print(body["data"] if body["ok"] else body["error"])
JavaScript
const params = new URLSearchParams({"q": "inflation", "limit": "5", "country": "indonesia"});
const response = await fetch(`https://kajidata.artonlabs.com/v1/news:gdelt/search?${params}`, {
headers: { "x-api-key": "ga_live_..." },
});
const body = await response.json();
console.log(body.ok ? body.data : body.error);
PHP
<?php
$ch = curl_init('https://kajidata.artonlabs.com/v1/news:gdelt/search?' . http_build_query(['q' => 'inflation', 'limit' => '5', 'country' => 'indonesia']));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ga_live_...'],
CURLOPT_TIMEOUT => 30,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body['ok'] ? $body['data'] : $body['error']);
Go
package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("q", "inflation")
params.Set("limit", "5")
params.Set("country", "indonesia")
req, _ := http.NewRequest("GET", "https://kajidata.artonlabs.com/v1/news:gdelt/search?"+params.Encode(), nil)
req.Header.Set("x-api-key", "ga_live_...")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
var body map[string]any
json.NewDecoder(res.Body).Decode(&body)
fmt.Println(body["data"])
}
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://kajidata.artonlabs.com/v1/news:gdelt/search?q=inflation&limit=5&country=indonesia"))
.header("x-api-key", "ga_live_...")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
Ruby
require "net/http"
require "json"
uri = URI("https://kajidata.artonlabs.com/v1/news:gdelt/search")
uri.query = URI.encode_www_form({"q" => "inflation", "limit" => "5", "country" => "indonesia"})
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "ga_live_..."
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
body = JSON.parse(response.body)
puts body["ok"] ? body["data"] : body["error"]
C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "ga_live_...");
var json = await client.GetStringAsync("https://kajidata.artonlabs.com/v1/news:gdelt/search?q=inflation&limit=5&country=indonesia");
Console.WriteLine(json);GET/v1/news:gdelt/tone
Average daily news tone, machine-scored by GDELT. Below 0 leans negative.
Cache 21600 s
1 quota / request
news.gdelt.tone
cURL
curl -H "x-api-key: ga_live_..." "https://kajidata.artonlabs.com/v1/news:gdelt/tone?q=inflation&country=indonesia"
Python
import requests
response = requests.get(
"https://kajidata.artonlabs.com/v1/news:gdelt/tone",
params={"q": "inflation", "country": "indonesia"},
headers={"x-api-key": "ga_live_..."},
timeout=30,
)
body = response.json()
print(body["data"] if body["ok"] else body["error"])
JavaScript
const params = new URLSearchParams({"q": "inflation", "country": "indonesia"});
const response = await fetch(`https://kajidata.artonlabs.com/v1/news:gdelt/tone?${params}`, {
headers: { "x-api-key": "ga_live_..." },
});
const body = await response.json();
console.log(body.ok ? body.data : body.error);
PHP
<?php
$ch = curl_init('https://kajidata.artonlabs.com/v1/news:gdelt/tone?' . http_build_query(['q' => 'inflation', 'country' => 'indonesia']));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ga_live_...'],
CURLOPT_TIMEOUT => 30,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($body['ok'] ? $body['data'] : $body['error']);
Go
package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("q", "inflation")
params.Set("country", "indonesia")
req, _ := http.NewRequest("GET", "https://kajidata.artonlabs.com/v1/news:gdelt/tone?"+params.Encode(), nil)
req.Header.Set("x-api-key", "ga_live_...")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
var body map[string]any
json.NewDecoder(res.Body).Decode(&body)
fmt.Println(body["data"])
}
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://kajidata.artonlabs.com/v1/news:gdelt/tone?q=inflation&country=indonesia"))
.header("x-api-key", "ga_live_...")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
Ruby
require "net/http"
require "json"
uri = URI("https://kajidata.artonlabs.com/v1/news:gdelt/tone")
uri.query = URI.encode_www_form({"q" => "inflation", "country" => "indonesia"})
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "ga_live_..."
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
body = JSON.parse(response.body)
puts body["ok"] ? body["data"] : body["error"]
C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "ga_live_...");
var json = await client.GetStringAsync("https://kajidata.artonlabs.com/v1/news:gdelt/tone?q=inflation&country=indonesia");
Console.WriteLine(json);