Skip to main content
GET
/
v1
/
social
/
account
/
{accountId}
curl -X GET "https://api.hooked.ai/v1/social/account/clx123abc" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "id": "clx123abc",
    "username": "fitnessguru",
    "platform": "tiktok",
    "displayName": "Fitness Guru",
    "bio": "Helping you get fit one video at a time",
    "avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
    "isVerified": true,
    "stats": {
      "followers": 1500000,
      "following": 250,
      "videos": 342,
      "likes": 45000000
    },
    "analytics": {
      "engagementRate": 12.5,
      "viralityScore": 78.3,
      "avgViews": 890000,
      "shareRate": 2.3,
      "saveRate": 4.1
    },
    "topHashtags": ["fitness", "workout", "gym", "motivation", "health"],
    "topMusic": ["Workout Beats", "Gym Motivation", "Running Mix"],
    "keywords": ["fitness", "exercise", "motivation", "health"],
    "keywordsStatus": "completed",
    "audience": {
      "ageGroups": ["18-24", "25-34"],
      "interests": ["fitness", "health", "lifestyle"]
    },
    "postingTimes": [
      { "day": "Monday", "hour": 9, "engagement": 15.2 },
      { "day": "Wednesday", "hour": 18, "engagement": 18.5 }
    ],
    "topVideos": [
      {
        "id": "video123",
        "externalId": "7234567890123456789",
        "title": "5 minute ab workout",
        "thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
        "views": 5400000,
        "likes": 890000,
        "viralScore": 92.5,
        "publishedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "lastAnalyzed": "2024-01-15T10:30:00Z",
    "createdAt": "2024-01-01T00:00:00Z",
    "profileUrl": "https://www.tiktok.com/@fitnessguru"
  }
}

​
Overview

This endpoint returns detailed information about a specific analyzed account, including their top performing videos and complete analytics.

​
Path Parameters

​
accountId
string
required
The internal account ID (obtained from the list or analyze endpoints)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
Complete account details including:
  • Profile information (username, display name, bio, avatar)
  • Verification status
  • Statistics (followers, following, videos, likes)
  • Analytics (engagement rate, virality score, average views, share rate, save rate)
  • Top hashtags, music, and keywords
  • Audience insights
  • Posting times analysis
  • Top 20 performing videos
  • Profile URL
curl -X GET "https://api.hooked.ai/v1/social/account/clx123abc" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "id": "clx123abc",
    "username": "fitnessguru",
    "platform": "tiktok",
    "displayName": "Fitness Guru",
    "bio": "Helping you get fit one video at a time",
    "avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
    "isVerified": true,
    "stats": {
      "followers": 1500000,
      "following": 250,
      "videos": 342,
      "likes": 45000000
    },
    "analytics": {
      "engagementRate": 12.5,
      "viralityScore": 78.3,
      "avgViews": 890000,
      "shareRate": 2.3,
      "saveRate": 4.1
    },
    "topHashtags": ["fitness", "workout", "gym", "motivation", "health"],
    "topMusic": ["Workout Beats", "Gym Motivation", "Running Mix"],
    "keywords": ["fitness", "exercise", "motivation", "health"],
    "keywordsStatus": "completed",
    "audience": {
      "ageGroups": ["18-24", "25-34"],
      "interests": ["fitness", "health", "lifestyle"]
    },
    "postingTimes": [
      { "day": "Monday", "hour": 9, "engagement": 15.2 },
      { "day": "Wednesday", "hour": 18, "engagement": 18.5 }
    ],
    "topVideos": [
      {
        "id": "video123",
        "externalId": "7234567890123456789",
        "title": "5 minute ab workout",
        "thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
        "views": 5400000,
        "likes": 890000,
        "viralScore": 92.5,
        "publishedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "lastAnalyzed": "2024-01-15T10:30:00Z",
    "createdAt": "2024-01-01T00:00:00Z",
    "profileUrl": "https://www.tiktok.com/@fitnessguru"
  }
}
Use the topVideos data to understand what content performs best for this creator and apply similar strategies to your own content.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
accountId
string
required

Response

200

Success