Recherchez des utilisateurs TikTok par mot-clé via l'API Scavio à 0,005 $/requête. Le point de terminaison search/users renvoie les profils de créateurs correspondant à votre requête, permettant une découverte programmatique d'influenceurs par niche, sujet ou nom de marque.
Prérequis
- Clé API Scavio
- Python 3.8+ ou Node.js 18+
- Mot-clé ou niche cible
Parcours
Étape 1: Rechercher des utilisateurs
Appelez le point de terminaison search/users avec un mot-clé.
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
resp = requests.post('https://api.scavio.dev/api/v1/tiktok/search/users',
headers=HEADERS,
json={'keyword': 'fitness coach', 'count': 20, 'cursor': 0})
users = resp.json()['data'].get('users', [])
for u in users:
print(f"@{u['unique_id']} | {u['follower_count']:,} followers")Étape 2: Filtrer par nombre d'abonnés
Filtrez les résultats de recherche pour trouver des micro-influenceurs dans votre fourchette cible.
Python
micro_influencers = [u for u in users
if 10_000 <= u['follower_count'] <= 100_000]
print(f'{len(micro_influencers)} micro-influencers found')
for u in micro_influencers:
print(f" @{u['unique_id']}: {u['follower_count']:,} followers")Exemple Python
Python
import requests, os
HEADERS = {'Authorization': f'Bearer {os.environ["SCAVIO_API_KEY"]}',
'Content-Type': 'application/json'}
def search_creators(keyword, min_followers=10000, max_followers=100000, pages=3):
creators = []
cursor = 0
for _ in range(pages):
resp = requests.post('https://api.scavio.dev/api/v1/tiktok/search/users',
headers=HEADERS,
json={'keyword': keyword, 'count': 20, 'cursor': cursor}).json()['data']
for u in resp.get('users', []):
if min_followers <= u.get('follower_count', 0) <= max_followers:
creators.append({'username': u['unique_id'],
'followers': u['follower_count'], 'sec_uid': u['sec_uid']})
if not resp.get('has_more'):
break
cursor = resp['cursor']
return creators
creators = search_creators('skincare routine')
print(f'{len(creators)} micro-influencers in skincare')Exemple JavaScript
JavaScript
const H = {'Authorization': `Bearer ${process.env.SCAVIO_API_KEY}`, 'Content-Type': 'application/json'};
async function searchCreators(keyword, minF = 10000, maxF = 100000) {
const creators = [];
let cursor = 0;
for (let i = 0; i < 3; i++) {
const r = await fetch('https://api.scavio.dev/api/v1/tiktok/search/users', {
method: 'POST', headers: H,
body: JSON.stringify({keyword, count: 20, cursor})
}).then(r => r.json());
(r.data.users || []).forEach(u => {
if (u.follower_count >= minF && u.follower_count <= maxF)
creators.push({username: u.unique_id, followers: u.follower_count});
});
if (!r.data.has_more) break;
cursor = r.data.cursor;
}
return creators;
}
searchCreators('skincare routine').then(c => console.log(`${c.length} creators`));Sortie attendue
JSON
Filtered list of TikTok creators matching the keyword with follower counts within the specified range.