Save a query
curl --request POST \
--url https://gdeltcloud.com/api/v2/saved-queries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"params": {},
"time_spec": {
"mode": "none"
}
}
'import requests
url = "https://gdeltcloud.com/api/v2/saved-queries"
payload = {
"title": "<string>",
"params": {},
"time_spec": { "mode": "none" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({title: '<string>', params: {}, time_spec: {mode: 'none'}})
};
fetch('https://gdeltcloud.com/api/v2/saved-queries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"title": "US Events last week",
"endpoint_family": "events",
"params": {
"country": "USA"
},
"time_spec": {
"mode": "rolling",
"days": 7,
"timezone": "UTC"
},
"display": {},
"visibility": "private",
"pinned": false,
"contract_version": 1,
"id": "11111111-1111-4111-8111-111111111111",
"user_id": "22222222-2222-4222-8222-222222222222",
"org_id": null,
"created_at": "2026-10-01T12:00:00Z",
"updated_at": "2026-10-01T12:00:00Z",
"last_opened_at": null
}
}Saved Queries
Save a query
Saves validated filters and a fixed or rolling UTC time specification. Private by default; workspace sharing uses the authenticated current workspace. Authentication fields, results and pagination are not supported. Do not put secrets in query text.
POST
/
api
/
v2
/
saved-queries
Save a query
curl --request POST \
--url https://gdeltcloud.com/api/v2/saved-queries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"params": {},
"time_spec": {
"mode": "none"
}
}
'import requests
url = "https://gdeltcloud.com/api/v2/saved-queries"
payload = {
"title": "<string>",
"params": {},
"time_spec": { "mode": "none" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({title: '<string>', params: {}, time_spec: {mode: 'none'}})
};
fetch('https://gdeltcloud.com/api/v2/saved-queries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"title": "US Events last week",
"endpoint_family": "events",
"params": {
"country": "USA"
},
"time_spec": {
"mode": "rolling",
"days": 7,
"timezone": "UTC"
},
"display": {},
"visibility": "private",
"pinned": false,
"contract_version": 1,
"id": "11111111-1111-4111-8111-111111111111",
"user_id": "22222222-2222-4222-8222-222222222222",
"org_id": null,
"created_at": "2026-10-01T12:00:00Z",
"updated_at": "2026-10-01T12:00:00Z",
"last_opened_at": null
}
}Authorizations
Body
application/json
⌘I

