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

import requests

url = "https://gdeltcloud.com/api/v2/entity-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/entity-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",
    "wikipedia:en:Tesla,_Inc."
  ],
  "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"
    },
    {
      "input": "Tesla",
      "canonical_entity_id": "wikipedia:en:Tesla,_Inc.",
      "display_name": "Tesla, Inc.",
      "entity_type": "organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Tesla,_Inc.",
      "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": 14,
      "candidate_story_count": 213,
      "candidate_article_count": 1486,
      "candidate_mention_count": 2741,
      "scored_story_count": 188
    },
    {
      "canonical_entity_id": "wikipedia:en:Tesla,_Inc.",
      "display_name": "Tesla, Inc.",
      "entity_type": "organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Tesla,_Inc.",
      "tone_status": "scored",
      "row_count": 21,
      "candidate_story_count": 642,
      "candidate_article_count": 5310,
      "candidate_mention_count": 9874,
      "scored_story_count": 604
    }
  ],
  "rows": [
    {
      "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"
      ]
    },
    {
      "canonical_entity_id": "wikipedia:en:Tesla,_Inc.",
      "display_name": "Tesla, Inc.",
      "entity_type": "organization",
      "bucket_date": "2026-06-15",
      "bucket_granularity": "day",
      "denominator_hash": "",
      "candidate_story_count": 53,
      "scored_story_count": 49,
      "scored_article_count": 401,
      "insufficient_evidence_count": 2,
      "needs_review_count": 2,
      "avg_tone_score": -8.2,
      "avg_risk_score": 41.3,
      "avg_confidence": 0.79,
      "coverage_ratio": 0.92,
      "agreement_score": 0.68,
      "languages": [
        "en",
        "de",
        "zh"
      ],
      "top_positive_story_ids": [
        "20260615-tesla-q2-deliveries-beat"
      ],
      "top_negative_story_ids": [
        "20260615-tesla-recall-autopilot",
        "20260615-tesla-margin-pressure"
      ],
      "top_risky_story_ids": [
        "20260615-tesla-recall-autopilot"
      ]
    }
  ],
  "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": {}
}