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

{
  "success": true,
  "message": "Account refreshed successfully",
  "data": {
    "account": {
      "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": 1520000,
        "following": 252,
        "videos": 348,
        "likes": 46500000
      },
      "analytics": {
        "engagementRate": 12.8,
        "viralityScore": 79.1,
        "avgViews": 920000
      },
      "lastAnalyzed": "2024-01-16T10:30:00Z",
      "profileUrl": "https://www.tiktok.com/@fitnessguru"
    }
  }
}

​
Overview

This endpoint refreshes an analyzed account with the latest data from the platform. Use this to update follower counts, engagement metrics, and discover new content.

​
Path Parameters

​
accountId
string
required
The internal account ID to refresh

​
Response

​
success
boolean
Indicates if the request was successful
​
message
string
Status message
​
data
object
curl -X POST "https://api.hooked.so/v1/social/account/clx123abc/refresh" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "message": "Account refreshed successfully",
  "data": {
    "account": {
      "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": 1520000,
        "following": 252,
        "videos": 348,
        "likes": 46500000
      },
      "analytics": {
        "engagementRate": 12.8,
        "viralityScore": 79.1,
        "avgViews": 920000
      },
      "lastAnalyzed": "2024-01-16T10:30:00Z",
      "profileUrl": "https://www.tiktok.com/@fitnessguru"
    }
  }
}
Refreshing an account will scrape the latest data from the platform and may consume API credits.
Set up a scheduled refresh to track account growth over time. Consider refreshing accounts weekly to monitor performance trends.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
accountId
string
required

Response

200

Account refreshed successfully