curl --request GET \
  --url https://gdeltcloud.com/api/v2/entities/{entity_id}/tone \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://gdeltcloud.com/api/v2/entities/{entity_id}/tone"

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/entities/{entity_id}/tone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "available",
  "start_date": "2026-06-01",
  "end_date": "2026-06-28",
  "entities": [
    "wikipedia:en:Saudi_Aramco"
  ],
  "resolved_entities": [
    {
      "input": "Saudi Aramco",
      "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"
    }
  ],
  "unresolved_terms": [],
  "entity_coverage": [
    {
      "canonical_entity_id": "wikipedia:en:Saudi_Aramco",
      "display_name": "Saudi Aramco",
      "entity_type": "organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Saudi_Aramco",
      "tone_status": "scored",
      "row_count": 28,
      "candidate_story_count": 213,
      "candidate_article_count": 1486,
      "candidate_mention_count": 2741,
      "scored_story_count": 188
    }
  ],
  "rows": [
    {
      "canonical_entity_id": "wikipedia:en:Saudi_Aramco",
      "display_name": "Saudi Aramco",
      "entity_type": "organization",
      "bucket_date": "2026-06-14",
      "bucket_granularity": "day",
      "denominator_hash": "",
      "candidate_story_count": 12,
      "scored_story_count": 11,
      "scored_article_count": 86,
      "insufficient_evidence_count": 1,
      "needs_review_count": 0,
      "avg_tone_score": 9.6,
      "avg_risk_score": 25.1,
      "avg_confidence": 0.83,
      "coverage_ratio": 0.91,
      "agreement_score": 0.77,
      "languages": [
        "en",
        "ar"
      ],
      "top_positive_story_ids": [
        "20260614-aramco-upstream-expansion"
      ],
      "top_negative_story_ids": [],
      "top_risky_story_ids": [
        "20260614-aramco-pipeline-incident"
      ]
    },
    {
      "canonical_entity_id": "wikipedia:en:Saudi_Aramco",
      "display_name": "Saudi Aramco",
      "entity_type": "organization",
      "bucket_date": "2026-06-15",
      "bucket_granularity": "day",
      "denominator_hash": "",
      "candidate_story_count": 17,
      "scored_story_count": 15,
      "scored_article_count": 112,
      "insufficient_evidence_count": 1,
      "needs_review_count": 1,
      "avg_tone_score": 12.4,
      "avg_risk_score": 28.7,
      "avg_confidence": 0.81,
      "coverage_ratio": 0.88,
      "agreement_score": 0.74,
      "languages": [
        "en",
        "ar",
        "fr"
      ],
      "top_positive_story_ids": [
        "20260615-aramco-dividend-raise",
        "20260615-aramco-lng-deal"
      ],
      "top_negative_story_ids": [
        "20260615-aramco-emissions-report"
      ],
      "top_risky_story_ids": [
        "20260615-aramco-emissions-report"
      ]
    }
  ],
  "methodology": {
    "unit": "entity-story rollups over article-entity evidence",
    "tone_score": "-100..100 media tone toward the entity; not direct public opinion",
    "risk_score": "0..100 reputational or issue-risk severity, separate from tone direction",
    "missing_tone": "missing or insufficient evidence is unavailable, not neutral"
  }
}

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

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

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