curl --request GET \
  --url https://gdeltcloud.com/api/v2/entity-tone/runs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://gdeltcloud.com/api/v2/entity-tone/runs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/entity-tone/runs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "run_id": "entity-tone-v2-3f9c1b2a-7d4e-4a51-9c83-1e6b2f0a55d1",
      "run_type": "entity_tone",
      "status": "succeeded",
      "request_source": "api",
      "requester_user_id": "a1d4f7c2-9b3e-4c08-8f21-6d5b0e9a3c47",
      "requester_email": "",
      "request_json": "{\"entity_ids\":[\"wikipedia:en:Saudi_Aramco\"],\"start_date\":\"2026-06-01\",\"end_date\":\"2026-06-28\",\"filters\":{}}",
      "denominator_hash": "c0ffee7a1b2c3d4e",
      "start_date": "2026-06-01",
      "end_date": "2026-06-28",
      "target_entity_count": 1,
      "candidate_story_count": 213,
      "scored_case_count": 188,
      "estimated_query_units": 23,
      "charged_query_units": 23,
      "estimated_cost_usd": 0.1704,
      "error": "",
      "created_at": "2026-06-28 14:22:07",
      "updated_at": "2026-06-28 14:41:55"
    },
    {
      "run_id": "entity-tone-v2-8b71e4d0-2a16-4f93-bc55-9aa0c7e21f08",
      "run_type": "entity_tone",
      "status": "queued",
      "request_source": "api",
      "requester_user_id": "a1d4f7c2-9b3e-4c08-8f21-6d5b0e9a3c47",
      "requester_email": "",
      "request_json": "{\"entity_ids\":[\"wikipedia:en:Tesla,_Inc.\"],\"start_date\":\"2026-06-20\",\"end_date\":\"2026-06-28\",\"filters\":{}}",
      "denominator_hash": "9a8b7c6d5e4f3021",
      "start_date": "2026-06-20",
      "end_date": "2026-06-28",
      "target_entity_count": 1,
      "candidate_story_count": 642,
      "scored_case_count": 0,
      "estimated_query_units": 66,
      "charged_query_units": 0,
      "estimated_cost_usd": 0.5136,
      "error": "",
      "created_at": "2026-06-29 09:03:12",
      "updated_at": "2026-06-29 09:03:12"
    }
  ],
  "pagination": {
    "limit": 25,
    "cursor": null,
    "next_cursor": null,
    "has_more": false
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}