| name | apify-createurs-tiktok |
| description | Use when you want to spot the creators gaining traction in a niche on TikTok - who to watch, partner with, or study. Niche hashtags -> CSV of authors with their follower and engagement stats. |
Identifier les créateurs qui montent sur une niche (TikTok)
Objectif & quand
One-shot : tu veux savoir qui monte dans une niche sur TikTok - les créateurs à suivre, à contacter pour un partenariat, ou à étudier pour comprendre ce qui marche. Tu pars des hashtags de la niche, l'Actor scrape les vidéos, et on remonte aux auteurs de ces vidéos avec leurs stats (abonnés, likes cumulés, bio).
Prérequis
- Compte Apify +
APIFY_TOKEN (gratuit pour démarrer).
- MCP Apify configuré (
CONNECTING-MCP.md).
Actor utilisé
clockworks/tiktok-scraper (https://apify.com/clockworks/tiktok-scraper) - scrape les vidéos TikTok par hashtag ; chaque vidéo porte les métadonnées de son auteur (authorMeta), qu'on agrège pour dresser la liste des créateurs.
Config (config.example.yaml)
| Champ | Rôle |
|---|
hashtags | les hashtags de la niche à explorer (sans le #) |
resultsPerPage | nombre de vidéos scrapées par hashtag (plus il est haut, plus on découvre d'auteurs) |
scrapeAdditionalAuthorMeta | true pour récupérer les métadonnées complètes de l'auteur (abonnés, likes cumulés, bio) |
Procédure (via MCP)
- Choisir les hashtags de la niche.
- Demander au MCP Apify de lancer l'Actor
clockworks/tiktok-scraper avec l'input de config.example.yaml (tool call-actor).
- Récupérer les items du dataset (
get-dataset-items).
- Dédupliquer par auteur (
authorMeta.name) : un créateur peut apparaître sur plusieurs vidéos. Garder une ligne par créateur, avec une vidéo échantillon.
- Trier par nombre d'abonnés (ou par engagement) pour repérer les créateurs qui percent.
Si le MCP ne fait pas l'action
Fallback via lib/apify_helpers.py :
from lib import apify_helpers as a
videos = a.run_actor("clockworks/tiktok-scraper", {
"hashtags": ["productivite", "notionfr"],
"resultsPerPage": 50,
"scrapeAdditionalAuthorMeta": True,
})
Ou lancer l'Actor depuis la console Apify (bouton Start) avec le même input.
Livrable
CSV : username, nickname, followers, total_likes, bio, profile_url, sample_video_url. Une ligne par créateur (dédupliqué).
Coût & limites
Pay-per-result : ~$0.003 / vidéo scrapée (palier Bronze). L'add-on scrapeAdditionalAuthorMeta enrichit les métadonnées auteur. On paie les vidéos, pas les créateurs : resultsPerPage borne la dépense. Données publiques.
Exemple
examples/createurs-tiktok.csv (données fictives, schéma réel).