tiktok-ad-library/
ad

Résolvez l’URL d’une publicité TikTok publique connue en champs normalisés de création, d’annonceur, de diffusion, de destination, d’impressions, de médias, de publication et de collecte.

TikTok Ad Library Ad API

URL unique
Une publicité au maximum
Enregistrement canonique de publicité
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlObligatoireURL 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.

  1. 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.
  2. Envoyez url en POST à /v1/tiktok-ad-library/ad et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne un statut final.
  4. 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 item

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données TikTok Ad Library avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Ad Library Ad API — FAQ

TikTok Ad Library Ad API est une interface qui résout l’URL d’une publicité TikTok publique connue en un enregistrement de détail normalisé, au plus, avec les champs pris en charge d’annonceur, de création, de diffusion, de destination, d’impressions, de médias et de dates.

Envoyez une URL TikTok officielle en http ou https dont le chemin contient /ad. La console de la page rejette avant l’envoi les domaines qui imitent TikTok.

L’adaptateur retient la première valeur non vide de id, sinon ad_id, sinon le segment de chemin entièrement numérique le plus à droite. Si aucun n’existe, il transmet l’URL comme solution de repli qui dépend du fournisseur.

Non. L’endpoint accepte une seule URL, renvoie au plus une publicité, ne pagine pas et n’a pas de results_limit.

Les enregistrements publics de l’Ads Library et du Creative Center exposent des champs différents, et les enregistrements source peuvent omettre l’annonceur, les dates, les pays, le format, la destination, les impressions ou les médias.

Non. Il ne fournit ni enchères, ni budgets, ni conversions, ni attribution d’Ads Manager, ni ciblage privé, ni configuration complète de campagne.

Un enregistrement de publicité renvoyé coûte 0,5 crédit SocQ, sans frais de base. L’estimation porte sur un résultat, et un résultat vide n’entraîne aucun frais de résultat.