curl --request POST \
  --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.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', 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",
    "status": "queued",
    "poll_url": "/api/v2/entity-tone/runs/entity-tone-v2-3f9c1b2a-7d4e-4a51-9c83-1e6b2f0a55d1",
    "confirm_required": false,
    "entity_ids": [
      "wikipedia:en:Saudi_Aramco"
    ],
    "resolved_entities": [
      {
        "canonical_entity_id": "wikipedia:en:Saudi_Aramco",
        "display_name": "Saudi Aramco",
        "entity_type": "organization",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Saudi_Aramco",
        "match_type": "exact_alias",
        "confidence": 0.98
      }
    ],
    "window": {
      "start_date": "2026-06-01",
      "end_date": "2026-06-28"
    },
    "candidate_story_count": 213,
    "candidate_article_count": 1486,
    "queued_case_count": 188,
    "estimated_query_units": 23,
    "charged_query_units": 0,
    "estimated_cost_usd": 0.1704,
    "note": "Run queued in the V2 entity-tone side pipeline. Scoring is asynchronous and cached rows become available through /api/v2/entity-tone."
  }
}

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

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

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