Swipe file publicitaire : gardez ce que vous trouvez, organisé à votre façon
Enregistrez publicités, boutiques, produits, e-mails et annonceurs au fil de vos recherches, classez-les dans des tableaux et des dossiers, et partagez un tableau, un dossier de favoris ou une publicité avec un lien public. Tout ce que vous enregistrez appartient à votre compte.
- 9 endpoints REST présentés ci-dessous
- 7 outils MCP
- Une seule clé pour les deux
- Lire la documentation
# Dossiers: a first request curl "https://api.sellwinners.com/v1/boards" \ -H "Authorization: Bearer YOUR_API_KEY" # The answer is JSON: # {"requestId": "...", "data": ...}
Ce que vous obtenez avec Dossiers
Tableaux et dossiers
Un tableau contient des éléments enregistrés ; un dossier contient des tableaux. Déplacez-les, renommez-les, archivez-les et restaurez-les à mesure que vos recherches avancent.
Enregistrez presque tout
Publicités Meta, publicités Google, éléments TikTok, boutiques, produits, e-mails et annonceurs.
Favoris
Une façon plus rapide d'enregistrer : mettez en favori une publicité, une boutique ou un e-mail, avec ou sans dossier.
Liens de partage
Créez un lien public vers un tableau, un dossier de favoris ou une seule publicité. Toute personne disposant du lien peut l'ouvrir, et chaque lien peut être supprimé à tout moment.
Trois étapes
Créer un tableau
Donnez-lui un nom et indiquez ce qu'il contient.
Enregistrez pendant vos recherches
Ajoutez un élément avec son type et son ID, directement depuis un résultat de recherche.
Partagez ou masquez
Envoyez un lien public, ou demandez à une recherche de publicités Meta d'exclure les publicités que vous avez déjà enregistrées.
Les endpoints derrière cette fonctionnalité
Chacun est documenté avec ses paramètres. Sélectionnez une ligne pour l'ouvrir dans la documentation.
/v1/boardsLister les tableaux
POST/v1/boardsCréer un tableau
POST/v1/boards/{boardId}/itemsAjouter un élément à un tableau
POST/v1/boards/{boardId}/items/{itemId}/moveDéplacer un élément vers un autre tableau
POST/v1/boards/{boardId}/share-linksCréer un lien public vers un tableau
GET/v1/favorites/adsLister les publicités favorites
POST/v1/favorites/adsEnregistrer une publicité en favori
POST/v1/favorites/ads/foldersCréer un dossier de publicités favorites
POST/v1/ads/{adId}/shareCréer (ou renvoyer) un lien public vers une publicité
La même fonctionnalité pour votre agent IA
Ces outils utilisent la même clé et les mêmes crédits que l'API REST.
create_boardCréer un tableauadd_board_itemEnregistrer un élément dans un tableau collectionlist_board_itemsLes éléments enregistrés dans un tableaucreate_board_share_linkCréer un lien public vers un tableauadd_favorite_itemEnregistrer une publicité, une boutique ou un e-maillist_favoritesVos publicités, boutiques ou e-mails enregistréscreate_favorite_folderCréer un dossier de favorisUn swipe file publicitaire est une collection de publicités que vous avez gardées parce qu'elles sont riches d'enseignements. Dans SellWinners, c'est un ensemble de tableaux : enregistrez des publicités Meta, Google et TikTok, des boutiques, des produits, des e-mails et des annonceurs pendant vos recherches, rangez-les dans des dossiers, et partagez un tableau par lien quand quelqu'un d'autre doit le voir.
Sans lui, les bonnes trouvailles finissent en captures d'écran et en onglets de navigateur. Avec lui, chaque élément enregistré reste relié à sa fiche : des semaines plus tard, vous pouvez encore ouvrir la publicité, lire son texte et remonter jusqu'à la boutique qui se trouve derrière.
Comment s'articulent tableaux, dossiers et favoris
| Élément | À quoi ça sert |
|---|---|
| Tableau | Contient les éléments enregistrés, jusqu'à 5 000 par tableau. Vous lui donnez un nom et précisez son usage : publicités, boutiques, pages de destination, e-mails, produits ou annonceurs |
| Dossier | Un tableau qui contient d'autres tableaux, pour qu'un client, une niche ou une campagne garde ses tableaux ensemble. Les tableaux peuvent entrer dans les dossiers et en sortir |
| Favoris | Le moyen rapide d'enregistrer une publicité, une boutique ou un e-mail. Les favoris ont leurs propres dossiers, et un favori enregistré sans dossier atterrit dans votre tableau Favoris |
| Archiver | Archiver un tableau le range avec tout ce qu'il contient. L'onglet Archivé le conserve, et vous pouvez le restaurer |
| Lien de partage | Un lien public vers un tableau, un dossier de favoris ou une seule publicité. Toute personne disposant du lien peut l'ouvrir sans compte, et vous pouvez le supprimer à tout moment |
Un compte contient jusqu'à 500 tableaux. Enregistrer deux fois le même élément dans un tableau ne le conserve qu'une fois.
Ce que conserve un élément enregistré
Chaque élément enregistré conserve son id. Une publicité Meta, une publicité Google, une publication TikTok, une boutique, un e-mail ou un annonceur enregistré conserve aussi une copie de sa fiche telle que vous l'avez enregistrée. Quand cette copie a un jour, elle est relue, de sorte qu'un tableau affiche le statut et les chiffres actuels d'une publicité. Si une fiche ne peut plus être lue, l'élément reste dans le tableau avec son id et sa dernière copie. Un produit enregistré conserve la copie affichée par une recherche, et en prend une plus récente quand une recherche ultérieure l'affiche de nouveau.
Créer un swipe file publicitaire dans Explorer, étape par étape
- Lancez une recherche dans Explorer, par exemple des publicités Meta avec Statut réglé sur Actif et au moins 30 Jours de diffusion.
- Appuyez sur Enregistrer sur une publicité, une boutique, un produit, un e-mail ou un annonceur. La liste Enregistrer dans un tableau s'ouvre, avec Favoris en premier et vos tableaux en dessous.
- Pour créer un nouveau tableau sur le moment, saisissez son nom dans Nouveau tableau et appuyez sur Créer. L'élément y est enregistré.
- Ouvrez Tableaux dans la barre de l'application. Vos tableaux se trouvent sous Actif, ceux que vous avez rangés sous Archivé, et les tableaux privés sous Personnel.
- Ouvrez un tableau pour voir ses éléments sous forme de cartes. Déplacez un élément vers un autre tableau, retirez-le, renommez le tableau ou déplacez-le dans un dossier.
- Appuyez sur Partager pour créer un lien public vers le tableau, et envoyez-le à un client ou à un collègue.
Ouvrir vos tableaux dans Explorer
Un autre réglage aide quand votre fichier grandit : dans une recherche de publicités Meta, Masquer les publicités enregistrées écarte les publicités que vous avez déjà enregistrées, pour que chaque nouvelle recherche ne vous montre que ce que vous n'avez pas encore gardé.
Comment organiser un swipe file qui reste utile
Un swipe file ne vaut que par la rapidité avec laquelle vous y retrouvez les choses. Quelques habitudes aident :
- Un tableau par question. « Accroches qui commencent par un problème », « Offres de livraison gratuite » ou « Concurrent X, T4 » sont plus faciles à utiliser qu'un seul tableau appelé « Bonnes pubs ».
- Des dossiers pour les clients ou les niches. Une agence peut donner un dossier à chaque client, avec un tableau pour ses concurrents, un pour les idées créatives et un pour les e-mails.
- Enregistrez toute la piste. Gardez la publicité, la boutique vers laquelle elle renvoie et son annonceur dans le même tableau, pour que le contexte reste avec elle.
- Archivez, ne supprimez pas. Archivez les tableaux d'une campagne quand elle se termine. Ils ne vous encombrent plus et reviennent en un clic.
- Partagez en lecture seule. Un lien de partage montre le tableau tel qu'il est, et vous supprimez le lien une fois le travail terminé.
Les publicités enregistrées sont le début de la recherche, pas la fin. Pour voir ce qu'une marque continue de diffuser, la bibliothèque publicitaire Meta trie ses publicités par jours de diffusion, et le suivi de marques suit ses publicités jour après jour.
Cas d'usage d'un swipe file
Recherche créative pour un lancement
Enregistrez dans un tableau les publicités de votre niche qui durent, puis ouvrez chacune d'elles pour voir son accroche, son texte et son format. Un tableau de vingt publicités au long cours constitue un brief pour vos propres visuels.
Des dossiers concurrents pour une agence
Gardez un dossier par client. Enregistrez les boutiques et les annonceurs de ses concurrents, ainsi que leurs meilleures publicités et leurs meilleurs e-mails, puis envoyez au client un seul lien de partage.
Un swipe file d'e-mails
Enregistrez les e-mails de bienvenue, de panier abandonné et de promotion qui vous plaisent depuis la bibliothèque d'e-mails marketing. Chaque e-mail enregistré conserve son objet et sa boutique, et s'ouvre en entier avec son HTML.
Tableaux, favoris et liens de partage depuis l'API et votre agent IA
Chaque action de l'application correspond à une requête. Créez un tableau, puis ajoutez-y des éléments par leur type et leur id :
# Create a board
curl -X POST "https://api.sellwinners.com/v1/boards" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Skincare hooks", "surface": "ads", "description": "Video ads that open with a problem"}'POST /v1/boards Paramètres et champs dans la documentation
# Add an item to a board
curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/items" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sourceType": "meta_ad", "sourceId": "AD_ID"}'POST /v1/boards/{boardId}/items Paramètres et champs dans la documentation
Les types d'éléments sont meta_ad, google_ad, tiktok, shop, email, advertiser et product. GET /v1/boards/{boardId}/items?include=item liste les éléments d'un tableau avec leurs copies enregistrées (item vaut null pour un élément dont la fiche n'a pas pu être lue, conservé par son id), et POST /v1/boards/{boardId}/share-links crée son lien public.
Votre agent IA enregistre au fil de ses recherches : demandez-lui de « trouver cinq publicités vidéo de soins de la peau qui durent et de les enregistrer dans un nouveau tableau appelé Accroches skincare », et il appelle search_ads, create_board et add_board_item. Un lien de partage nécessite d'abord votre confirmation. Les outils utilisent la même clé et les mêmes crédits que l'API.
Toutes les routes figurent dans la référence de l'API des tableaux.
Enregistrer avec l'offre Free et avec les offres payantes
Les tableaux, les favoris et les liens de partage sont réservés aux offres payantes. Si vous passez ensuite à l'offre Free, ce que vous avez enregistré reste lisible, vous pouvez le rechercher et le supprimer, et vos liens de partage sont suspendus jusqu'à ce que vous repreniez une offre supérieure, puis fonctionnent comme avant. Avec l'offre Free, une publicité Meta ou une boutique enregistrée est toujours relue une fois sa copie vieille d'un jour, et une publicité Google, un e-mail ou un produit enregistré affiche sa copie telle qu'elle a été conservée. Voir ce que comprend chaque offre.
Commencez votre swipe file
Aucune carte bancaire n'est nécessaire. L'offre Free comprend l'application web et le serveur MCP (150 crédits par mois), sans l'API. L'API et les autres jeux de données nécessitent une offre payante. Les offres payantes commencent à €39 par mois.
Questions fréquentes
Qu'est-ce qu'un swipe file publicitaire ?
Une collection de publicités que vous avez enregistrées pour vous en inspirer : leurs accroches, leurs offres, leurs formats. Dans SellWinners, c'est un ensemble de tableaux qui peuvent contenir des publicités Meta, Google et TikTok, des boutiques, des produits, des e-mails et des annonceurs, chaque élément enregistré étant lié à sa fiche.
Que puis-je enregistrer ?
Des publicités Meta, des publicités Google, des publicités et publications TikTok, des boutiques, des produits, des e-mails et des annonceurs. Les favoris sont le moyen rapide d'enregistrer une publicité, une boutique ou un e-mail ; les tableaux peuvent contenir n'importe lequel de ces éléments.
Combien de tableaux et d'éléments puis-je conserver ?
Jusqu'à 500 tableaux par compte, et jusqu'à 5 000 éléments par tableau. Un dossier est un tableau qui contient d'autres tableaux, ce qui vous permet de les regrouper par client, niche ou campagne.
Puis-je partager un tableau avec mon équipe ou un client ?
Oui. Appuyez sur Partager sur un tableau pour créer un lien public. Toute personne disposant du lien peut ouvrir le tableau sans compte, et vous pouvez supprimer le lien à tout moment. Un dossier de favoris ou une seule publicité peut aussi avoir son propre lien.
Une publicité enregistrée reste-t-elle à jour ?
Oui pour une publicité Meta, une publicité Google, une publication TikTok, une boutique, un e-mail ou un annonceur enregistrés : l'élément conserve une copie de sa fiche, et cette copie est relue dès qu'elle a un jour, de sorte qu'un tableau affiche le statut actuel de la publicité. Si la fiche ne peut plus être lue, l'élément conserve son ID et sa dernière copie. Un produit enregistré conserve la copie qu'affichait une recherche, et en prend une plus récente lorsqu'une recherche ultérieure l'affiche à nouveau.
Puis-je enregistrer des publicités avec l'offre Free ?
Non, les tableaux, les favoris et les liens de partage sont réservés aux offres payantes. Un compte qui passe à l'offre Free conserve ce qu'il a enregistré pour le lire, le rechercher et le supprimer, et ses liens de partage sont suspendus jusqu'à ce qu'il repasse à une offre payante. Consultez les offres et leurs prix.
Fonctionnalités associées
Bibliothèque de publicités
Recherchez les publicités Meta, Google, YouTube et TikTok avec leurs visuels, leurs textes et leurs signaux.
Bibliothèque d'e-mails
Parcourez les e-mails marketing envoyés par les marques, par type de campagne, promotion et événement.
Boutiques
Trouvez les boutiques Shopify en forte croissance et filtrez-les par trafic, ventes, publicités et technologies.