TikTok Ad Library Ad
TikTok Ad Library Ad résout un enregistrement publicitaire public déjà identifié, une fois qu’une recherche ou un examen manuel a fourni une URL valide. Il en déduit un identifiant amont et renvoie au plus une publicité normalisée, sans rechercher un annonceur, énumérer des campagnes ni exposer les données de performance privées d’Ads Manager.
Fonctionnalités de la TikTok Ad Library Ad API
- URL de publicité connueEnvoyez une URL TikTok officielle en http ou https dont le chemin contient /ad.
- Déduction de l’identifiantRetient en priorité la première valeur de id dans la requête, puis ad_id, puis le segment numérique le plus à droite du chemin ; à défaut, le fournisseur reçoit l’URL comme solution de repli.
- Détail d’un seul objetDemande un seul objet de détail amont et ne produit au plus qu’un enregistrement, uniquement lorsqu’une identité de publicité prise en charge est présente.
- Champs canoniques de la publicitéObtenez des champs stables pour l’annonceur, le texte, les dates, le pays, la plateforme, le format, la destination, les impressions, les médias, la publication et la collecte.
- Fidélité à la source avec valeurs nullesLes valeurs indisponibles restent null, car les enregistrements de la Commercial Content Library et du Creative Center peuvent exposer des champs différents.
Paramètres de la TikTok Ad Library Ad API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL TikTok officielle obligatoire, unique, en http ou https, dont le chemin contient /ad. Privilégiez une valeur id ou ad_id exploitable dans la requête, ou un segment numérique dans le chemin. |
Comment utiliser la TikTok Ad Library Ad API
Envoyez l’URL d’une publicité publique connue, interrogez la tâche asynchrone, puis traitez le résultat unique lorsqu’il est disponible.
- Choisissez de préférence une URL de publicité TikTok officielle contenant un id, un ad_id ou un identifiant numérique dans le chemin.
- Envoyez url en POST à /v1/tiktok-ad-library/ad et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne un statut final.
- En cas de succès, lisez data.results.items ; l’opération de détail renvoie zéro ou un élément.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; the detail operation returns at most one itemCas d’usage de la TikTok Ad Library Ad API
- Inspection d’une publicité choisie : Résolvez une publicité sélectionnée dans un résultat de recherche en champs de détail normalisés, tels qu’ils sont actuellement disponibles.
- Examen de la création : Inspectez le texte public de la création, l’identité de l’annonceur, le format, les médias et la destination d’une publicité connue.
- Archive de transparence : Conservez un enregistrement public avec l’URL source, les dates d’affichage, le contexte de diffusion et l’heure de collecte.
- Comparaison entre bibliothèques : Comparez les métadonnées publiques prises en charge de plusieurs publicités choisies, sans les assimiler à la performance d’une campagne.
Conseils d’expert pour la TikTok Ad Library Ad API
- Privilégiez les URL avec une valeur numérique explicite pour id ou ad_id afin d’éviter le comportement de repli, qui dépend du fournisseur.
- Une URL valide ne garantit pas que la source amont expose encore une publicité identifiable.
- Considérez les champs de l’Ads Library et du Creative Center comme propres à chaque source, et non comme directement interchangeables.
- N’archivez les références de médias ou de pages de destination que dans le respect des conditions applicables, car les URL peuvent expirer ou rediriger.
- Ne déduisez ni ciblage, ni dépenses, ni conversions, ni performance à partir des dates d’affichage ou des impressions publiques.
- Utilisez l’endpoint de recherche pour la découverte ; cet endpoint de détail n’énumère jamais les publicités d’un annonceur.
API associées
En complément de la TikTok Ad Library Ad API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Ad Library.
- TikTok Ad Library Search API — Recherchez des publicités TikTok publiques prises en charge par nom d’annonceur ou mot-clé, avec une limite de résultats alignée sur les pages.