Resumen
Este flujo de trabajo monitorea TikTok UGC campana rendimiento diario by collecting metricas de todos participating creators. It consultas cada creator's reciente publicaciones, filtra for campaign-tagged contenido, agrega views y engagement, y genera un diario rendimiento panel de control. Cost: $0.005/creator/dia. A 30-creator campana costs $0.15/dia to monitorear.
Desencadenador
Cron programar (diario at 11 AM UTC)
Programación
Ejecuta diario at 11:00 AM UTC
Pasos del flujo de trabajo
Cargar campana creators
Leer el lista of participating TikTok creators y campana hashtag.
Pull creator publicaciones
Consulta Scavio TikTok API for cada creator's reciente publicaciones.
Filtrar campana contenido
Match publicaciones containing el campana hashtag.
Agregar metricas
Sum views, likes, comentarios a traves de todos campana contenido.
Generar informe diario
Salida per-creator y agregar campana metricas.
Implementacion en Python
import requests
import json
from datetime import datetime
API_KEY = "your_scavio_api_key"
CAMPAIGN_HASHTAG = "YourCampaign"
def monitor_campaign(creators: list[str]) -> dict:
all_posts = []
for creator in creators:
res = requests.post(
"https://api.scavio.dev/api/v1/tiktok/user/posts",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"username": creator},
timeout=15,
)
if not res.ok:
continue
posts = res.json().get("posts", [])
campaign_posts = [p for p in posts if CAMPAIGN_HASHTAG.lower() in " ".join(p.get("hashtags", [])).lower()]
for p in campaign_posts:
all_posts.append({
"creator": creator,
"video_id": p.get("id"),
"views": p.get("views", 0),
"likes": p.get("likes", 0),
"comments": p.get("comments", 0),
})
total_views = sum(p["views"] for p in all_posts)
total_likes = sum(p["likes"] for p in all_posts)
report = {
"date": datetime.utcnow().strftime("%Y-%m-%d"),
"campaign": CAMPAIGN_HASHTAG,
"creators_checked": len(creators),
"campaign_posts": len(all_posts),
"total_views": total_views,
"total_likes": total_likes,
"engagement_rate": round(total_likes / max(total_views, 1) * 100, 2),
}
print(f"Campaign {CAMPAIGN_HASHTAG}: {len(all_posts)} posts, {total_views:,} views, {report['engagement_rate']}% engagement")
return report
monitor_campaign(["creator_a", "creator_b", "creator_c"])Implementacion en JavaScript
const API_KEY = "your_scavio_api_key";
const CAMPAIGN = "YourCampaign";
async function monitorCampaign(creators) {
let totalViews = 0, totalPosts = 0;
for (const creator of creators) {
const res = await fetch("https://api.scavio.dev/api/v1/tiktok/user/posts", {
method: "POST",
headers: { Authorization: `Bearer ${API_KEY}`, "content-type": "application/json" },
body: JSON.stringify({ username: creator }),
});
if (!res.ok) continue;
const posts = (await res.json()).posts ?? [];
const campaign = posts.filter((p) => (p.hashtags ?? []).some((h) => h.toLowerCase().includes(CAMPAIGN.toLowerCase())));
totalPosts += campaign.length;
totalViews += campaign.reduce((s, p) => s + (p.views ?? 0), 0);
}
console.log(`Campaign: ${totalPosts} posts, ${totalViews.toLocaleString()} views`);
}
await monitorCampaign(["creator_a", "creator_b"]);Plataformas utilizadas
TikTok
Descubrimiento de videos, creadores y productos en tendencia