curl -X POST "https://api.hooked.so/v1/social/account/clx123abc/refresh" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc/refresh', {
method: 'POST',
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log('Account refreshed:', data.data.account);
import requests
response = requests.post(
'https://api.hooked.so/v1/social/account/clx123abc/refresh',
headers={'x-api-key': 'your_api_key_here'}
)
account = response.json()['data']['account']
print(f"Updated followers: {account['stats']['followers']}")
{
"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"
}
}
}
Social Accounts
Refresh Account
Refresh account data with latest information from the platform
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"
const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc/refresh', {
method: 'POST',
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log('Account refreshed:', data.data.account);
import requests
response = requests.post(
'https://api.hooked.so/v1/social/account/clx123abc/refresh',
headers={'x-api-key': 'your_api_key_here'}
)
account = response.json()['data']['account']
print(f"Updated followers: {account['stats']['followers']}")
{
"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
string
required
The internal account ID to refresh
Response
boolean
Indicates if the request was successful
string
Status message
curl -X POST "https://api.hooked.so/v1/social/account/clx123abc/refresh" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc/refresh', {
method: 'POST',
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log('Account refreshed:', data.data.account);
import requests
response = requests.post(
'https://api.hooked.so/v1/social/account/clx123abc/refresh',
headers={'x-api-key': 'your_api_key_here'}
)
account = response.json()['data']['account']
print(f"Updated followers: {account['stats']['followers']}")
{
"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.
⌘I