TikTok Ad Library API
Découvrez des publicités TikTok publiques prises en charge à partir d’une requête, ou résolvez l’URL d’une publicité connue en champs normalisés pour la recherche, la revue et l’archivage.
API TikTok Ad Library disponibles
Utilisez Search pour trouver des publicités publiques par annonceur ou par mot-clé, et Ad Details pour résoudre l’URL d’une publicité publique connue et éligible.
Quelles données publicitaires publiques pouvez-vous récupérer ?
Les champs renvoyés reflètent les informations publiques actuellement exposées pour chaque enregistrement pris en charge ; les valeurs de source indisponibles restent null ou vides.
Identité de la publicité et de l’annonceur
Collectez les ID de publicités publiques, les URL d’enregistrement disponibles, les noms d’annonceurs, les références d’annonceurs et les types de ressources stables.
Création et destination
Examinez le texte publicitaire, le format, les références média et les URL de pages de destination publiques disponibles.
Contexte de diffusion visible
Lisez les dates de diffusion prises en charge, la date de publication, les pays, les plateformes, l’audience et les impressions lorsqu’ils sont exposés.
Contexte de collecte
Conservez les champs normalisés de source et de collecte pour vos files de revue, vos catalogues et vos jeux de données de recherche.
SocQ et les produits publicitaires de TikTok
SocQ propose une collecte en lecture seule des enregistrements de transparence publics pris en charge. Les produits de TikTok servent d’autres usages, de l’accès à la bibliothèque publique à la gestion autorisée de campagnes.
| Fonctionnalité | SocQ | Produits publicitaires TikTok |
|---|---|---|
| Usage principal | Rechercher et normaliser les publicités publiques prises en charge | Transparence publique ou gestion autorisée de campagnes, selon le produit |
| Entrées | Un annonceur ou un mot-clé, ou l’URL d’une publicité connue | Les contrôles varient selon l’interface TikTok concernée |
| Données privées de campagne | Non disponibles | Exige le compte, le produit, l’approbation et les autorisations applicables |
| Actions | Flux de données publiques en lecture seule | Ads Manager permet les opérations autorisées sur les campagnes |
| Format de réponse | Enregistrements publicitaires SocQ stables | Vues ou réponses natives propres à chaque produit |
Fonctionnement des API TikTok Ad Library
Les deux endpoints suivent un cycle asynchrone d’envoi, d’interrogation et de lecture ; Search peut collecter plusieurs pages de la source, tandis qu’Ad Details renvoie au plus un enregistrement.
1. Choisir un endpoint
Envoyez un annonceur ou un mot-clé à Search, ou l’URL d’une publicité TikTok publique éligible à Ad Details.
2. Interroger la tâche
Utilisez le task_id renvoyé avec /v1/tasks/{task_id} jusqu’à la réussite ou l’échec du traitement.
3. Lire les enregistrements normalisés
Exploitez data.results.items et le curseur éventuel du résultat de la tâche ; une requête de détail renvoie zéro ou une publicité.
Authentifiez-vous avec une clé API SocQ. Search renvoie 12 résultats par défaut ; Ad Details n’a ni pagination ni results_limit.
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}'
# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}Cas d’usage courants de l’API TikTok Ad Library
Veille sur les marques
Constituez des lots de revue périodiques à partir des publicités publiques disponibles qui correspondent au nom d’un annonceur connu.
Revue des créations
Résolvez des publicités choisies et examinez le texte, l’annonceur, le format, les médias et les champs de destination publics pris en charge.
Archivage de la transparence
Conservez des enregistrements publicitaires publics normalisés avec leurs dates de diffusion et leur contexte de collecte.
Enrichissement de recherches
Servez-vous des résultats de recherche pour repérer des enregistrements, puis transformez des URL de publicités publiques connues en champs de détail stables.
Limites et politique sur les données publiques
Les enregistrements publicitaires publics dépendent de la visibilité de la source, de l’éligibilité, de la disponibilité géographique, du délai de publication, de la durée de conservation et des champs exposés par l’interface TikTok concernée.
- L’absence dans une recherche ne prouve pas qu’un annonceur n’a jamais diffusé de publicité, et des URL indisponibles peuvent ne produire aucun résultat de détail.
- Search n’expose aucun contrôle de pays, de date, de section, de langue, de secteur, d’objectif, d’enrichissement ni de tri.
- Les dates, l’audience ou les impressions publiques ne remplacent pas un reporting privé sur les dépenses, les conversions, l’attribution ou le retour sur investissement publicitaire.
- Les références média peuvent être temporaires ou contrôlées par la source, et tous les champs dépendant de la source peuvent être null ou vides.
Questions fréquentes sur l’API TikTok Ad Library
SocQ est-il TikTok Ads Manager ?
Non. SocQ recherche et normalise des enregistrements de transparence publics pris en charge ; il ne gère ni comptes, ni campagnes, ni budgets, ni ciblage, ni créations.
Que puis-je envoyer ?
Search accepte le nom d’un annonceur ou un mot-clé. Ad Details accepte l’URL d’une publicité TikTok publique connue et éligible.
Chaque résultat contient-il tous les détails de la publicité ?
Non. Search renvoie généralement des résumés, la consultation de détail peut ne renvoyer aucun enregistrement, et tous les champs dépendant de la source peuvent être null ou vides.
Comment l’utilisation est-elle facturée ?
Chaque enregistrement renvoyé coûte 0,5 crédit SocQ, sans frais de base ; Search renvoie 12 résultats par défaut et Ad Details au plus un.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
YouTube API
Collectez les profils de chaînes YouTube publics pris en charge, les détails de vidéos, les vidéos de chaînes, les commentaires, les Shorts, les résultats par mot-clé et par hashtag, ainsi que les transcriptions disponibles, dans un seul flux asynchrone normalisé.
Facebook API
Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.
X API
Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.
LinkedIn API
Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.
Reddit API
Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.
Pinterest API
Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.

