Swipe file de anúncios: guarde o que você encontra, organizado do seu jeito
Salve anúncios, lojas, produtos, e-mails e anunciantes enquanto pesquisa, organize-os em quadros e pastas e compartilhe um quadro, uma pasta de favoritos ou um anúncio com um link público. Tudo o que você salva pertence à sua conta.
- 9 endpoints REST mostrados abaixo
- 7 ferramentas MCP
- Uma chave para os dois
- Ler a documentação
# Pastas: a first request curl "https://api.sellwinners.com/v1/boards" \ -H "Authorization: Bearer YOUR_API_KEY" # The answer is JSON: # {"requestId": "...", "data": ...}
O que você ganha com Pastas
Quadros e pastas
Um quadro guarda itens salvos; uma pasta guarda quadros. Mova, renomeie, arquive e restaure conforme sua pesquisa cresce.
Salve quase tudo
Anúncios da Meta, anúncios do Google, itens do TikTok, lojas, produtos, e-mails e anunciantes.
Favoritos
Um jeito mais rápido de salvar: favorite um anúncio, uma loja ou um e-mail, com ou sem pasta.
Links de compartilhamento
Crie um link público para um quadro, uma pasta de favoritos ou um único anúncio. Qualquer pessoa com o link pode abri-lo, e qualquer link pode ser removido a qualquer momento.
Três passos
Criar um quadro
Dê um nome e diga o que ele guarda.
Salve enquanto pesquisa
Adicione um item com o tipo e o id, direto de um resultado de busca.
Compartilhe ou oculte
Envie um link público ou peça a uma busca de anúncios da Meta que deixe de fora os anúncios que você já salvou.
Os endpoints por trás disso
Cada um é documentado com seus parâmetros. Selecione uma linha para abri-la na documentação.
/v1/boardsListar quadros
POST/v1/boardsCriar um quadro
POST/v1/boards/{boardId}/itemsAdicionar um item a um quadro
POST/v1/boards/{boardId}/items/{itemId}/moveMover um item para outro quadro
POST/v1/boards/{boardId}/share-linksCriar um link público para um quadro
GET/v1/favorites/adsListar anúncios favoritos
POST/v1/favorites/adsSalvar um anúncio favorito
POST/v1/favorites/ads/foldersCriar uma pasta de anúncios favoritos
POST/v1/ads/{adId}/shareCriar (ou retornar) um link público para um anúncio
A mesma funcionalidade para o seu agente de IA
Essas ferramentas usam a mesma chave e os mesmos créditos que a API REST.
create_boardCriar um quadroadd_board_itemSalvar um item em um quadro de coleçãolist_board_itemsOs itens salvos em um quadrocreate_board_share_linkCriar um link público para um quadroadd_favorite_itemSalvar um anúncio, uma loja ou um e-maillist_favoritesSeus anúncios, lojas ou e-mails salvoscreate_favorite_folderCriar uma pasta de favoritosUm swipe file de anúncios é uma coleção de anúncios que você guardou porque vale a pena aprender com eles. No SellWinners, ele é um conjunto de quadros: salve anúncios da Meta, do Google e do TikTok, lojas, produtos, e-mails e anunciantes enquanto pesquisa, organize-os em pastas e compartilhe um quadro por link quando outra pessoa precisar vê-lo.
Sem um, os bons achados acabam em capturas de tela e abas do navegador. Com um, cada item salvo continua vinculado ao seu registro, então semanas depois você ainda pode abrir o anúncio, ler o texto e segui-lo até a loja por trás dele.
Como quadros, pastas e favoritos se encaixam
| Parte | O que faz |
|---|---|
| Quadro | Guarda itens salvos, até 5.000 em um quadro. Você dá um nome a ele e diz para que serve: anúncios, lojas, páginas de destino, e-mails, produtos ou anunciantes |
| Pasta | Um quadro que contém outros quadros, para que um cliente, um nicho ou uma campanha mantenha seus quadros juntos. Os quadros entram e saem das pastas |
| Favoritos | A forma rápida de salvar um anúncio, uma loja ou um e-mail. Os favoritos têm pastas próprias, e um favorito salvo sem pasta vai para o seu quadro Favoritos |
| Arquivar | Arquivar um quadro guarda-o com tudo o que está dentro dele. A aba Arquivado o mantém, e você pode restaurá-lo |
| Link de compartilhamento | Um link público para um quadro, uma pasta de favoritos ou um único anúncio. Qualquer pessoa com o link pode abri-lo sem conta, e você pode removê-lo a qualquer momento |
Uma conta comporta até 500 quadros. Salvar o mesmo item duas vezes em um quadro o mantém uma vez só.
O que um item salvo guarda
Cada item salvo guarda o seu id. Um anúncio da Meta, um anúncio do Google, um post do TikTok, uma loja, um e-mail ou um anunciante salvo também guarda uma cópia do registro como estava quando você o salvou. Quando essa cópia completa um dia, ela é lida de novo, então um quadro mostra o status e os números atuais de um anúncio. Se um registro não puder mais ser lido, o item continua no quadro com o id e a última cópia. Um produto salvo guarda a cópia que uma busca mostrou e recebe uma mais nova quando uma busca posterior o mostra de novo.
Monte um swipe file de anúncios no Explorar, passo a passo
- Faça uma busca no Explorar, por exemplo anúncios da Meta com Status definido como Ativo e pelo menos 30 Dias no ar.
- Clique em Salvar em um anúncio, uma loja, um produto, um e-mail ou um anunciante. A lista Salvar em um quadro abre com Favoritos primeiro e seus quadros abaixo.
- Para criar um quadro na hora, digite o nome dele em Novo quadro e clique em Criar. O item é salvo nele.
- Abra Quadros na barra do app. Seus quadros ficam em Ativo, os que você guardou em Arquivado e os privados em Pessoal.
- Abra um quadro para ver os itens dele como cartões. Mova um item para outro quadro, remova-o, renomeie o quadro ou mova o quadro para uma pasta.
- Clique em Compartilhar para criar um link público para o quadro e envie-o a um cliente ou a um colega de equipe.
Abrir seus quadros no Explorar
Mais uma configuração ajuda quando o seu arquivo cresce: em uma busca de anúncios da Meta, Ocultar anúncios salvos deixa de fora os anúncios que você já salvou, para que cada nova busca mostre só o que você ainda não guardou.
Como organizar um swipe file que continue útil
Um swipe file só é tão bom quanto a rapidez com que você encontra as coisas nele. Alguns hábitos ajudam:
- Um quadro por pergunta. «Ganchos que abrem com um problema», «Ofertas de frete grátis» ou «Concorrente X, 4º tri» são mais fáceis de usar do que um único quadro chamado «Bons anúncios».
- Pastas para clientes ou nichos. Uma agência pode dar a cada cliente uma pasta, com um quadro para os concorrentes, um para ideias de criativos e um para e-mails.
- Salve o caminho inteiro. Mantenha o anúncio, a loja para a qual ele aponta e o anunciante no mesmo quadro, para que o contexto vá junto.
- Arquive, não apague. Arquive os quadros de uma campanha quando ela terminar. Eles saem do caminho e voltam com um clique.
- Compartilhe só para leitura. Um link de compartilhamento mostra o quadro como ele está, e você remove o link quando o trabalho termina.
Os anúncios salvos são o começo da pesquisa, não o fim. Para ver o que uma marca mantém no ar, a biblioteca de anúncios da Meta ordena os anúncios dela por dias no ar, e o Monitor de marcas acompanha os anúncios dela dia a dia.
Casos de uso de um swipe file
Pesquisa de criativos para um lançamento
Salve em um quadro os anúncios longevos do seu nicho e depois abra cada um para ver o gancho, o texto e o formato. Um quadro com vinte anúncios longevos é um briefing para os seus próprios criativos.
Arquivos de concorrentes para uma agência
Mantenha uma pasta por cliente. Salve as lojas e os anunciantes concorrentes e os melhores anúncios e e-mails deles, e depois envie ao cliente um único link de compartilhamento.
Um swipe file de e-mails
Salve os e-mails de boas-vindas, de carrinho abandonado e de liquidação de que você gostar da biblioteca de e-mail marketing. Cada e-mail salvo guarda o assunto e a loja, e abre por completo com o HTML.
Quadros, favoritos e links de compartilhamento pela API e pelo seu agente de IA
Cada ação no app é uma requisição. Crie um quadro e depois adicione itens a ele pelo tipo e pelo 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 Parâmetros e campos na documentação
# 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 Parâmetros e campos na documentação
Os tipos de item são meta_ad, google_ad, tiktok, shop, email, advertiser e product. GET /v1/boards/{boardId}/items?include=item lista os itens de um quadro com as cópias salvas (item é null para um item cujo registro não pôde ser lido, mantido pelo id), e POST /v1/boards/{boardId}/share-links cria o link público dele.
Seu agente de IA salva enquanto pesquisa: peça para ele «encontrar cinco anúncios em vídeo de skincare que estão no ar há muito tempo e salvá-los em um novo quadro chamado Ganchos de skincare», e ele chama search_ads, create_board e add_board_item. Um link de compartilhamento precisa primeiro da sua confirmação. As ferramentas usam a mesma chave e os mesmos créditos da API.
Todas as rotas estão na referência da API de quadros.
Salvar no Free e nos planos pagos
Quadros, favoritos e links de compartilhamento estão nos planos pagos. Se você passar para o Free depois, o que salvou continua legível, você pode pesquisar e remover, e seus links de compartilhamento ficam pausados até você fazer upgrade de novo, quando voltam a funcionar como antes. No Free, um anúncio da Meta ou uma loja salvos continuam sendo lidos de novo quando a cópia completa um dia, e um anúncio do Google, um e-mail ou um produto salvo mostra a cópia como foi guardada. Ver o que cada plano inclui.
Comece seu swipe file
Não é preciso cartão. O plano Free inclui o app web e o servidor MCP (150 créditos por mês), sem a API. A API e os outros conjuntos de dados exigem um plano pago. Os planos pagos começam em €39 por mês.
Perguntas frequentes
O que é um swipe file de anúncios?
Uma coleção de anúncios que você salvou para aprender com eles: os ganchos, as ofertas, os formatos. No SellWinners, é um conjunto de quadros que podem guardar anúncios da Meta, do Google e do TikTok, lojas, produtos, e-mails e anunciantes, com cada item salvo vinculado ao seu registro.
O que posso salvar?
Anúncios da Meta, anúncios do Google, anúncios e posts do TikTok, lojas, produtos, e-mails e anunciantes. Os favoritos são o jeito rápido de salvar um anúncio, uma loja ou um e-mail; os quadros guardam qualquer um deles.
Quantos quadros e itens posso guardar?
Até 500 quadros por conta e até 5.000 itens em um quadro. Uma pasta é um quadro que guarda outros quadros, para você agrupá-los por cliente, nicho ou campanha.
Posso compartilhar um quadro com minha equipe ou um cliente?
Sim. Clique em Compartilhar em um quadro para criar um link público. Qualquer pessoa com o link pode abrir o quadro sem conta, e você pode remover o link a qualquer momento. Uma pasta de favoritos ou um único anúncio também pode ter o próprio link.
Um anúncio salvo continua atualizado?
Um anúncio da Meta, um anúncio do Google, um post do TikTok, uma loja, um e-mail ou um anunciante salvo continua: ele guarda uma cópia do seu registro, e a cópia é lida de novo quando completa um dia, então um quadro mostra o status atual do anúncio. Se o registro não puder mais ser lido, o item mantém o id e a última cópia. Um produto salvo mantém a cópia que uma busca mostrou e recebe uma mais nova quando uma busca posterior o mostra de novo.
Posso salvar anúncios no plano Free?
Não, quadros, favoritos e links de compartilhamento estão nos planos pagos. Uma conta que passa para o Free mantém o que salvou para ler, pesquisar e remover, e os links de compartilhamento dela ficam pausados até um novo upgrade. Veja os planos e os preços.
Funcionalidades relacionadas
Biblioteca de anúncios
Pesquise anúncios da Meta, Google, YouTube e TikTok com criativos, textos e sinais.
Biblioteca de e-mails
Navegue pelos e-mails de marketing que as marcas enviam, por tipo de campanha, promoção e evento.
Lojas
Encontre lojas Shopify que crescem rápido e filtre por tráfego, vendas, anúncios e tecnologia.