Swipe file voor advertenties: bewaar wat je vindt, geordend zoals jij wilt
Bewaar tijdens je onderzoek advertenties, winkels, producten, e-mails en adverteerders, orden ze in borden en mappen, en deel een bord, een favorietenmap of een advertentie met een openbare link. Alles wat je bewaart, hoort bij je account.
- 9 REST-endpoints hieronder
- 7 MCP-tools
- Eén sleutel voor allebei
- Lees de documentatie
# Mappen: a first request curl "https://api.sellwinners.com/v1/boards" \ -H "Authorization: Bearer YOUR_API_KEY" # The answer is JSON: # {"requestId": "...", "data": ...}
Wat je krijgt met Mappen
Borden en mappen
Een bord bevat bewaarde items; een map bevat borden. Verplaats, hernoem, archiveer en herstel ze naarmate je onderzoek groeit.
Bewaar bijna alles
Meta-advertenties, Google-advertenties, TikTok-items, winkels, producten, e-mails en adverteerders.
Favorieten
Een snellere manier om te bewaren: markeer een advertentie, een winkel of een e-mail als favoriet, met of zonder map.
Deellinks
Maak een openbare link naar een bord, een favorietenmap of één advertentie. Iedereen met de link kan hem openen, en elke link kan op elk moment worden verwijderd.
Drie stappen
Een bord maken
Geef het een naam en zeg wat erin zit.
Bewaar terwijl je zoekt
Voeg een item toe met zijn type en zijn ID, direct vanuit een zoekresultaat.
Deel of verberg
Stuur een openbare link, of laat een zoekopdracht naar Meta-advertenties de advertenties weglaten die je al hebt bewaard.
De endpoints erachter
Elk endpoint is gedocumenteerd met zijn parameters. Selecteer een rij om het in de documentatie te openen.
/v1/boardsBorden opvragen
POST/v1/boardsEen bord maken
POST/v1/boards/{boardId}/itemsEen item aan een bord toevoegen
POST/v1/boards/{boardId}/items/{itemId}/moveEen item naar een ander bord verplaatsen
POST/v1/boards/{boardId}/share-linksEen openbare link naar een bord maken
GET/v1/favorites/adsFavoriete advertenties opvragen
POST/v1/favorites/adsEen favoriete advertentie bewaren
POST/v1/favorites/ads/foldersEen map voor favoriete advertenties maken
POST/v1/ads/{adId}/shareEen openbare link naar een advertentie maken (of teruggeven)
Dezelfde functie voor je AI-agent
Deze tools gebruiken dezelfde sleutel en dezelfde credits als de REST API.
create_boardEen bord makenadd_board_itemEen item op een collectiebord bewarenlist_board_itemsDe items die op een bord zijn bewaardcreate_board_share_linkEen openbare link naar een bord makenadd_favorite_itemEen advertentie, een winkel of een e-mail bewarenlist_favoritesJe bewaarde advertenties, winkels of e-mailscreate_favorite_folderEen favorietenmap makenEen swipe file met advertenties is een verzameling advertenties die je hebt bewaard omdat je er iets van kunt leren. In SellWinners is het een set borden: bewaar tijdens je onderzoek Meta-, Google- en TikTok-advertenties, winkels, producten, e-mails en adverteerders, sorteer ze in mappen, en deel een bord met een link als iemand anders het moet zien.
Zonder swipe file belanden goede vondsten in screenshots en browsertabbladen. Met een swipe file blijft elk bewaard item gekoppeld aan het record, zodat je weken later de advertentie nog kunt openen, de tekst kunt lezen en kunt doorklikken naar de winkel erachter.
Hoe borden, mappen en favorieten samenhangen
| Onderdeel | Wat het doet |
|---|---|
| Bord | Bevat bewaarde items, tot 5.000 op één bord. Je geeft het een naam en zegt waarvoor het is: advertenties, winkels, landingspagina's, e-mails, producten of adverteerders |
| Map | Een bord dat andere borden bevat, zodat een klant, een niche of een campagne zijn borden bij elkaar kan houden. Borden kun je in en uit mappen verplaatsen |
| Favorieten | De snelle manier om een advertentie, een winkel of een e-mail te bewaren. Favorieten krijgen hun eigen mappen, en een favoriet die je zonder map bewaart, komt op je bord Favorieten terecht |
| Archiveren | Een bord archiveren zet het weg met alles wat eronder valt. Het tabblad Gearchiveerd bewaart het, en je kunt het herstellen |
| Deellink | Een openbare link naar een bord, een favorietenmap of één advertentie. Iedereen met de link kan die openen zonder account, en je kunt de link op elk moment verwijderen |
Een account bevat tot 500 borden. Bewaar je hetzelfde item twee keer op één bord, dan blijft het één keer staan.
Wat een bewaard item vasthoudt
Elk bewaard item houdt zijn ID. Een bewaarde Meta-advertentie, Google-advertentie, TikTok-post, winkel, e-mail of adverteerder houdt ook een kopie van het record zoals je het bewaarde. Is die kopie een dag oud, dan wordt het record opnieuw gelezen, zodat een bord de actuele status en cijfers van een advertentie toont. Kan een record niet meer worden gelezen, dan blijft het item op het bord staan met zijn ID en zijn laatste kopie. Een bewaard product houdt de kopie die een zoekopdracht toonde, en neemt een nieuwere over wanneer een latere zoekopdracht het opnieuw toont.
Bouw een swipe file met advertenties in Verkennen, stap voor stap
- Voer een zoekopdracht uit in Verkennen, bijvoorbeeld Meta-advertenties met Status op Actief en minstens 30 Dagen actief.
- Druk op Opslaan bij een advertentie, een winkel, een product, een e-mail of een adverteerder. De lijst Bewaren in een bord opent met Favorieten bovenaan en je borden daaronder.
- Wil je meteen een nieuw bord beginnen, typ dan de naam in Nieuw bord en druk op Maken. Het item wordt daarin bewaard.
- Open Borden in de appbalk. Je borden staan onder Actief, de borden die je hebt weggezet onder Gearchiveerd, en de privéborden onder Persoonlijk.
- Open een bord om de items als kaarten te zien. Verplaats een item naar een ander bord, verwijder het, geef het bord een nieuwe naam of verplaats het bord naar een map.
- Druk op Delen om een openbare link naar het bord te maken, en stuur die naar een klant of een teamgenoot.
Nog één instelling helpt zodra je swipe file groeit: in een zoekopdracht naar Meta-advertenties laat Bewaarde advertenties verbergen de advertenties weg die je al hebt bewaard, zodat elke nieuwe zoekopdracht je alleen toont wat je nog niet hebt bewaard.
Zo orden je een swipe file die bruikbaar blijft
Een swipe file is zo goed als de snelheid waarmee je er iets in terugvindt. Een paar gewoontes helpen:
- Eén bord per vraag. 'Hooks die openen met een probleem', 'Aanbiedingen met gratis verzending' of 'Concurrent X, Q4' zijn handiger dan één bord met de naam 'Goede advertenties'.
- Mappen voor klanten of niches. Een bureau kan elke klant een map geven, met een bord voor de concurrenten, een voor creatieve ideeën en een voor e-mails.
- Bewaar het hele spoor. Houd de advertentie, de winkel waarnaar hij linkt en de adverteerder op hetzelfde bord, zodat de context meereist.
- Archiveer, verwijder niet. Archiveer de borden van een campagne als die afloopt. Ze staan dan niet in de weg en komen met één klik terug.
- Deel alleen-lezen. Een deellink toont het bord zoals het is, en je verwijdert de link als het werk klaar is.
Bewaarde advertenties zijn het begin van het onderzoek, niet het einde. Om te zien wat een merk blijft draaien, sorteert de Meta-advertentiebibliotheek de advertenties op dagen actief, en volgt de merktracker de advertenties dag voor dag.
Toepassingen van een swipe file
Creatief onderzoek voor een lancering
Bewaar de langlopende advertenties van je niche op een bord en open daarna elke advertentie voor de hook, de tekst en het formaat. Een bord met twintig langlopers is een briefing voor je eigen creatives.
Concurrentiedossiers voor een bureau
Houd per klant een map bij. Bewaar de winkels en adverteerders van de concurrenten, en hun beste advertenties en e-mails, en stuur de klant daarna één deellink.
Een swipe file met e-mails
Bewaar de welkomstmails, e-mails voor verlaten winkelwagens en uitverkoopmails die je goed vindt uit de e-mailmarketingbibliotheek. Elke bewaarde e-mail houdt zijn onderwerp en zijn winkel, en opent volledig met de HTML.
Borden, favorieten en deellinks via de API en je AI-agent
Elke actie in de app is één verzoek. Maak een bord en voeg er daarna items aan toe op type en 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 Parameters en velden in de documentatie
# 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 Parameters en velden in de documentatie
De itemtypes zijn meta_ad, google_ad, tiktok, shop, email, advertiser en product. GET /v1/boards/{boardId}/items?include=item toont de items van een bord met hun bewaarde kopieën (item is null voor een item waarvan het record niet kon worden gelezen, bewaard op zijn ID), en POST /v1/boards/{boardId}/share-links maakt de openbare link.
Je AI-agent bewaart terwijl hij onderzoek doet: vraag hem 'vind vijf langlopende videoadvertenties voor huidverzorging en bewaar ze op een nieuw bord met de naam Huidverzorgingshooks', en hij roept search_ads, create_board en add_board_item aan. Voor een deellink is eerst je bevestiging nodig. De tools gebruiken dezelfde sleutel en credits als de API.
Elke route staat in de API-referentie voor borden.
Bewaren op Free en bij betaalde abonnementen
Borden, favorieten en deellinks horen bij betaalde abonnementen. Stap je later over naar Free, dan blijft wat je hebt bewaard leesbaar, kun je het doorzoeken en verwijderen, en worden je deellinks gepauzeerd tot je weer upgradet, waarna ze werken zoals voorheen. Op Free wordt een bewaarde Meta-advertentie of winkel nog steeds opnieuw gelezen zodra de kopie een dag oud is, en toont een bewaarde Google-advertentie, e-mail of product de kopie zoals die is bewaard. Bekijk wat elk abonnement omvat.
Begin je swipe file
Er is geen kaart nodig. Het Free-abonnement omvat de web-app en de MCP-server (150 credits per maand), zonder de API. Voor de API en de andere datasets heb je een betaald abonnement nodig. Betaalde abonnementen beginnen bij €39 per maand.
Veelgestelde vragen
Wat is een swipe file voor advertenties?
Een verzameling advertenties die je hebt bewaard om ervan te leren: hun hooks, hun aanbiedingen, hun formaten. In SellWinners is het een reeks borden die Meta-, Google- en TikTok-advertenties, winkels, producten, e-mails en adverteerders kunnen bevatten, waarbij elk bewaard item aan zijn record is gekoppeld.
Wat kan ik bewaren?
Meta-advertenties, Google-advertenties, TikTok-advertenties en -posts, winkels, producten, e-mails en adverteerders. Favorieten zijn de snelle manier om een advertentie, een winkel of een e-mail te bewaren; borden kunnen al deze items bevatten.
Hoeveel borden en items kan ik bewaren?
Tot 500 borden per account, en tot 5.000 items op één bord. Een map is een bord dat andere borden bevat, zodat je ze kunt groeperen per klant, niche of campagne.
Kan ik een bord delen met mijn team of een klant?
Ja. Druk op Delen bij een bord om een openbare link te maken. Iedereen met de link kan het bord zonder account openen, en je kunt de link op elk moment verwijderen. Een favorietenmap of één advertentie kan ook een eigen link hebben.
Blijft een bewaarde advertentie actueel?
Een bewaarde Meta-advertentie, Google-advertentie, TikTok-post, winkel, e-mail of adverteerder wel: die bewaart een kopie van zijn record, en de kopie wordt opnieuw gelezen zodra ze een dag oud is, zodat een bord de huidige status van de advertentie toont. Kan het record niet meer worden gelezen, dan houdt het item zijn ID en zijn laatste kopie. Een bewaard product houdt de kopie die een zoekopdracht toonde, en krijgt een nieuwere als een latere zoekopdracht het opnieuw toont.
Kan ik advertenties bewaren met het Free-abonnement?
Nee, borden, favorieten en deellinks horen bij betaalde abonnementen. Een account dat naar Free overgaat, houdt wat het heeft bewaard om te lezen, te doorzoeken en te verwijderen, en zijn deellinks worden gepauzeerd tot het opnieuw upgradet. Bekijk de abonnementen en hun prijzen.
Gerelateerde functies
Advertentiebibliotheek
Doorzoek advertenties op Meta, Google, YouTube en TikTok met hun creatives, teksten en signalen.
E-mailbibliotheek
Blader door de marketingmails die merken versturen, per type campagne, actie en evenement.
Winkels
Vind snelgroeiende Shopify-winkels en filter ze op verkeer, omzet, advertenties en techniek.