Comment repérer les vidéos TikTok avec une mention publicitaire et les soumettre à vérification

Si une équipe doit vérifier la manière dont les créateurs signalent leur lien avec une marque dans des vidéos TikTok publiques, le premier résultat utile n’est pas un verdict automatisé, mais une file d’attente concise de vidéos accompagnées de leur légende, de leur lien et des mots-clés repérés. Voici une méthode opérationnelle : envoyer une requête de recherche à l’API TikTok Scraper de jsonscraper, normaliser les deux formats de réponse et enregistrer un CSV à faire vérifier par un spécialiste.

Objectif : trouver les vidéos à vérifier

Une recherche manuelle par nom d’entreprise est difficile à reproduire de façon uniforme : il faut recueillir les résultats un par un, et les raisons de leur sélection restent dans le navigateur. Une collecte automatisée permet d’enregistrer la requête, la date de lancement et les contenus trouvés dans un tableau, afin que l’équipe puisse examiner les vidéos à partir d’une liste commune.

Dans ce scénario, un « contenu à vérifier » désigne uniquement une vidéo issue des résultats de recherche renvoyés, dont la description contient un mot ou une expression définis à l’avance. Il peut s’agir, par exemple, de « publicité », « partenariat » ou « sponsorisé ». Ce filtre textuel aide à attirer l’attention d’une personne, mais n’évalue pas la vidéo et ne détermine pas si les exigences applicables sont respectées.

Cette distinction est importante pour une équipe marketing. Les recommandations de la Commission fédérale du commerce des États-Unis décrivent la divulgation d’un lien matériel avec une marque comme une obligation dépendant du contexte du message ; pour les vidéos, la FTC recommande de tenir compte de la forme visuelle et sonore de la mention. Une recherche dans les légendes peut repérer certains signaux textuels, mais il faut visionner la publication et évaluer son contexte pour prendre une décision. Le guide de la FTC destiné aux créateurs explique ces conditions à l’aide d’exemples.

Résultat : un CSV qui indique le motif de sélection

Le pipeline enregistrera une ligne par identifiant vidéo unique et inclura le texte de la description, le lien, le nom du créateur, les compteurs publics disponibles et les marqueurs correspondants. Nous ajouterons séparément la requête de recherche initiale et l’heure de collecte. Le tableau pourra ainsi être intégré à une file de travail et permettra aussi de comprendre ultérieurement pourquoi une vidéo donnée y a été ajoutée.

La liste des marqueurs doit être définie par un éditeur ou un spécialiste de la conformité. Commencez par les langues et les termes réellement utilisés dans votre campagne, puis examinez les résultats et élargissez la liste si nécessaire. Les valeurs du code ci-dessous sont volontairement simples : adaptez-les à la marque, au marché et à la langue des contenus concernés.

Connexion à l’API TikTok Scraper

La documentation de jsonscraper indique que la recherche de vidéos s’effectue à l’aide de la route GET /searchVideo sur l’adresse de base https://tiktok.evelode.com. Le paramètre obligatoire est keyword ; parmi les paramètres facultatifs figurent count, date_posted, sort_by et region. La clé est transmise sous le nom license_key : stockez-la dans une variable d’environnement, et non dans le code ou le CSV. Les noms exacts des paramètres et la route figurent dans le guide des endpoints TikTok ; les informations sur le produit et son accès sont disponibles sur la page de l’API TikTok Scraper.

Une particularité de la réponse peut influer sur l’exhaustivité de votre analyse locale : les données peuvent se trouver dans tiktok.aweme_list ou dans tiktok.search_item_list[].aweme_info. Le script vérifie donc les deux tableaux. Si la recherche renvoie une liste vide, il crée un CSV vide au lieu de fabriquer de fausses lignes pour remplacer l’absence de résultats.

Exemple en Python : recherche, filtre et CSV

L’exemple n’utilise que la bibliothèque standard de Python 3.8 ou version ultérieure. Avant de l’exécuter, définissez JSONSCRAPER_TIKTOK_LICENSE_KEY dans l’environnement. La requête utilise keyword et transmet la clé dans le paramètre de requête license_key, conformément à la spécification.

import csv
import json
import os
import sys
from datetime import datetime, timezone
from urllib.parse import urlencode
from urllib.request import Request, urlopen

API_KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
KEYWORD = "Acme"
MARKERS = ["publicité", "partenariat", "partenariat", "sponsor", "ad", "sponsored"]

params = {
    "license_key": API_KEY,
    "keyword": KEYWORD,
    "count": 30,
    "sort_by": "date-posted",
    "date_posted": "this-month",
    "region": "US",
}
url = "https://tiktok.evelode.com/searchVideo?" + urlencode(params)
request = Request(url, headers={"Accept": "application/json"})

with urlopen(request, timeout=30) as response:
    payload = json.load(response)

if payload.get("status") != "ok":
    raise RuntimeError("API returned a non-ok outer status")

