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