tiktok-ad-library/
search

Repérez des publicités TikTok publiques prises en charge avec une seule requête par nom d’annonceur ou mot-clé, puis collectez identités normalisées, dates d’affichage, signaux d’audience et références de médias lorsqu’ils sont disponibles.

TikTok Ad Library Search API

Annonceur ou mot-clé
Pages de 12 enregistrements
Découverte de publicités publiques
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 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ètresObligatoireDescription
queryObligatoireNom d’annonceur ou mot-clé obligatoire et non vide. Une seule requête est acceptée.
results_limitFacultatifPlafond 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.

  1. Choisissez un seul nom d’annonceur ou mot-clé ; l’endpoint n’accepte pas de liste de requêtes.
  2. Envoyez query et, si besoin, results_limit en POST à /v1/tiktok-ad-library/search.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne un statut final.
  4. 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.items

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

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.

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 Search API — FAQ

TikTok Ad Library Search API est une interface qui retrouve des publicités TikTok publiques prises en charge à partir d’une seule requête par nom d’annonceur ou mot-clé, et renvoie des résumés de publicités normalisés jusqu’à une limite alignée sur les pages.

query est une chaîne unique, obligatoire et non vide. Il peut s’agir d’un nom d’annonceur, d’un terme de marque ou d’un mot-clé, mais l’endpoint n’accepte pas plusieurs valeurs de requête dans un même appel.

La valeur par défaut est 12. Les valeurs doivent être des entiers de 12 à 2 000 et des multiples de 12 ; 1 992 est donc la plus grande limite valide.

Non. La spécification SocQ actuelle n’accepte que query et results_limit ; la correspondance, l’ordre, la géographie et l’éligibilité des sources restent pilotés par l’amont.

La collecte s’arrête à la limite demandée ou lorsque la source ne renvoie aucune publicité, signale la dernière page, omet un curseur ou en répète un. Les règles de visibilité et de zone géographique peuvent aussi influer sur la disponibilité.

Le collecteur évite les boucles de curseur mais ne garantit pas la déduplication des enregistrements entre les pages. Dédoublonnez en aval d’après un id de publicité non nul si nécessaire.

Chaque enregistrement de publicité renvoyé coûte 0,5 crédit SocQ, sans frais de base. L’estimation par défaut couvre 12 résultats, et un résultat vide n’entraîne aucun frais de résultat.