TikTok Ad Library Search
TikTok Ad Library Search envoie une requête unique, par nom d’annonceur ou par mot-clé, à l’Ads Library publique et suit son curseur opaque jusqu’à la limite demandée alignée sur les pages, ou jusqu’à une condition d’arrêt de la source. Il sert la recherche sur la transparence et la découverte de publicités, pas la gestion de campagnes privées ni la mesure de performance.
Fonctionnalités de la TikTok Ad Library Search API
- Une seule requête cibléeRecherchez avec un seul nom d’annonceur, terme de marque ou mot-clé, obligatoire et non vide.
- Collecte alignée sur les pagesDemandez de 12 à 2 000 résultats, par multiples de 12 ; 1 992 est la plus grande valeur valide.
- Gestion du curseur opaqueSuit les curseurs de la source jusqu’à la limite, une page vide, un signal de fin, un curseur manquant ou un curseur répété.
- Résumés de publicités normalisésObtenez des champs stables d’identité, d’annonceur, de dates d’affichage, de diffusion, de destination, d’impressions, de médias, de publication et de collecte.
- Valeurs nulles selon la sourceLaisse les champs à null ou vides lorsque le résultat de recherche public n’expose qu’un résumé ou omet la valeur.
Paramètres de la TikTok Ad Library Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Nom d’annonceur ou mot-clé obligatoire et non vide. Une seule requête est acceptée. |
results_limit | Facultatif | Plafond de résultats facultatif. Vaut 12 par défaut et doit être un multiple de 12 compris entre 12 et 2 000 ; la plus grande valeur valide est 1 992. |
Comment utiliser la TikTok Ad Library Search API
Envoyez une requête et une limite valide alignée sur les pages, interrogez la tâche asynchrone, puis exploitez les pages de résultats normalisés.
- Choisissez un seul nom d’annonceur ou mot-clé ; l’endpoint n’accepte pas de liste de requêtes.
- Envoyez query et, si besoin, results_limit en POST à /v1/tiktok-ad-library/search.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne un statut final.
- Lisez data.results.items et suivez les curseurs de résultats de la tâche lorsque la réponse indique d’autres pages.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Anysphere","results_limit":12}'
# Poll GET /v1/tasks/{task_id}
# Read normalized ads from data.results.itemsCas d’usage de la TikTok Ad Library Search API
- Découverte d’annonceurs : Retrouvez les publicités publiques prises en charge associées à un nom d’annonceur ou de marque.
- Recherche par mot-clé : Constituez un ensemble de publicités publiques à examiner dont le contenu indexé dans la bibliothèque correspond à un terme thématique.
- Panorama des créations : Comparez les thèmes visibles, les références de médias, les libellés d’annonceur et les dates d’affichage entre les enregistrements renvoyés.
- File d’attente de consultation du détail : Collectez les ID de publicité publics et les références sources pour examiner des enregistrements choisis avec l’endpoint de détail.
Conseils d’expert pour la TikTok Ad Library Search API
- Utilisez un nom d’annonceur précis ou une expression distinctive, car la correspondance et l’ordre appliqués en amont déterminent la pertinence.
- Choisissez results_limit par paliers de 12 enregistrements ; 2 000 respecte le plafond général mais échoue à la règle du multiple de 12.
- Attendez-vous à moins d’enregistrements que demandé lorsque la source arrive à son terme, renvoie une page vide ou répète un curseur.
- Ne supposez pas de déduplication entre les pages ; utilisez l’id stable de la publicité dans votre propre pipeline lorsque l’unicité compte.
- Interprétez l’audience estimée ou les impressions selon la définition de la source, et non comme des conversions ou une performance vérifiée.
- Utilisez l’endpoint Ad Details pour un enregistrement choisi ; la recherche n’offre pas d’enrichissement de détail facultatif.
API associées
En complément de la TikTok Ad Library Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Ad Library.
- TikTok Ad Library Ad API — Transformez l’URL d’une publicité TikTok publique connue en champs normalisés de création, annonceur, diffusion, destination, impressions, médias, publication et collecte.