curl -X POST "https://api.hooked.so/v1/social/account/analyze" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "username": "fitnessguru", "platform": "tiktok" }'

const response = await fetch('https://api.hooked.so/v1/social/account/analyze', {
  method: 'POST',
  headers: {
    'x-api-key': 'your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ username: '@fitnessguru', platform: 'tiktok' })
});

const { data } = await response.json();
console.log(data.account.id, data.account.analytics);

import requests

response = requests.post(
    'https://api.hooked.so/v1/social/account/analyze',
    headers={'x-api-key': 'your_api_key_here'},
    json={'username': 'fitnessguru', 'platform': 'youtube'},
    timeout=300
)

account = response.json()['data']['account']
print(account['id'], account['stats']['followers'])

{
  "success": true,
  "message": "Account analyzed successfully",
  "data": {
    "account": {
      "id": "cm7g8h9i0j1k2l3m4n5o6p7q8",
      "username": "fitnessguru",
      "platform": "tiktok",
      "displayName": "Fitness Guru",
      "bio": "Helping you get fit one video at a time",
      "avatarUrl": "https://p16-sign.tiktokcdn.com/...",
      "isVerified": true,
      "stats": {
        "followers": 1500000,
        "following": 250,
        "videos": 342,
        "likes": 45000000
      },
      "analytics": {
        "engagementRate": 12.5,
        "viralityScore": 78.3,
        "avgViews": 890000
      },
      "topHashtags": [
        {
          "hashtag": "#fitness",
          "name": "fitness",
          "count": 48,
          "videoCount": 48,
          "totalViews": 21000000,
          "avgViews": 437500,
          "engagementRate": 11.2,
          "trending": false,
          "lastUsed": "2026-09-28T18:00:00.000Z"
        }
      ],
      "keywords": [],
      "lastAnalyzed": "2026-10-01T10:30:00.000Z",
      "createdAt": "2026-10-01T10:30:00.000Z",
      "profileUrl": "https://www.tiktok.com/@fitnessguru"
    }
  }
}

{
  "code": "bad_request",
  "message": "Invalid input",
  "errorCode": "INVALID_INPUT",
  "details": { "platform": ["platform must be 'tiktok' or 'youtube'"] }
}

{
  "success": false,
  "errorCode": "INSUFFICIENT_CREDITS",
  "message": "Not enough credits to perform this action"
}