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

import requests

url = "https://gdeltcloud.com/api/v2/social"

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

{
  "success": true,
  "status": "available",
  "data": {
    "entity": "Tesla",
    "window_days": 7,
    "mention_count": 342,
    "total_engagement": 18764,
    "posts": [
      {
        "text": "Tesla Q2 deliveries beat expectations again — strong quarter for the bulls. $TSLA",
        "handle": "evanalyst.bsky.social",
        "created_at": "2026-06-27T15:42:11.000Z",
        "likes": 1284,
        "reposts": 326,
        "replies": 188,
        "uri": "at://did:plc:7q3v2m9x8k1c4b6n0d5f2g8h/app.bsky.feed.post/3kx9a2b7c1d2e",
        "lang": "en"
      },
      {
        "text": "New Tesla recall on Autopilot software raises fresh safety questions for regulators.",
        "handle": "newswire.bsky.social",
        "created_at": "2026-06-26T09:18:03.000Z",
        "likes": 642,
        "reposts": 410,
        "replies": 233,
        "uri": "at://did:plc:1a2b3c4d5e6f7g8h9i0j1k2l/app.bsky.feed.post/3kx7p4q9r2s3t",
        "lang": "en"
      }
    ],
    "sentiment": {
      "score": -0.118,
      "label": "neutral"
    },
    "source": "bluesky"
  },
  "methodology": {
    "source": "Bluesky (AT Protocol) full-network post search (app.bsky.feed.searchPosts)",
    "mention_count": "retrieved post count within window — indicative, not exhaustive",
    "sentiment": "naive lexicon scoring — indicative only; not a calibrated tone model",
    "coverage_note": "strong for news/politics/companies/policy; thin for granular physical assets + non-English entities"
  }
}

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

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

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