Extraiga la lista de seguidores de un usuario de TikTok a través de la API de Scavio a $0,005/página de 20 seguidores. Cada seguidor incluye nombre de usuario, recuento de seguidores, recuento de vídeos y sec_uid. Utiliza paginación page_token+min_time exclusiva para los puntos finales de gráficos sociales.
Requisitos previos
- Clave API de Scavio
- sec_uid del usuario objetivo
- Python 3.8+ o Node.js 18+
Guia paso a paso
Paso 1: Obtener sec_uid del perfil
Primero busque el sec_uid del usuario objetivo.
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
profile = requests.post('https://api.scavio.dev/api/v1/tiktok/profile',
headers=HEADERS, json={'username': 'target_user'}).json()
sec_uid = profile['data']['user']['sec_uid']Paso 2: Obtener seguidores
Llame al punto final de seguidores con la paginación page_token.
Python
resp = requests.post('https://api.scavio.dev/api/v1/tiktok/user/followers',
headers=HEADERS,
json={'sec_user_id': sec_uid, 'count': 20})
data = resp.json()['data']
for f in data.get('followers', []):
print(f"@{f['unique_id']}: {f['follower_count']:,} followers")Paso 3: Paginar con page_token + min_time
Tanto page_token como min_time son necesarios para las páginas siguientes.
Python
if data.get('has_more'):
page2 = requests.post(
'https://api.scavio.dev/api/v1/tiktok/user/followers',
headers=HEADERS,
json={'sec_user_id': sec_uid, 'count': 20,
'page_token': data['next_page_token'],
'min_time': data['min_time']}).json()['data']
print(f'Page 2: {len(page2.get("followers", []))} followers')Ejemplo en Python
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
def get_followers(sec_uid, max_pages=10):
followers = []
params = {'sec_user_id': sec_uid, 'count': 20}
for _ in range(max_pages):
data = requests.post('https://api.scavio.dev/api/v1/tiktok/user/followers',
headers=HEADERS, json=params).json()['data']
followers.extend(data.get('followers', []))
if not data.get('has_more'):
break
params['page_token'] = data['next_page_token']
params['min_time'] = data['min_time']
return followers
# Get sec_uid first
profile = requests.post('https://api.scavio.dev/api/v1/tiktok/profile',
headers=HEADERS, json={'username': 'target_user'}).json()
followers = get_followers(profile['data']['user']['sec_uid'])
print(f'{len(followers)} followers sampled')Ejemplo en JavaScript
JavaScript
const H = {'Authorization': `Bearer ${process.env.SCAVIO_API_KEY}`, 'Content-Type': 'application/json'};
async function getFollowers(secUid, maxPages = 10) {
const followers = [];
let params = {sec_user_id: secUid, count: 20};
for (let i = 0; i < maxPages; i++) {
const r = await fetch('https://api.scavio.dev/api/v1/tiktok/user/followers', {
method: 'POST', headers: H, body: JSON.stringify(params)
}).then(r => r.json());
followers.push(...(r.data.followers || []));
if (!r.data.has_more) break;
params.page_token = r.data.next_page_token;
params.min_time = r.data.min_time;
}
return followers;
}
// Usage: getFollowers(secUid).then(f => console.log(`${f.length} followers`));Salida esperada
JSON
Array of follower objects with username, follower count, video count, and sec_uid for each follower.