Une API de bibliothèque publicitaire pour les publicités Meta, Google et TikTok

Chaque recherche utilise la même clé, la même pagination et les mêmes codes d'erreur, et répond en JSON. Appelez-la depuis un script ou votre propre application, ou laissez un agent IA l'appeler via le serveur MCP.

Publicités Meta, publicités Google et TikTok dans une seule API de bibliothèque publicitaire

Trois jeux de données publicitaires se trouvent derrière la clé. Les publicités Meta couvrent Facebook et Instagram, et vous les recherchez par mots du texte, de la marque ou de la page de destination. Les publicités Google se présentent sous forme d'annonces texte, image et vidéo, avec un filtre pour le réseau sur lequel elles ont tourné, YouTube compris. Une publicité vidéo renvoie vers le Centre de transparence des annonces de Google, où elle est lue. TikTok vous donne les publicités et les publications organiques dans une seule recherche, avec leurs vues, leurs J'aime et leurs partages.

Chaque publicité renvoie vers la marque qui se trouve derrière : la page de l'annonceur et, quand il y en a une, la boutique Shopify qui lui est liée. Vous pouvez donc passer d'une publicité à la boutique, puis au trafic et aux meilleures ventes de la boutique, avec la même clé.

La liste complète figure dans la Documentation de l'API. Si vous préférez cliquer plutôt que coder, les mêmes recherches fonctionnent dans notre outil d'espionnage publicitaire.

Obtenir une clé API et envoyer votre première requête

1. Créez un compte, confirmez votre e-mail et choisissez une offre payante : l'API commence là.
2. Ouvrez Clés API dans votre tableau de bord et créez une clé. Copiez-la tout de suite : elle n'est affichée qu'une seule fois.
3. Envoyez la clé à chaque requête, dans l'en-tête X-API-Key ou comme jeton bearer.

Cette requête trouve des publicités vidéo de soins de la peau encore en diffusion. Elle fonctionne avec toutes les offres payantes :

# Search Meta ads
curl "https://api.sellwinners.com/v1/ads?search=skincare&status=active&mediaType=video&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/ads Paramètres et champs dans la documentation

La réponse contient un requestId, les publicités sous data et un objet pagination. Dans chaque publicité, media contient les URL de la miniature et de la vidéo, content le titre, le texte, l'appel à l'action et la page de destination, et advertiser la page qui la diffuse. metrics compte les doublons, et ajoute la portée et les dépenses estimées.

Une recherche Meta renvoie une publicité par marque : un seul annonceur ne peut donc pas remplir la page. Augmentez maxAdsPerBrand (jusqu'à 15, ou 0 pour aucune limite) pour en voir davantage de chacune.

Filtrer par nom

Les publicités Meta acceptent 111 filtres nommés, envoyés en paramètres de requête sur un GET ou en champs du corps sur un POST. Parmi les plus courants : minDaysRunning, countries, cta et minDuplicates. Un nom mal orthographié renvoie une erreur 400 validation_failed qui liste les noms acceptés par l'endpoint : une faute de frappe ne renvoie donc jamais de publicités non filtrées.

# Search Meta ads with advanced filters
curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "skincare", "status": "active", "mediaType": "video", "countries": ["US"], "minDaysRunning": 30, "sortBy": "reach", "limit": 10}'

POST /v1/ads/query Paramètres et champs dans la documentation

La portée désigne la portée dans l'UE et au Royaume-Uni, et les dépenses sont toujours une estimation.

Toutes les publicités d'une marque

Trouvez l'id d'annonceur de la marque avec GET /v1/lookup?q=allbirds.com&type=advertiser, puis listez ses publicités, par plus longue diffusion :

# Meta ads of one advertiser
curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?sortBy=longestRunning&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/advertisers/{advertiser_id}/ads Paramètres et champs dans la documentation

Notre page sur la recherche dans la bibliothèque de publicités Meta présente cette vue dans l'application web, ainsi que la répartition des formats et les pages de destination de la marque.

Parcourir les résultats page par page

Les recherches acceptent limit (jusqu'à 100) et soit page, soit offset. Pour la page suivante, répétez la requête avec page plus un, ou offset plus limit. Arrêtez-vous quand hasMore vaut false.

La pagination atteint les 5 000 premiers résultats d'une recherche (les 100 premiers pour une recherche d'annonceurs). Pour aller plus loin, ajoutez des filtres ou changez le tri. La plupart des recherches ont besoin du haut d'une liste bien filtrée, pas de la page 200.

