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": ...}
À quoi ça sert

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.

Les tableaux, les favoris et les liens de partage sont réservés aux offres payantes : jusqu'à 500 tableaux et 5 000 éléments par tableau sur chaque compte.
Comment l'utiliser

Trois étapes

01

Créer un tableau

Donnez-lui un nom et indiquez ce qu'il contient.

02

Enregistrez pendant vos recherches

Ajoutez un élément avec son type et son ID, directement depuis un résultat de recherche.

03

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.

MCP

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 tableau
add_board_itemEnregistrer un élément dans un tableau collection
list_board_itemsLes éléments enregistrés dans un tableau
create_board_share_linkCréer un lien public vers un tableau
add_favorite_itemEnregistrer une publicité, une boutique ou un e-mail
list_favoritesVos publicités, boutiques ou e-mails enregistrés
create_favorite_folderCréer un dossier de favoris

Configurer le serveur MCP

Un 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

Les éléments de votre swipe file
ÉlémentÀ quoi ça sert
TableauContient 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
DossierUn 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
FavorisLe 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
ArchiverArchiver un tableau le range avec tout ce qu'il contient. L'onglet Archivé le conserve, et vous pouvez le restaurer
Lien de partageUn 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

  1. Lancez une recherche dans Explorer, par exemple des publicités Meta avec Statut réglé sur Actif et au moins 30 Jours de diffusion.
  2. 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.
  3. 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é.
  4. 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.
  5. 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.
  6. 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.

FAQ

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.