Skip to main content
GET
/
v1
/
social
/
account
/
list
curl -X GET "https://api.hooked.ai/v1/social/account/list?platform=tiktok" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "accounts": [
      {
        "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
        },
        "topHashtags": ["fitness", "workout", "gym"],
        "keywords": ["fitness", "exercise", "motivation"],
        "keywordsStatus": "completed",
        "lastAnalyzed": "2024-01-15T10:30:00Z",
        "createdAt": "2024-01-01T00:00:00Z",
        "profileUrl": "https://www.tiktok.com/@fitnessguru"
      }
    ],
    "total": 15,
    "limit": 50,
    "offset": 0
  }
}

​
Overview

This endpoint returns all social media accounts that have been analyzed by your team. Use this to view your saved creators and their analytics.

​
Query Parameters

​
platform
string
Filter by platform:
  • tiktok: TikTok accounts only
  • youtube: YouTube accounts only
  • Omit to get accounts from all platforms
​
limit
number
default:"50"
Number of accounts to return (1-100)
​
offset
number
default:"0"
Pagination offset

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl -X GET "https://api.hooked.ai/v1/social/account/list?platform=tiktok" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "accounts": [
      {
        "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
        },
        "topHashtags": ["fitness", "workout", "gym"],
        "keywords": ["fitness", "exercise", "motivation"],
        "keywordsStatus": "completed",
        "lastAnalyzed": "2024-01-15T10:30:00Z",
        "createdAt": "2024-01-01T00:00:00Z",
        "profileUrl": "https://www.tiktok.com/@fitnessguru"
      }
    ],
    "total": 15,
    "limit": 50,
    "offset": 0
  }
}
Use the Analyze Account endpoint to add new accounts to your analysis list.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
platform
enum<string>
Available options:
tiktok,
youtube
​
limit
integer
default:50
​
offset
integer
default:0

Response

200

Success