Limites de débit et crédits par offre

1 crédit = 1 résultat renvoyé : les détails d'une marque, une publicité ou une ligne d'une liste. Un résultat vide est gratuit. Les erreurs, les refus, les appels lookup et les valeurs de filtres ne coûtent rien, et un appel d'outil MCP coûte les résultats qu'il renvoie, comme l'API. Toutes les personnes d'un espace de travail, ses clés, l'API et le serveur MCP partagent une seule réserve de crédits et une seule limite de débit. Les crédits mensuels se renouvellent à 00:00 UTC le 1er de chaque mois ; les crédits de recharge achetés sur la page de facturation sont reportés.

Chaque réponse comporte X-RateLimit-Remaining et X-Credits-Remaining, et X-Usage-Cost indique ce qu'a coûté l'appel : votre code peut ainsi ralentir avant d'être refusé. Au-delà de la limite par minute, vous recevez 429 rate_limited avec un Retry-After en secondes. Une fois les crédits mensuels et les éventuels crédits de recharge épuisés, vous recevez 402 insufficient_credits jusqu'au renouvellement des crédits. GET /v1/usage indique où vous en êtes et ne coûte rien. Plus de détails dans la documentation des limites de débit et crédits.

Rechercher des publicités depuis un agent IA avec le serveur MCP

Le serveur MCP donne à un agent IA les mêmes données sous forme d'outils, en HTTP streamable, avec votre clé API dans l'en-tête X-API-Key. La page de notre serveur MCP pour agents IA indique l'URL du serveur et propose des configurations prêtes à l'emploi pour Cursor, VS Code et Claude Desktop.

Pour la recherche publicitaire, l'agent appelle surtout search_ads, scan_ad pour ouvrir une publicité, search_google_ads_library, search_tiktok_library et search_advertisers. Vous demandez en langage courant : « Trouvez des publicités vidéo de soins de la peau encore en diffusion aux États-Unis, ouvrez les trois qui tournent depuis le plus longtemps et listez leurs accroches. » L'agent transforme cela en filtres et en appels. Les règles des offres sont les mêmes que pour l'API.

En quoi cela diffère de l'API de la Bibliothèque publicitaire de Meta

SellWinners n'est pas l'API officielle de Meta. C'est un service indépendant, qui n'est pas affilié à Meta. Meta gère sa propre API de la Bibliothèque publicitaire. Sur sa page consacrée aux outils de la Bibliothèque publicitaire (« Meta Ad Library tools » dans son Espace transparence), Meta indique que l'API « permet une analyse plus approfondie des publicités portant sur des sujets sociaux, des élections ou la politique, ainsi que des publicités diffusées dans l'UE et les territoires associés », et parle d'« utilisateurs autorisés ». Nous avons consulté cette page le 19 octobre 2026.

Les deux servent des usages différents. L'API de Meta est gérée par Meta, selon les règles de Meta. SellWinners est conçu pour la recherche e-commerce :

• Une seule clé pour les publicités Meta, Google et TikTok, avec la même pagination, les mêmes erreurs et les mêmes limites.
• Des publicités reliées à la marque qui se trouve derrière : la page de l'annonceur, et la boutique Shopify quand il y en a une.
• Des filtres qui aident à repérer les publicités qui durent : jours de diffusion, doublons, appel à l'action et rang publicitaire.
• Un serveur MCP, pour qu'un agent IA puisse lancer les recherches à votre place.
• La portée des publicités diffusées dans l'UE et au Royaume-Uni, et des dépenses estimées.

Si votre travail porte sur les publicités politiques ou sur des sujets de société, l'API de Meta est conçue pour cela. Si vous voulez voir ce que les marques e-commerce diffusent sur trois réseaux, et quelles boutiques se trouvent derrière les publicités, c'est exactement le travail de SellWinners.

Pour aller plus loin

Commencez par une question, par exemple quelles marques de soins de la peau gardent la même vidéo en ligne depuis un mois. Lancez-la une fois avec curl, puis intégrez-la à votre code. Pour approfondir une plateforme, ouvrez la bibliothèque de publicités TikTok, la bibliothèque de publicités Google ou la recherche d'annonceurs. Pour garder un œil sur un concurrent, il suffit de suivre les publicités d'une marque dans le temps. Pour une vue d'ensemble du marché, voyez comment se comparent les outils d'espionnage publicitaire.

Rechercher des publicités dans Explorer