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

import requests

url = "https://gdeltcloud.com/api/v2/share-of-voice"

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/share-of-voice', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "available_live",
  "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": [],
  "coverage": {
    "observed_entities": [
      "wikipedia:en:Saudi_Aramco",
      "wikipedia:en:Tesla,_Inc."
    ],
    "not_observed_entities": [],
    "note": "All requested entities were observed in the denominator."
  },
  "denominator": {
    "hash": "d41f2c8a6b9e0357",
    "scope": {
      "category": "energy",
      "languages": [],
      "source_set": [],
      "countries": [],
      "regions": [],
      "topic": ""
    },
    "unit": "story",
    "validation": "accepted",
    "source": "live_query",
    "total_story_count": 4820,
    "total_article_count": 38917,
    "total_weight": 41263,
    "search_mode": "structured_filters",
    "semantic_min_score": null,
    "semantic_candidate_limit": null,
    "semantic_truncated": false
  },
  "rows": [
    {
      "run_id": "",
      "bucket_date": "2026-06-15",
      "canonical_entity_id": "wikipedia:en:Saudi_Aramco",
      "display_name": "Saudi Aramco",
      "entity_type": "organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Saudi_Aramco",
      "entity_status": "active",
      "denominator_hash": "d41f2c8a6b9e0357",
      "denominator_profile_json": "{\"scope\":{\"category\":\"energy\"},\"start_date\":\"2026-06-01\",\"end_date\":\"2026-06-28\"}",
      "denominator_story_count": 172,
      "denominator_article_count": 1389,
      "denominator_weight": 1474,
      "entity_story_count": 17,
      "entity_article_count": 142,
      "entity_weight": 151,
      "story_share": 0.0988,
      "article_share": 0.1022,
      "weighted_share": 0.1024,
      "avg_tone_score": 12.4,
      "avg_risk_score": 28.7,
      "tone_coverage_ratio": 0.88,
      "coverage_warnings": []
    },
    {
      "run_id": "",
      "bucket_date": "2026-06-15",
      "canonical_entity_id": "wikipedia:en:Tesla,_Inc.",
      "display_name": "Tesla, Inc.",
      "entity_type": "organization",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Tesla,_Inc.",
      "entity_status": "active",
      "denominator_hash": "d41f2c8a6b9e0357",
      "denominator_profile_json": "{\"scope\":{\"category\":\"energy\"},\"start_date\":\"2026-06-01\",\"end_date\":\"2026-06-28\"}",
      "denominator_story_count": 172,
      "denominator_article_count": 1389,
      "denominator_weight": 1474,
      "entity_story_count": 9,
      "entity_article_count": 71,
      "entity_weight": 74,
      "story_share": 0.0523,
      "article_share": 0.0511,
      "weighted_share": 0.0502,
      "avg_tone_score": -8.2,
      "avg_risk_score": 41.3,
      "tone_coverage_ratio": 0.78,
      "coverage_warnings": [
        "tone_not_yet_scored"
      ]
    }
  ],
  "methodology": {
    "default_metric": "story_share",
    "denominator_required": true,
    "note": "Share of voice is share of a DEFINED conversation (the denominator). A 0% share means the entity was not observed within this denominator — for a semantic denominator, its coverage fell below the similarity threshold — NOT that the entity is absent from the news; see coverage.not_observed_entities. V2 computes live denominators from story/event/article filters and joins canonical resolved entity-story links. Tone and risk fields are optional context when entity-tone rows exist; SOV itself remains count/share based."
  }
}

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

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

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