curl -X GET "https://api.hooked.so/v1/social/account/clx123abc" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/account/clx123abc',
headers={'x-api-key': 'your_api_key_here'}
)
account = response.json()['data']
print(f"Top video: {account['topVideos'][0]['title']}")
{
"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"
}
}
Social Accounts
Account Details
Get detailed information about an analyzed account
GET
/
v1
/
social
/
account
/
{accountId}
curl -X GET "https://api.hooked.so/v1/social/account/clx123abc" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/account/clx123abc',
headers={'x-api-key': 'your_api_key_here'}
)
account = response.json()['data']
print(f"Top video: {account['topVideos'][0]['title']}")
{
"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
string
required
The internal account ID (obtained from the list or analyze endpoints)
Response
boolean
Indicates if the request was successful
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.so/v1/social/account/clx123abc" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/account/clx123abc',
headers={'x-api-key': 'your_api_key_here'}
)
account = response.json()['data']
print(f"Top video: {account['topVideos'][0]['title']}")
{
"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.⌘I