tiktok = payload.get("tiktok") or {}
items = list(tiktok.get("aweme_list") or [])
for entry in tiktok.get("search_item_list") or []:
    info = entry.get("aweme_info") or {}
    if info:
        items.append(info)

seen = set()
rows = []
collected_at = datetime.now(timezone.utc).isoformat()

for item in items:
    video_id = item.get("aweme_id")
    if not video_id or video_id in seen:
        continue
    seen.add(video_id)

    description = item.get("desc") or ""
    lowered = description.casefold()
    matched = [word for word in MARKERS if word.casefold() in lowered]
    if not matched:
        continue

    author = item.get("author") or {}
    stats = item.get("statistics") or {}
    rows.append({
        "collected_at_utc": collected_at,
        "search_keyword": KEYWORD,
        "video_id": video_id,
        "share_url": item.get("share_url") or "",
        "description": description,
        "matched_markers": "; ".join(matched),
        "author_name": author.get("nickname") or "",
        "author_id": author.get("unique_id") or "",
        "play_count": stats.get("play_count", ""),
        "digg_count": stats.get("digg_count", ""),
        "comment_count": stats.get("comment_count", ""),
        "share_count": stats.get("share_count", ""),
    })

fields = [
    "collected_at_utc", "search_keyword", "video_id", "share_url",
    "description", "matched_markers", "author_name", "author_id",
    "play_count", "digg_count", "comment_count", "share_count",
]
with open("tiktok_review_queue.csv", "w", newline="", encoding="utf-8-sig") as output:
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()
    writer.writerows(rows)

print(f"Saved {len(rows)} review candidates to tiktok_review_queue.csv")

Le script vérifie d’abord le statut externe, puis lit l’objet tiktok et regroupe les tableaux disponibles. La déduplication par aweme_id évite les doublons si une même vidéo apparaît dans les deux chemins de réponse. Les métriques sont enregistrées telles qu’elles sont reçues ; une valeur manquante reste vide au lieu d’être convertie en zéro.

L’exemple utilise les paramètres documentés pour /searchVideo : date_posted accepte la valeur this-month, sort_by la valeur date-posted, et region un code de pays. La valeur de count définit le nombre de résultats demandés, sans garantir une liste exhaustive des publications. Pour parcourir les pages suivantes, conservez le curseur renvoyé comme une valeur opaque et transmettez-le dans le paramètre cursor.

Vérification humaine et automatisation de l’exécution

Transmettez le CSV à la personne chargée de la vérification avec de brèves consignes : ouvrir le lien, regarder la vidéo et examiner le contexte de la légende, consigner la conclusion et ajouter un commentaire si le marqueur a été repéré dans un autre sens. Par exemple, le filtre automatique ne distingue pas une mention publicitaire d’une discussion sur le fonctionnement de la publicité. La vérification humaine comble cette lacune sémantique.

Pour effectuer la collecte de manière régulière, exécutez le script selon un calendrier, avec cron, un ordonnanceur CI ou un orchestrateur de tâches. Enregistrez le CSV avec la date de lancement ou importez les lignes dans un tableau avec une clé unique composée de l’identifiant vidéo et de la date d’observation. Si vous avez besoin d’un journal d’audit, conservez aussi la réponse JSON d’origine en contrôlant les accès : elle permet de revérifier la transformation et d’expliquer l’origine de chaque ligne.

Dans une version destinée à la production, ajoutez la gestion des erreurs réseau et HTTP, une limite aux nouvelles tentatives et une notification en cas d’échec. N’affichez pas l’URL complète de la requête : elle contient la clé d’accès. Pour une équipe comptant plusieurs utilisateurs, il est judicieux de stocker le secret dans le gestionnaire de secrets de l’environnement d’exécution et de limiter l’accès aux fichiers de sortie conformément aux règles internes.

Ce que cette liste peut apporter

Après l’exécution, l’équipe disposera d’un ensemble reproductible de vidéos repérées à l’aide d’une expression clé, ainsi que d’un motif explicite pour l’ajout de chaque contenu à la file d’attente. Le tableau permet d’exclure manuellement les résultats non pertinents, d’attribuer les vérifications et de regrouper les résultats par marqueur ou par créateur. Si la collecte est exécutée régulièrement, l’équipe pourra aussi consulter l’historique des vidéos présentes dans les résultats renvoyés à une date donnée.

Cette méthode convient à la détection initiale et à l’acheminement des contenus, pas à une conclusion automatisée sur le respect des règles. Elle est limitée aux résultats de recherche, au mot-clé choisi, aux paramètres de la requête et aux marqueurs textuels. Pour vérifier une collaboration précise, comparez la vidéo au brief et aux informations dont dispose votre équipe, puis évaluez le message lui-même au regard des règles applicables.

Pour commencer, vérifiez les accès et les paramètres à jour sur la page produit de l’API TikTok Scraper, et consultez la documentation officielle de l’API pour connaître le format des réponses et les options d’intégration.