Swipe file di annunci: conserva ciò che trovi, organizzato a modo tuo
Salva annunci, negozi, prodotti, email e inserzionisti mentre fai ricerca, ordinali in bacheche e cartelle, e condividi una bacheca, una cartella di preferiti o un annuncio con un link pubblico. Tutto ciò che salvi appartiene al tuo account.
- 9 endpoint REST mostrati qui sotto
- 7 strumenti MCP
- Una sola chiave per entrambi
- Leggi la documentazione
# Cartelle: a first request curl "https://api.sellwinners.com/v1/boards" \ -H "Authorization: Bearer YOUR_API_KEY" # The answer is JSON: # {"requestId": "...", "data": ...}
Cosa ottieni con Cartelle
Bacheche e cartelle
Una bacheca contiene gli elementi salvati; una cartella contiene le bacheche. Spostale, rinominale, archiviale e ripristinale man mano che la tua ricerca cresce.
Salva quasi tutto
Annunci Meta, annunci Google, elementi TikTok, negozi, prodotti, email e inserzionisti.
Preferiti
Un modo più rapido per salvare: aggiungi ai preferiti un annuncio, un negozio o un'email, con o senza cartella.
Link di condivisione
Crea un link pubblico a una bacheca, a una cartella di preferiti o a un singolo annuncio. Chiunque abbia il link può aprirlo, e qualsiasi link può essere rimosso in qualsiasi momento.
Tre passaggi
Crea una bacheca
Dalle un nome e indica cosa contiene.
Salva mentre cerchi
Aggiungi un elemento con il suo tipo e il suo id, direttamente da un risultato di ricerca.
Condividi o nascondi
Invia un link pubblico, oppure chiedi a una ricerca di annunci Meta di escludere gli annunci che hai già salvato.
Gli endpoint che la alimentano
Ognuno è documentato con i suoi parametri. Seleziona una riga per aprirlo nella documentazione.
/v1/boardsElenca le bacheche
POST/v1/boardsCrea una bacheca
POST/v1/boards/{boardId}/itemsAggiungi un elemento a una bacheca
POST/v1/boards/{boardId}/items/{itemId}/moveSposta un elemento in un'altra bacheca
POST/v1/boards/{boardId}/share-linksCrea un link pubblico a una bacheca
GET/v1/favorites/adsElenca gli annunci preferiti
POST/v1/favorites/adsSalva un annuncio preferito
POST/v1/favorites/ads/foldersCrea una cartella di annunci preferiti
POST/v1/ads/{adId}/shareCrea (o restituisce) un link pubblico a un annuncio
La stessa funzionalità per il tuo agente IA
Questi strumenti usano la stessa chiave e gli stessi crediti dell'API REST.
create_boardCrea una bachecaadd_board_itemSalva un elemento in una bacheca raccoltalist_board_itemsGli elementi salvati in una bachecacreate_board_share_linkCrea un link pubblico a una bachecaadd_favorite_itemSalva un annuncio, un negozio o un'emaillist_favoritesI tuoi annunci, negozi o email salvaticreate_favorite_folderCrea una cartella di preferitiUno swipe file di annunci è una raccolta di annunci che hai conservato perché c'è qualcosa da imparare. In SellWinners è un insieme di bacheche: salva annunci Meta, Google e TikTok, negozi, prodotti, email e inserzionisti mentre fai ricerca, ordinali in cartelle e condividi una bacheca con un link quando qualcun altro deve vederla.
Senza uno swipe file, le scoperte migliori finiscono in screenshot e schede del browser. Con uno, ogni elemento salvato resta collegato alla sua scheda, così settimane dopo puoi ancora aprire l'annuncio, leggerne il testo e risalire al negozio che c'è dietro.
Come si combinano bacheche, cartelle e preferiti
| Parte | Cosa fa |
|---|---|
| Bacheca | Contiene gli elementi salvati, fino a 5.000 in una bacheca. Le dai un nome e indichi a cosa serve: annunci, negozi, landing page, email, prodotti o inserzionisti |
| Cartella | Una bacheca che contiene altre bacheche, così un cliente, una nicchia o una campagna possono tenere insieme le loro bacheche. Le bacheche entrano ed escono dalle cartelle |
| Preferiti | Il modo rapido per salvare un annuncio, un negozio o un'email. I preferiti hanno le loro cartelle, e un preferito salvato senza cartella finisce nella tua bacheca Preferiti |
| Archivia | Archiviare una bacheca la mette da parte con tutto ciò che contiene. La scheda Archiviato la conserva, e puoi ripristinarla |
| Link di condivisione | Un link pubblico a una bacheca, a una cartella di preferiti o a un singolo annuncio. Chiunque abbia il link può aprirlo senza un account, e puoi rimuoverlo in qualsiasi momento |
Un account contiene fino a 500 bacheche. Se salvi due volte lo stesso elemento in una bacheca, viene conservato una sola volta.
Cosa conserva un elemento salvato
Ogni elemento salvato conserva il suo id. Un annuncio Meta, un annuncio Google, un post TikTok, un negozio, un'email o un inserzionista salvati conservano anche una copia della loro scheda così come l'hai salvata. Quando quella copia ha un giorno, viene letta di nuovo, così una bacheca mostra lo stato e i numeri attuali di un annuncio. Se una scheda non può più essere letta, l'elemento resta nella bacheca con il suo id e la sua ultima copia. Un prodotto salvato conserva la copia mostrata da una ricerca, e ne prende una più recente quando una ricerca successiva lo mostra di nuovo.
Crea uno swipe file di annunci in Esplora, passo dopo passo
- Esegui una ricerca in Esplora, per esempio annunci Meta con Stato impostato su Attivo e almeno 30 Giorni di attività.
- Premi Salva su un annuncio, un negozio, un prodotto, un'email o un inserzionista. Si apre l'elenco Salva in una bacheca, con Preferiti in cima e le tue bacheche sotto.
- Per creare subito una nuova bacheca, scrivi il suo nome in Nuova bacheca e premi Crea. L'elemento viene salvato lì.
- Apri Bacheche nella barra dell'app. Le tue bacheche sono in Attivo, quelle che hai messo da parte in Archiviato e quelle private in Personale.
- Apri una bacheca per vederne gli elementi come schede. Sposta un elemento in un'altra bacheca, rimuovilo, rinomina la bacheca o spostala in una cartella.
- Premi Condividi per creare un link pubblico alla bacheca, e invialo a un cliente o a un collega.
Apri le tue bacheche in Esplora
Un'altra impostazione aiuta quando il tuo swipe file cresce: in una ricerca di annunci Meta, Nascondi annunci salvati esclude gli annunci che hai già salvato, così ogni nuova ricerca ti mostra solo ciò che non hai ancora conservato.
Come organizzare uno swipe file che resti utile
Uno swipe file vale quanto la velocità con cui ci trovi le cose. Aiutano alcune abitudini:
- Una bacheca per domanda. «Hook che si aprono con un problema», «Offerte con spedizione gratuita» o «Concorrente X, Q4» sono più facili da usare di un'unica bacheca chiamata «Annunci buoni».
- Cartelle per clienti o nicchie. Un'agenzia può dare a ogni cliente una cartella, con una bacheca per i suoi concorrenti, una per le idee creative e una per le email.
- Salva l'intero percorso. Tieni l'annuncio, il negozio a cui rimanda e il suo inserzionista nella stessa bacheca, così il contesto viaggia con lui.
- Archivia, non eliminare. Archivia le bacheche di una campagna quando finisce. Non ti intralciano e tornano con un clic.
- Condividi in sola lettura. Un link di condivisione mostra la bacheca così com'è, e rimuovi il link quando il lavoro è finito.
Gli annunci salvati sono l'inizio della ricerca, non la fine. Per vedere cosa continua a far girare un marchio, la libreria inserzioni Meta ordina i suoi annunci per giorni di attività, e il monitoraggio marchi segue i suoi annunci giorno per giorno.
Casi d'uso dello swipe file
Ricerca creativa per un lancio
Salva in una bacheca gli annunci attivi da più tempo della tua nicchia, poi apri ciascuno per vederne l'hook, il testo e il formato. Una bacheca di venti annunci di lunga durata è un brief per le tue creatività.
Archivi sui concorrenti per un'agenzia
Tieni una cartella per cliente. Salva i negozi e gli inserzionisti dei suoi concorrenti, e i loro annunci ed email migliori, poi invia al cliente un unico link di condivisione.
Uno swipe file di email
Salva dalla libreria di email marketing le email di benvenuto, di carrello abbandonato e di promozione che ti piacciono. Ogni email salvata conserva il suo oggetto e il suo negozio, e si apre per intero con il suo HTML.
Bacheche, preferiti e link di condivisione dall'API e dal tuo agente IA
Ogni azione nell'app è una richiesta. Crea una bacheca, poi aggiungi elementi indicandone tipo e 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 Parametri e campi nella documentazione
# 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 Parametri e campi nella documentazione
I tipi di elemento sono meta_ad, google_ad, tiktok, shop, email, advertiser e product. GET /v1/boards/{boardId}/items?include=item elenca gli elementi di una bacheca con le loro copie salvate (item è null per un elemento la cui scheda non è stata letta, conservato tramite il suo id), e POST /v1/boards/{boardId}/share-links crea il suo link pubblico.
Il tuo agente IA salva mentre fa ricerca: chiedigli di «trovare cinque annunci video di skincare attivi da molto tempo e salvarli in una nuova bacheca chiamata Skincare hooks», e chiama search_ads, create_board e add_board_item. Un link di condivisione richiede prima la tua conferma. Gli strumenti usano la stessa chiave e gli stessi crediti dell'API.
Ogni route si trova nel riferimento API delle bacheche.
Salvare con Free e con i piani a pagamento
Bacheche, preferiti e link di condivisione fanno parte dei piani a pagamento. Se in seguito passi a Free, ciò che hai salvato resta leggibile, puoi cercarlo e rimuoverlo, e i tuoi link di condivisione vengono sospesi finché non passi di nuovo a un piano superiore, poi funzionano come prima. Con Free, un annuncio Meta o un negozio salvati vengono comunque riletti quando la loro copia ha un giorno, e un annuncio Google, un'email o un prodotto salvati mostrano la loro copia così come è stata conservata. Scopri cosa include ogni piano.
Inizia il tuo swipe file
Non serve alcuna carta. Il piano Free include l'app web e il server MCP (150 crediti al mese), senza l'API. L'API e gli altri dataset richiedono un piano a pagamento. I piani a pagamento partono da €39 al mese.
Domande frequenti
Che cos'è uno swipe file di annunci?
Una raccolta di annunci che hai salvato per imparare da loro: i loro hook, le loro offerte, i loro formati. In SellWinners è un insieme di bacheche che possono contenere annunci Meta, Google e TikTok, negozi, prodotti, email e inserzionisti, con ogni elemento salvato collegato alla sua scheda.
Cosa posso salvare?
Annunci Meta, annunci Google, annunci e post TikTok, negozi, prodotti, email e inserzionisti. I preferiti sono il modo rapido per salvare un annuncio, un negozio o un'email; le bacheche possono contenere uno qualsiasi di questi elementi.
Quante bacheche ed elementi posso conservare?
Fino a 500 bacheche per account, e fino a 5.000 elementi in una bacheca. Una cartella è una bacheca che contiene altre bacheche, così puoi raggrupparle per cliente, nicchia o campagna.
Posso condividere una bacheca con il mio team o con un cliente?
Sì. Premi Condividi su una bacheca per creare un link pubblico. Chiunque abbia il link può aprire la bacheca senza account, e puoi rimuovere il link in qualsiasi momento. Anche una cartella di preferiti o un singolo annuncio possono avere un proprio link.
Un annuncio salvato resta aggiornato?
Un annuncio Meta, un annuncio Google, un post TikTok, un negozio, un'email o un inserzionista salvati sì: conservano una copia della loro scheda, e la copia viene riletta quando ha un giorno, così una bacheca mostra lo stato attuale dell'annuncio. Se la scheda non può più essere letta, l'elemento conserva il suo id e la sua ultima copia. Un prodotto salvato conserva la copia mostrata da una ricerca, e ne prende una più recente quando una ricerca successiva lo mostra di nuovo.
Posso salvare annunci con il piano Free?
No, bacheche, preferiti e link di condivisione fanno parte dei piani a pagamento. Un account che passa a Free conserva ciò che ha salvato per leggerlo, cercarlo e rimuoverlo, e i suoi link di condivisione restano sospesi finché non passa di nuovo a un piano a pagamento. Consulta i piani e i loro prezzi.
Funzionalità correlate
Libreria annunci
Cerca annunci Meta, Google, YouTube e TikTok con creatività, testi e segnali.
Libreria email
Sfoglia le email di marketing che i marchi inviano, per tipo di campagna, promozione ed evento.
Negozi
Trova i negozi Shopify in rapida crescita e filtrali per traffico, vendite, annunci e tecnologia.