Aperçu
Les équipes marketing d'influenceurs examinent manuellement les profils des créateurs, passant des heures par candidat. Ce workflow automatise la vérification quotidienne des candidats créateurs : récupérer les profils, analyser les taux d'engagement, vérifier la cohérence des publications et signaler les drapeaux rouges. Vérifier 20 créateurs par jour pour 3 $ (profil + publications récentes par créateur).
Déclencheur
Cron quotidien à 9h UTC ou déclenché lorsque de nouveaux créateurs sont ajoutés à la liste des candidats.
Planification
Tous les jours à 9h UTC
Étapes du workflow
Charger la liste des créateurs candidats
Lire la liste des noms d'utilisateurs TikTok à vérifier depuis la base de données ou le tableur. Chaque entrée inclut le nom d'utilisateur du créateur et la campagne pour laquelle il est considéré.
Récupérer les profils des créateurs
Récupérer le profil de chaque créateur via l'API TikTok. Extraire le nombre d'abonnés, le total de likes, le nombre de vidéos et les informations de la bio.
Analyser le contenu récent
Récupérer les 20 dernières publications de chaque créateur. Calculer la moyenne des vues, le taux d'engagement et la fréquence de publication.
Noter et signaler les problèmes
Noter chaque créateur sur son taux d'engagement, sa cohérence et le ratio abonnés/engagement. Signaler les potentiels faux abonnés ou publications irrégulières.
Générer le rapport de vérification
Compiler un rapport classé de tous les créateurs vérifiés avec notes, signalements et recommandations pour l'équipe marketing.
Implémentation Python
import requests, os
API_KEY = os.environ["SCAVIO_API_KEY"]
TT_H = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
def vet_creator(username: str) -> dict:
# Profile
profile = requests.post(
"https://api.scavio.dev/api/v1/tiktok/profile",
headers=TT_H, json={"username": username}, timeout=15,
).json()
stats = profile.get("user_info", {}).get("stats", {})
followers = stats.get("follower_count", 0)
# Recent posts
posts = requests.post(
"https://api.scavio.dev/api/v1/tiktok/user-posts",
headers=TT_H, json={"username": username}, timeout=15,
).json().get("videos", [])
avg_views = sum(v.get("stats", {}).get("play_count", 0) for v in posts) / max(len(posts), 1)
engagement = avg_views / max(followers, 1)
flags = []
if engagement < 0.01:
flags.append("low_engagement")
if followers > 100000 and engagement < 0.005:
flags.append("possible_fake_followers")
return {"username": username, "followers": followers, "avg_views": int(avg_views),
"engagement_pct": round(engagement * 100, 2), "posts_analyzed": len(posts), "flags": flags,
"score": "pass" if not flags else "review"}
candidates = ["creator1", "creator2", "creator3"]
for c in candidates:
result = vet_creator(c)
print(f"@{result['username']}: {result['score']} | {result['engagement_pct']}% engagement | flags: {result['flags']}")Implémentation JavaScript
const H = {'Authorization': 'Bearer ' + process.env.SCAVIO_API_KEY, 'Content-Type': 'application/json'};
async function vetCreator(username) {
const pr = await fetch('https://api.scavio.dev/api/v1/tiktok/profile', {method:'POST', headers:H, body:JSON.stringify({username})});
const p = await pr.json();
const followers = p.user_info?.stats?.follower_count||0;
const vr = await fetch('https://api.scavio.dev/api/v1/tiktok/user-posts', {method:'POST', headers:H, body:JSON.stringify({username})});
const posts = (await vr.json()).videos||[];
const avgViews = posts.reduce((s,v)=>s+(v.stats?.play_count||0),0)/Math.max(posts.length,1);
const engagement = avgViews/Math.max(followers,1);
const flags = [];
if (engagement<0.01) flags.push('low_engagement');
if (followers>100000 && engagement<0.005) flags.push('possible_fake_followers');
return {username, followers, avgViews:Math.round(avgViews), engagement:(engagement*100).toFixed(2), flags, score:flags.length?'review':'pass'};
}
const r = await vetCreator('example_creator');
console.log('@'+r.username+': '+r.score+' | '+r.engagement+'% | flags: '+r.flags.join(','));Plateformes utilisées
TikTok
Découverte de vidéos tendance, créateurs et produits