Documentação da API de dados de e-commerce

A API do SellWinners oferece inteligência de e-commerce e publicidade por HTTPS, com respostas em JSON: lojas Shopify com os produtos e o tráfego; produtos das lojas com preço, estimativas de vendas, avaliações e anúncios; anúncios da Meta, do Google e do TikTok; anunciantes; e os e-mails que as marcas enviam. Todos os endpoints também estão disponíveis para agentes de IA pelo nosso servidor MCP hospedado. Esta página aborda a autenticação, o formato das respostas, a paginação, a ordenação e os filtros, os limites de requisições e os créditos, os erros e as URLs de mídia, depois todos os endpoints, com os parâmetros e uma requisição de exemplo, e as ferramentas do servidor MCP.

Início rápido

1. Crie uma conta, confirme seu e-mail e escolha um plano pago: a API e o servidor MCP começam aí.
2. Abra Chaves de API e crie uma chave. Copie-a na hora: ela só é mostrada uma vez.
3. Faça sua primeira requisição:

curl "https://api.sellwinners.com/v1/lookup?q=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API = "https://api.sellwinners.com"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}

hit = requests.get(f"{API}/v1/lookup", params={"q": "allbirds.com", "type": "shop"}, headers=HEADERS).json()["data"][0]
shop = requests.get(f"{API}/v1/shops/{hit['shop']['id']}", headers=HEADERS).json()["data"]
print(shop["domain"], shop["traffic"]["monthlyVisits"])

const API = "https://api.sellwinners.com";
const headers = { "X-API-Key": process.env.API_KEY };

const found = await (await fetch(`${API}/v1/lookup?q=allbirds.com&type=shop`, { headers })).json();
const shop = (await (await fetch(`${API}/v1/shops/${found.data[0].shop.id}`, { headers })).json()).data;
console.log(shop.domain, shop.traffic.monthlyVisits);

Autenticação

Envie sua chave de API em todas as requisições no cabeçalho X-API-Key ou como um token bearer:

X-API-Key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEY

As chaves começam com ak_live_. Mantenha-as em segredo: não as coloque em código de front-end nem em repositórios públicos. Você pode criar várias chaves (uma por app ou ambiente) e revogar qualquer chave no seu painel; uma chave revogada para de funcionar imediatamente.

Respostas

Toda resposta é em JSON. Ela traz um requestId e o resultado em data: uma lista para buscas e listagens, um objeto para um único registro. As listas acrescentam um objeto pagination, e algumas respostas acrescentam meta.

{
  "requestId": "req_8f2c1a9b4d7e6f3a2b1c0d9e",
  "data": [
    {
      "id": "facebook_1203948571620394",
      "platform": "facebook",
      "status": "active",
      "daysRunning": 42,
      "media": { "type": "video", "thumbnailUrl": "https://api.sellwinners.com/v1/media/file/b7a0.jpg", "mediaUrl": "https://api.sellwinners.com/v1/media/file/4c1e.mp4" },
      "advertiser": { "id": "104958372615", "name": "Glow Labs", "liveAdsCount": 86 },
      "content": { "title": "Glass skin in 14 days", "body": "Dermatologist tested.", "callToAction": "Shop now", "landingPageUrl": "https://glowlabs.example/serum" },
      "metrics": { "reach": 184000, "estimatedSpend": 1656, "duplicates": 3 },
      "audience": { "targetedCountries": ["FR", "DE"], "mainCountry": "FR" },
      "rank": { "currentRank": 4, "rankDelta": -2, "improvementPct": 0.3333 },
      "flags": { "isEuAd": true },
      "extra": { "shop": { "domain": "glowlabs.example" } }
    }
  ],
  "pagination": { "page": 1, "limit": 25, "total": 1840, "totalPages": 74, "hasMore": true }
}

Os registros são objetos aninhados: um anúncio tem media, advertiser, content, metrics, audience, rank e flags, e as lojas, os anunciantes, os anúncios do Google, os itens do TikTok e os e-mails são agrupados da mesma forma. Um valor desconhecido é null. Os demais campos sem lugar fixo ficam em extra. O exemplo acima está resumido.

Em um anúncio, content.title é o título e content.callToAction é um texto legível, como «Shop now». metrics.estimatedSpend é a estimativa de investimento da fonte quando ela existe (um único anúncio de /v1/ads/{adId} a lê); caso contrário, é o alcance x 9 / 1000 (9 USD por 1.000 pessoas alcançadas); uma estimativa de investimento mantém duas casas decimais abaixo de 10 USD e fica em dólares inteiros a partir de 10 USD. rank.rankDelta é a posição atual menos a anterior, então um valor negativo significa que o anúncio subiu, e rank.improvementPct é uma fração (0.25 é um quarto).

Os relatórios de posição do monitor de marcas (/ad-rank, /scaling-ads, /v1/workspace/scaling-ads e a ferramenta MCP get_brandtracker_scaling_ads) acrescentam as próprias metrics: nelas, metrics.rankDelta é a posição anterior menos a atual (positivo: posições ganhas) e metrics.improvementPct é a fração da posição anterior que foi ganha, como em um anúncio (0.875 é 87,5%). Em um único anúncio, metrics.reachDelta1d, reachDelta7d e reachDelta30d são preenchidos a partir do histórico de alcance. As lojas nomeiam as categorias: catalog.mainCategory nas listagens, e também catalog.categories em uma única loja.

Em um anúncio do Google, media.type e media.format são text, image ou video, e media.url é a imagem do anúncio: para um anúncio em vídeo, a miniatura (não há arquivo de vídeo). transparencyUrl é o anúncio na Central de Transparência de Anúncios do Google, onde um anúncio em vídeo é reproduzido; é null quando o anúncio não tem ids do Google. network é search, youtube, shopping, maps ou other, e os valores de extra.networks também.

Alterado em 19 de outubro de 2026:

• O media.format de um anúncio do Google era um código de formato e agora é text, image ou video, o media.type pode ser text ou video, e extra.networks usa os nomes em minúsculas de network.
• Um media.url do Google nunca é um arquivo de vídeo, mesmo quando media.type é video.
• No filtro formats do Google, image agora significa anúncios de imagem (antes significava anúncios de texto), então use text para anúncios de texto. Os códigos anteriores static_image, html5_iframe e responsive_display, e os nomes curtos deles, continuam sendo aceitos.

O status de um anúncio do Google é active só enquanto o Google exibe o anúncio: um anúncio que o Google não exibe há mais de 7 dias fica unknown. daysRunning conta os dias de firstSeenAt a lastSeenAt, ambos incluídos; extra.servedDays é a contagem da própria fonte de dados, que continua depois que um anúncio para. Os filtros concordam com o que cada anúncio mostra: status=active mantém os anúncios que o Google exibiu nos últimos 7 dias e status=inactive, os anúncios que a fonte de dados marca como parados, então um anúncio unknown não entra em nenhum dos dois; minDaysRunning e maxDaysRunning mantêm os anúncios cujo daysRunning está no intervalo. Uma lista assim tem pagination.total nulo e, quando poucos dos anúncios lidos correspondem, termina antes, com meta.partial e um aviso.

Sem texto de busca, sortBy=relevance lista os mais recentes; sortBy=reach aceita só order=desc. Com status=active, sortBy=reach lista poucos anúncios: na ordem de alcance, os primeiros anúncios são, na maioria, anúncios que o Google parou de exibir, então ordene pelos mais recentes para ver os anúncios que o Google exibe agora (o aviso diz isso). Os anúncios do Google não aceitam sortBy=longestRunning: a fonte de dados o ordena por dias que continuam contando depois que um anúncio para, então ele listava anúncios que o Google não exibe mais, e a resposta é 400 com esse motivo.

extra.startIsFloor marca um anúncio visto pela primeira vez em 31 de maio de 2018, o primeiro dia dos dados de anúncios do Google, então ele pode ser mais antigo. audience.countries lista todos os países do público, com um percentage só para um anúncio exibido em um único país; remarketing e interest são null quando desconhecidos.

O Google informa um alcance só para alguns dos anúncios exibidos na UE, muitas vezes apenas como 10.000.000, o topo da escala dele (10 milhões ou mais): a maioria dos anúncios não tem nenhum, e nullReasons diz por que reach.value é null (not_reported: um anúncio exibido na UE para o qual o Google não informa nenhum; eu_only: um anúncio exibido em outro lugar), exceto quando é um alcance que o plano deixa de fora. extra.networks é a lista de plataformas do anúncio segundo a fonte de dados, que pode não citar network. extra.shop.google traz os totais do Google do site do anunciante; para um site que não é uma loja (uma loja de apps, uma rede social, um encurtador de links), advertiser.domain e websiteId são null.

Alterado em 20 de outubro de 2026:

• Um domínio (GET /v1/shops/{domain}, a consulta, um domain do TikTok, o briefing de concorrente) é o site com exatamente esse domínio, também fora do índice de lojas; um domínio que a fonte de dados não alcança responde 404.
• GET /v1/lookup ordena os resultados do melhor para o pior: o próprio site de um domínio, as próprias páginas do Facebook dele (a página principal primeiro) e depois as páginas com nome parecido; para um nome, o próprio site da marca e as próprias páginas dela (a página principal primeiro) e depois as lojas e páginas encontradas pelo nome.
• Quando o site da marca é encontrado, uma loja ou página que tem o nome só dentro de uma palavra fica de fora, e um site com esse nome só é exato quando veicula anúncios; caso contrário, uma correspondência de nome só é exata com tráfego ou anúncios. Páginas oficiais com outro nome e sem nenhum anúncio no ar vêm depois das páginas encontradas pelo nome.
• O signals.activeAdsSource de uma linha de loja diz de onde vêm os activeAds dela: page (os anúncios no ar da página principal, lidos agora, na própria linha da loja) ou index (a contagem do índice de lojas, que pode ser mais antiga).
• Uma busca de lojas por domínio (searchType=domain) lista primeiro o site exato, com extra.exactDomainMatch (e extra.inShopIndex falso quando o índice de lojas o deixa de fora).
• Para um site que não é uma loja (uma loja de apps, uma rede social ou de mensagens, um encurtador de links ou um redirecionamento de rastreamento), o extra.domain de uma linha de anunciante é nulo, um registro de anunciante o cita em extra.nonShopSite, deixa de fora extra.platforms e obtém linkedShops das páginas de destino dele (fromLandingPages), e um anúncio não tem shops.
• As datas e horas que a fonte de dados envia sem fuso horário estão em UTC e agora são enviadas com +00:00.
• Nas estatísticas de e-mails, as chaves de emailsByDayOfWeek são o número do dia: 0 é domingo, 6 é sábado.
• As linhas da consulta podem trazer nullReasons, e um registro de loja, meta.partial quando os números da listagem dele não puderam ser lidos.

Também alterado em 20 de outubro de 2026 (TikTok):

• O publishedAt de um item do TikTok está em UTC. Ele estava 1 ou 2 horas atrasado, então um post feito nas últimas horas de um dia em UTC aparecia no dia seguinte e com um daysRunning um dia a menos.
• Os filtros concordam com ele: publishedAfter e publishedBefore estão em UTC (uma data sozinha é o início do dia, e publishedBefore lista os posts anteriores a ela), minDaysRunning e maxDaysRunning contam a partir do dia em UTC, como daysRunning, e sortBy=longestRunning começa em 31 de agosto de 2016, às 22:00 UTC.

Também alterado em 20 de outubro de 2026 (anúncios do Google):

• GET /v1/google-ads, POST /v1/google-ads/query e a ferramenta MCP não aceitam sortBy=longestRunning (nem daysRunning) e respondem 400 com o motivo: a fonte de dados o ordena por dias que continuam contando depois que um anúncio para, então ele listava anúncios que o Google não exibe mais.
• Uma busca no Free cujos primeiros resultados ficam reduzidos com status=active responde meta.partial com um aviso que diz quantos dos anúncios lidos ela lista.
• Em extra.shop, um site sem dados de tráfego não tem monthlyVisits (antes era 0), um trafficGrowth30d só aparece junto com visitas acima de 0, e extra.shop.google deixa de fora um totalReach ou weeklyReach igual a 0 (nunca informado) e, quando não conta nenhum anúncio, as contagens iguais a 0.
• Um anúncio do Google salvo em um quadro é lido da mesma forma.

Também alterado em 20 de outubro de 2026 (lojas):

• Em GET /v1/shops/{shopId}, advertising.summary.reach30d é o alcance na UE dos últimos 30 dias, somado por data (antes era o total desde o início do monitoramento, agora totalReach), spend30d é esse alcance x 9 / 1000, extra.estimatedSpendUsd é o investimento desde o início do monitoramento e extra.adsLaunched30d soma os anúncios lançados nos últimos 30 dias; todos são nulos para uma loja sem alcance na UE ou no Reino Unido.
• Os registros de lojas, as lojas listadas e as estatísticas de e-mails trazem nullReasons, o caminho de um campo associado ao motivo de ele ser nulo: not_shopify (as vendas e os produtos são estimados só para lojas Shopify), no_estimate, not_measured, eu_uk_only, not_linked (sem perfil no TikTok), not_on_tp, no_reviews, none_found.
• Uma estimativa de vendas igual a zero junto com unidades vendidas é nula, nos registros, nas listagens e no histórico de vendas, cujo period=week tem um ponto por semana.
• traffic.growth30d é uma fração (-0.1543 é -15,4%), e traffic.history começa no primeiro mês com visitas.
• catalog.mainCategory vem dos ids de categoria (a mais específica do ramo principal), com catalog.categoryLeaves e productsCountCapped (25.001 é o teto da fonte de dados: 25.000 ou mais).
• Uma página do Trustpilot sem nenhuma avaliação tem nota nula.
• tiktok.matchedBy é socials ou handle quando os números do TikTok vêm dos perfis sociais da loja ou de um perfil encontrado pelo nome de usuário (uma correspondência, não um vínculo da fonte de dados).
• advertising.mainPageActiveAds são os anúncios no ar da página principal (a leitura da visão geral de anúncios dela, como a página principal em linkedAdvertisers a mostra; a contagem das listas de lojas só na falta dela) e linkedAdvertisers[].rank é a posição da página.
• As lojas semelhantes deixam de fora a própria loja e os sites dela, e cada página é completada com itens mais abaixo na lista (offset e limit contam a lista sem eles).
• Os produtos ordenados por popularidade colocam primeiro os mais vendidos da loja (meta.order).
• Os e-mails e as estatísticas de e-mails de uma loja contam todos os tipos de campanha, e os números de 90 dias deles são nulos quando desconhecidos.
• Uma ordenação por vendas lista uma linha por loja Shopify (extra.sharedSalesWith), e sortBy=estMonthlySales&order=asc deixa de fora as lojas sem estimativa.

Também alterado em 20 de outubro de 2026 (números das lojas):

• Uma ordenação por vendas de GET /v1/shops continua lendo além dos domínios que ela junta em uma linha por loja Shopify (antes parava depois das primeiras linhas), junta também os domínios de uma loja mais abaixo na lista, e o pagination.total dela é nulo até a lista ser lida até o fim; sortBy=estMonthlySales&order=asc começa em uma estimativa de 100 USD (minMonthlySales 100).
• Uma estimativa de vendas abaixo de 0,50 USD por unidade vendida é nula (no_estimate), nos registros, nas listagens e no histórico de vendas.
• traffic.monthlyVisits é nulo para um site ainda não medido, e traffic.growth30d, quando o mês anterior não teve visitas (not_measured); o growth30d de uma rede social vem do histórico de seguidores quando a fonte de dados dá 0 ou nada, e 0 seguidores é nulo (not_measured).
• As lojas listadas dizem por que catalog.productsCount e sales.unitsSold são nulos.
• extra.storeWide marca um domínio com 0 visitas que traz as vendas da loja dele (um 0 medido, ou outro domínio da loja, citado em extra.sharedSalesWith, tem as visitas; o Free deixa o nome fora de um registro de loja).
• advertising.mainPageActiveAds são os anúncios no ar da página principal, conforme a visão geral de anúncios dela os lê (a contagem das listas de lojas só na falta dela).
• As lojas semelhantes também deixam de fora as lojas de marca da loja, e extra.similarIndexed é falso para uma loja que o índice de semelhança não contém.
• catalog.mainCategory mantém o rótulo da própria fonte de dados só quando ele é o nome de uma categoria.
• Um arquivo de mídia que uma resposta trazia como link e que a fonte de dados não tem mais responde 200 com o corpo vazio e X-Media-Missing: true.

Também alterado em 20 de outubro de 2026 (anunciantes e anúncios da Meta):

• O alcance de um anunciante é o alcance na UE e no Reino Unido, nas próprias janelas da busca de anunciantes: advertising.reach30d, extra.reach14d, reach90d e totalReach são nulos para uma página sem anúncios na UE ou no Reino Unido e sem alcance, ou para uma janela que a fonte de dados não contou, e nullReasons diz por quê (eu_uk_only, not_measured); uma página criada dentro de uma janela tem todo o alcance nela (antes eram 0).
• Em GET /v1/advertisers/{advertiserId}, o alcance é o que as listas de anunciantes mostram (antes era lido 30 leituras para trás, e as leituras pulam dias), as estimativas de investimento são nulas junto com ele, extra.avgSpendUsd14d é o investimento diário médio de 14 dias, extra.avgActiveAds14d é a média de 14 dias dos anúncios no ar (antes eram os anúncios novos de 14 dias) e, quando a fonte de dados não a calculou, para uma página criada dentro dos 14 dias, ela vem dos anúncios no ar lidos desde o primeiro dia (extra.averagedFrom), senão é nula, e as contagens de anúncios novos de uma página criada dentro da janela contam todos os anúncios dela.
• advertising.countryDistribution é a parcela dos anúncios no ar que segmentam cada país (um anúncio segmenta vários), extra.reachCountries traz a parcela de cada país no alcance na UE, extra.platforms.meta traz os anúncios da própria página (antes trazia os da página principal da loja), uma contagem do TikTok ou do Google sem número fica de fora, extra.mainLandingPages recorre à prévia das páginas de destino de uma página nova, e os lastAds de uma página cujos anúncios a busca de anúncios ainda não incorporou são os mais recentes que a linha de anunciante dela lista, com meta.indexing, como em GET /v1/advertisers/{advertiser_id}/ads (com meta.liveAds).
• Novo: GET /v1/advertisers/{advertiserId}/history, os anúncios no ar da página e o alcance na UE que ela ganhou, dia a dia.
• Uma contagem de seguidores do Instagram igual a 0 é nula (a fonte de dados escreve 0 para uma página sem nenhuma conta que ela conheça).
• O metrics.reach de um anúncio da Meta e o investimento dele são nulos para um anúncio não exibido na UE nem no Reino Unido (eu_uk_only; antes eram 0 ou nulos) e para um anúncio da UE cujo alcance ainda não foi contado (not_measured; antes era 0), com as linhas de mídia dizendo o motivo em nullReasons.reach; media.type é carousel para um anúncio com mais de uma imagem ou vídeo, e extra.startIsFloor marca um anúncio iniciado em 1º de janeiro de 2018, o primeiro dia das datas de anúncios da Meta da fonte de dados.
• sortBy=adRank lista primeiro a melhor posição (1), seja qual for a ordem.
• Um único anúncio (GET /v1/ads/{adId}) usa o alcance mais recente que a fonte de dados informa e o investimento correspondente, conta as variações de alcance por data enquanto o histórico de alcance está atualizado (senão elas são nulas), lista as imagens e os vídeos como a linha de busca dele faz, preenche advertiser.reach30d e pageAnalytics.instagramFollowersHistory, acrescenta pageAnalytics.reachHistory (a mesma série de impressionsHistory) e nomeia uma loja que o registro traz só pelo id (com o traffic nulo e nullReasons shops.traffic quando o site não é medido); os audience.gender, ageMin, ageMax e metrics.aggregatedReach dele são sempre nulos, já que a fonte de dados não os informa para um único anúncio.
• Em uma busca de anunciantes, sortBy=reach ordena pelo alcance total desde o início do monitoramento, e newAds, pelos anúncios novos de 14 dias.
• A segmentação de um anúncio da Meta diz por que o alcance dele é nulo: eu_uk_only só para um anúncio que não segmenta nenhum país da UE nem o Reino Unido; um que segmenta algum, ou cuja segmentação ainda não é conhecida, é not_measured nos primeiros 7 dias e not_reported depois (antes eram eu_uk_only), nas listagens de anúncios, nas linhas de mídia e em um único anúncio.
• Um único anúncio lê os históricos de alcance e de investimento como uma só série, com uma leitura por dia (as variações também), e usa a última leitura e o investimento dessa série quando o alcance do registro é mais que o dobro dela e a série vai até o último dia do anúncio; o media dele recorre ao primeiro arquivo listado, e advertiser.totalReach, ao alcance na UE dos detalhes da página.
• Um registro de anunciante cuja linha não lê nenhum alcance, ao lado de detalhes da página que leem algum, fica com o alcance deles (extra.totalReach, o investimento correspondente, advertising.reach30d calculado sobre ele), as parcelas de extra.reachCountries dele nunca são arredondadas para 0, extra.averagedFrom nunca é anterior ao dia em que a página foi criada, e o histórico diário dele (extra.history, GET /v1/advertisers/{advertiserId}/history) deixa de fora as leituras que a fonte de dados perdeu (uma sequência de zeros de 14 dias ou menos entre leituras acima de 0).
• Um único anúncio que usa a leitura da série guarda o alcance do registro em extra.recordReach (o número que as listagens de anúncios mostram); em uma busca de anunciantes, uma linha que não lê nenhum alcance na UE, ao lado de detalhes da página que leem algum, fica com o alcance deles, como o registro dela; e GET /v1/advertisers/{advertiserId}/history mantém as leituras iguais a 0 de uma página sem nenhum anúncio na UE agora que ganhou alcance antes dos dias pedidos (ela não ganhou nenhum; antes eram deixadas de fora como not_measured).
• No Free, um anúncio cujo alcance é desconhecido diz o motivo, como nos planos pagos; só um alcance que o plano deixa de fora não tem motivo.

Também alterado em 20 de outubro de 2026 (estimativas de investimento):

• Um investimento estimado abaixo de 10 USD mantém duas casas decimais: um alcance de 140 a 9 USD por 1.000 pessoas alcançadas dá 1,26 (antes era 1), e uma média diária mantém os próprios centavos; a partir de 10 USD, uma estimativa de investimento fica em dólares inteiros (um alcance de 2.000 dá 18).
• Isso vale para extra.estimatedSpendUsd e extra.avgSpendUsd14d do registro de anunciante, advertising.summary.spend30d e extra.estimatedSpendUsd de uma loja, metrics.estimatedSpend de um anúncio da Meta e statistics.euData.estimatedSpend30d de uma marca monitorada e o estimatedSpend de cada ponto de /time-series (os dois tinham duas casas decimais em qualquer valor), tanto na API quanto nas ferramentas MCP. Quando o número da própria fonte de dados é essa estimativa em dólares inteiros, ele mantém os centavos da mesma forma.

Também alterado em 20 de outubro de 2026 (alcance dos anunciantes e histórico diário):

• GET /v1/advertisers/{advertiserId} acrescenta extra.reachScope: outside_eu_uk para uma página cujo alcance por país foi visto, em sua maior parte, fora da UE e do Reino Unido (a fonte de dados também informa o alcance de alguns anúncios exibidos em outros lugares; o alcance dela e as estimativas feitas a partir dele são então esse alcance, não o alcance na UE), senão eu_uk. O extra.avgSpendUsd14d de uma página criada dentro dos 14 dias é o investimento dela dividido pelos dias inteiros desde a criação (pelo menos um; antes era o alcance de 14 dias dividido por 14 dias quando a linha de anunciante tinha um).
• O extra.history do registro de anunciante e GET /v1/advertisers/{advertiserId}/history começam no dia em que a página foi criada; extra.history.newAds deixa de fora os 0 dos dias que a fonte de dados perdeu, extra.followersHistory e as curtidas e os seguidores de pageAnalytics de um anúncio deixam de fora um 0 entre duas leituras acima de 0 ou de um desses dias, e as estimativas diárias de investimento mantêm duas casas decimais abaixo de 10 USD.
• Uma página cujos anúncios no ar ainda não estão em nenhuma lista tem meta.indexing no registro e uma primeira página vazia de GET /v1/advertisers/{advertiser_id}/ads com meta.indexing e meta.liveAds.
• Um único anúncio (GET /v1/ads/{adId}): extra.spendHistory começa no dia em que o anúncio começou, cada spendUsd com duas casas decimais abaixo de 10 USD; advertiser.totalReach nunca fica abaixo da última leitura de pageAnalytics.reachHistory (extra.pageRecordReach traz então o total do registro, o que as listas de anunciantes mostram); extra.recordSpend é o investimento de extra.recordReach; extra.reachScope e extra.pageReachScope dizem onde foi vista a maior parte do alcance do anúncio e do alcance da página dele.

Também alterado em 20 de outubro de 2026 (monitores de marcas):

• Em GET /v1/brandtrackers e GET /v1/brandtrackers/{id}, um 0 em advertising.newAdsLastDay ao lado de lançamentos nos últimos 7 dias é conferido com os lançamentos da loja de ontem: a contagem deles, ou nulo (not_measured) sem leitura desse dia; uma listagem confere no máximo 20 marcas por chamada, as da página pedida.
• Em /top-ads e /v1/workspace/top-ads, metrics.totalReach é o alcance do anúncio na UE: nulo para um anúncio exibido fora da UE e do Reino Unido (eu_uk_only) ou para um anúncio da UE ainda não contado (not_measured), com nullReasons, e por último em uma ordenação por alcance (antes era 0).
• /testing calcula as estatísticas de alcance sobre os anúncios cujo alcance é conhecido, com nullReasons stats.reach para um lote sem nenhum.
• Em /hooks, /transcripts, /landing-pages e nos ganchos e páginas de destino do espaço de trabalho, um totalImpressions igual a 0 é nulo com o novo motivo no_eu_reach (nenhum alcance na UE ou no Reino Unido contado para os anúncios; not_measured com euOnly), por último na ordenação.
• Em /ad-rank, /scaling-ads e /v1/workspace/scaling-ads, quando o histórico de posições de um anúncio começa dentro de uma janela de 14 ou 30 dias, metrics.previousRank e rankDelta contam a partir da leitura mais antiga dele ali: metrics.since é esse dia e meta.windowNote informa isso, e um número que não pode ser dado é nulo com nullReasons.
• Em /partners, isOwnPage é verdadeiro para a página principal da loja, as páginas oficiais dela com nome parecido com o da marca e uma página com o mesmo nome da marca (criadores também podem ser classificados como oficiais), e um alcance ou investimento nulo tem nullReasons.
• A primeira página de /ads com adCopyHashes tem meta.latestAdDate e dataFreshnessLagDays e, com status=active, meta.stoppedCount.
• /demography é o público na UE e no Reino Unido, e um país abaixo de um décimo de milésimo do primeiro passa de countryDistribution para otherCountries.
• /ad-copy-evolution e /headline-evolution têm um ponto para cada dia registrado (0 quando o texto não foi usado, nulo em um dia cortado nos textos que guarda), classificam os textos pelo dia mais recente e deixam de fora os dias que a fonte de dados leu errado (anúncios no ar abaixo de um décimo dos dias ao redor, um dia ou 2 ou 3 seguidos, ou muito menos textos que os dias dos dois lados), como diz meta.periodNote; meta.recordedDays conta os dias. Os anúncios no ar semanais e mensais de /time-series também deixam de fora 2 ou 3 leituras desse tipo seguidas.

Também alterado em 20 de outubro de 2026 (relatórios do monitor de marcas, consulta e alcance do Google):

• Em /ad-rank, /scaling-ads e /v1/workspace/scaling-ads, todas as posições de uma linha vêm do histórico de posições do anúncio: metrics.currentRank é a leitura do dia em que a posição da biblioteca de anúncios foi lida (a posição que /top-ads mostra; a biblioteca pode estar um dia atrás do histórico), senão a leitura mais recente, a trajectory termina nesse dia e, sem leitura no dia em que a janela começa, vale a leitura mais antiga dentro dela (a variação da própria fonte de dados na janela não é mais usada).
• Os 50 primeiros anúncios da biblioteca de anúncios (10 por marca, entre várias marcas) são classificados de novo por esses números: um anúncio que, por eles, ganhou menos que minRankDelta ou fica abaixo de maxCurrentRank é deixado de fora (um anúncio cujo histórico de posições não mostra ganho, pela contagem da própria biblioteca de anúncios), pagination cobre os anúncios mantidos e meta.rankNote diz o que foi lido e deixado de fora, também entre marcas.
• Um /time-series diário (e o graph da visão geral) é nulo em um dia cujos anúncios no ar a fonte de dados leu errado (abaixo de um décimo dos dias dos dois lados; o dia mais recente fica como foi lido, também nas evoluções de texto), assim como os lançamentos desse dia, e também os lançamentos do dia seguinte quando são quase todos os anúncios no ar dele; semanas e meses deixam esses lançamentos de fora, e leftOut lista os dias. /landing-page-evolution deixa esses dias de fora de todas as páginas, e também a leitura própria de uma página abaixo de um décimo das leituras dos dois lados, como diz o meta.periodNote dela, com o dia até onde o histórico chega quando ele está atrasado.
• Um lote de /testing sem alcance contado tem nullReasons stats.reach no_eu_reach, a menos que um dos anúncios dele ainda não tenha sido contado (not_measured) ou que todos tenham sido exibidos fora da UE e do Reino Unido (eu_uk_only); o alcance e o investimento ausentes de uma linha de /partners são not_measured só nos 7 dias após o launchDate dela, e no_eu_reach depois.
• /creatives chama de carousel um anúncio com várias imagens ou vídeos (antes era unknown).
• Em GET /v1/lookup, o signals.monthlyVisits de uma loja é nulo para um site ainda não medido (nullReasons not_measured; antes era 0), os anúncios no ar da linha da loja exata (com qualquer type, inclusive shop) são os da página principal dela, conforme a visão geral de anúncios os lê, o mainPageActiveAds dela, e as linhas das próprias páginas da loja leem os delas da mesma forma; o signals.monthlyVisits de uma marca monitorada (e o totalTraffic dela em GET /v1/brandtrackers) é nulo para um site ainda não medido e diz por que está ausente (not_measured, ou no_shop para uma página sem loja), e no Free o alcance de uma página que nenhum plano tem mantém o motivo (eu_uk_only, not_measured), também nas listas de anunciantes.
• Um reach.value nulo de um anúncio do Google tem nullReasons (not_reported, eu_only), exceto quando é um alcance que o plano deixa de fora.
• Em GET /v1/shops/{shopId}, advertising.mainPageActiveAds são os anúncios no ar da página principal, conforme a visão geral de anúncios dela os lê, a contagem que a página principal em linkedAdvertisers mostra (antes era a contagem do índice de lojas, que pode ser um dia mais antiga).

Também alterado em 20 de outubro de 2026 (TikTok e e-mails):

• O metrics.engagementRate de uma linha do TikTok é (curtidas + comentários + compartilhamentos + salvamentos) / visualizações como fração (0.0513 é 5,13%; as buscas enviavam uma porcentagem, e GET /v1/tiktok/library/{itemId}, outra métrica), e daysRunning são os dias desde a publicação do post, nos dois casos.
• metrics.rank é a posição do post entre os posts do criador (1 é a melhor).
• profile.followers é nulo quando a fonte de dados não os contou (ela enviava 0), content.category é nulo para a categoria genérica All dela, e content.hashtags são as tags do post, uma vez cada, escritas como na descrição e sem a pontuação depois delas (as de um registro são a lista da fonte de dados; as de uma linha de busca, as da descrição).
• Um registro do TikTok acrescenta profile.adsCount, organicCount e avgPostsPerWeek90d, preenche profile.pageCreation e tem links nulos para uma linha da fonte de dados sem nenhum TikTok por trás (um id com menos de 15 dígitos, ou publicado antes de 31 de agosto de 2016, às 22:00 UTC).
• sortBy=longestRunning começa nos primeiros TikToks (31 de agosto de 2016, às 22:00 UTC).
• Um registro de e-mail cita o tipo de promoção, a categoria e o evento, e as visitas mensais, os anúncios no ar, os produtos e os números de 90 dias da loja dele são os que as listas de e-mails mostram, assim como os números last90Days das estatísticas de e-mails.
• Uma linha de e-mail deixa de fora extra.shopActiveAds quando ele é 0 sem total de anúncios (os nullReasons dela dizem not_measured), e o shop.marketing.activeAds de um registro de e-mail fica então nulo; quando os números da loja não puderam ser lidos, o registro tem meta.partial, um aviso e nullReasons failed para eles.
• Na ferramenta MCP analyze_shop_emails, dominant classifica tipos de campanha, categorias, tipos de promoção e eventos, cada um separadamente, e deixa de fora No Promotion e No Event.

Alterado em 21 de outubro de 2026:

• O metrics.views de um item do TikTok, e os likes e saves dele que mostram 0 ao lado, são nulos com nullReasons not_measured (assim como engagementRate) quando a fonte de dados enviou 0 visualizações junto com curtidas, comentários, compartilhamentos ou salvamentos acima de 0, nas buscas e em GET /v1/tiktok/library/{itemId}; sortBy=views ou likes com order=asc lista os posts com as visualizações contadas (minViews 1).
• Uma busca de anúncios da Meta com websiteIds lista os próprios anúncios das lojas: todos os anúncios da página principal de uma loja e das páginas oficiais dela com nome parecido, e os anúncios das outras páginas dela (criadores, publishers e parceiros que veicularam os anúncios dela) que levam à loja ou a um site no domínio dela; até a lista ser lida até o fim, o pagination.total da busca são então os anúncios das próprias páginas da loja pesquisadas, uma estimativa (pagination.totalEstimated verdadeiro), ou nulo quando a busca não cita nenhuma das próprias páginas dela.
• Com sortBy=longestRunning, cada lote de anúncios lido da fonte de dados é colocado em ordem de daysRunning.
• Em GET /v1/shops/{shopId}, advertising.activeAds conta os anúncios no ar das próprias páginas da loja (linkedAdvertisers[].isOwnPage), e no /products dela um mais vendido classificado tem o título, o preço e a imagem de catalog.bestSellers (o preço de um mais vendido pode ser o menor entre os das variantes dele).
• O traffic.monthlyVisits de uma loja (e o growth30d) é nulo com not_measured quando mostra 0 porque o histórico dela caiu para 0 ao lado de uma estimativa de vendas acima de 0 e de unidades vendidas, nos registros, nas lojas listadas e semelhantes e na consulta; um domínio assim continua sendo extra.storeWide.
• Em GET /v1/ads/{adId}, advertiser.totalReach é a última leitura de pageAnalytics.reachHistory enquanto essa leitura tem no máximo 2 dias (extra.pageRecordReach traz então o total do registro), extra.advertiserTotalAds é preenchido a partir dos números listados da página (not_measured na falta deles), os ganhos de alcance de 7 e de 30 dias de um anúncio iniciado dentro da janela são todo o alcance dele, e um ganho menor que o de um período com menos dias é nulo (not_measured).
• O statistics.ctaCount de uma marca monitorada nomeia cada chamada para ação como content.callToAction faz («Shop now»).

Também alterado em 21 de outubro de 2026 (lojas):

• Em GET /v1/shops/{shopId}, advertising.history são os anúncios no ar da página principal por dia em todos os planos (no Free, contava os de todas as páginas), e a documentação diz que o alcance e o investimento de advertising.summary, extra.adsLaunched30d, extra.totalAds e extra.estimatedSpendUsd cobrem todas as páginas da loja, enquanto advertising.activeAds conta as próprias páginas dela.
• Um catalog.productsCount igual a 0 de uma loja sem nenhum produto listado, ao lado de visitas, de uma estimativa de vendas ou de unidades vendidas, é nulo com not_measured, nos registros, nas lojas listadas e no meta.productsCount de GET /v1/shops/{shopId}/products; sortBy=productsCount deixa essas lojas de fora e, com order=asc, envia minProductsCount 1, a menos que seja dado um mínimo de produtos.
• Uma busca de anúncios da Meta de uma loja restrita a páginas que não são dela (trackedPages) e que termina antes diz o motivo em meta.warnings, sem pedir para restringi-la.
• GET /v1/filters/shops informa em meta.warnings quando a fonte de dados não lista nenhum valor, e cita as listas que os fornecem.

Também alterado em 21 de outubro de 2026 (paginação, e-mails e listas de anúncios):

• Paginar uma busca de anunciantes não falha mais quando a fonte de dados não a continua (antes respondia 503, e tentar de novo não ajudava): os 100 primeiros resultados são lidos em uma chamada, e a página que chega ao fim do que pode ser lido responde hasMore falso, com meta.partial verdadeiro e um aviso que diz até onde a busca lê.
• Uma página que começa depois do total exato de uma busca fica vazia, com hasMore falso.
• Uma busca do TikTok ordenada por views ou likes com order=asc começa nos primeiros TikToks (31 de agosto de 2016, às 22:00 UTC), como longestRunning, e o metrics.views de um item do TikTok (e o engagementRate) é nulo com not_measured quando mostra menos visualizações que curtidas.
• O content.bodyPreview e o bodyLength de um e-mail, e o content.body de um registro, são nulos com not_measured quando a fonte de dados enviou o marcador dela para um corpo que ainda não leu.
• As datas e horas que a fonte de dados dá em UTC são escritas de um único jeito, tanto nas listas quanto nos registros, com +00:00 e sem zeros à direita na fração de segundo (2026-09-30T00:20:11.507+00:00; os horários em que os seus próprios quadros, favoritos, monitores de marcas e links de compartilhamento foram criados ou alterados terminam em Z, como antes), e as linhas de e-mail trazem os ids da categoria, do tipo de promoção e do evento, como o registro do e-mail.
• Toda lista paginada responde pagination.hasMore, e GET /v1/google-ads/facets/countries responde um objeto pagination.
• Um corpo de requisição que não é um JSON válido responde 400 validation_failed com a mensagem «The request body is not valid JSON.» e details.position, o caractere em que ele se interrompe.
• Nas listas de anúncios da Meta, o alcance de uma linha é a leitura do índice de anúncios, que pode estar um dia atrás do registro do anúncio, e os ganhos de alcance dela são nulos ao lado de um alcance conhecido quando a fonte de dados não lista nenhum (not_measured), exceto em uma janela em que o anúncio começou, na qual ele ganhou todo o alcance que a linha mostra; em GET /v1/ads/{adId}, um ganho nulo ao lado de um alcance conhecido também tem not_measured.

Alterado em 22 de outubro de 2026 (o plano Free):

• A API e o servidor MCP passaram para os planos pagos: uma chave de uma conta no plano Free respondia 403 plan_not_eligible em todos os endpoints, exceto GET /v1/account, com details.upgradeUrl, e nada era contabilizado. Não era possível criar uma chave no Free.
• O plano Free mudou desde então: O plano Free diz o que ele inclui agora.
• Uma chave criada em um plano pago é mantida e volta a funcionar assim que a conta volta para um plano pago. Os links de compartilhamento criados por uma conta no Free são pausados da mesma forma.

Também alterado em 22 de outubro de 2026 (relatórios e registros de lojas):

• Em GET /v1/shops/{shopId}/ad-ranking/series, rankDelta é a posição final menos a inicial (negativo quando o anúncio subiu, como em todos os anúncios; antes eram as posições ganhas) e improvementPercent agora é improvementPct, uma fração; cada linha de /ad-ranking traz os mesmos dois números na janela do ranking em rank.
• No /activity/calendar de uma marca monitorada, em um dia do calendário e em /activity/calendar/days, meta.partial é verdadeiro ou falso, meta.partialSources cita as fontes lidas em parte (em /calendar e em um dia), e os horários das prévias estão em UTC, inclusive os de um post do TikTok.
• Em GET /v1/shops/{shopId}/landing-pages/detail, activeAds recorre aos anúncios da página, shareOfAds é linkedAdsTotal sobre shopActiveAds, snapshots conta os dias em que a página foi capturada, lifetimeAds e impressions deixaram de existir (as impressões eram o alcance de novo), um alcance igual a 0 é nulo com nullReasons.reach no_eu_reach, e linkedAds têm os campos das linhas de uma busca de anúncios.
• O /feed de uma loja lista os próprios anúncios da Meta dela, como as buscas de anúncios dela.
• GET /v1/market/q4-overview aceita quaisquer from e to dentro da temporada.
• Em /q4-season, winners lista a chave de cada liquidação com os criativos dela, e as URLs das páginas de destino trazem o esquema.
• Os detectores da Shopify leem uma loja no domínio dela sem www..
• GET /v1/advertisers/{advertiserId} e as páginas de destino, o público e o mix de mídia de uma marca monitorada repetem um dia passado em meta.snapshotDate.
• Quando as estatísticas de anúncios da Meta de uma loja não podem ser lidas naquele momento, GET /v1/shops/{shopId} responde meta.partial verdadeiro com um aviso: o alcance, as estimativas de investimento feitas a partir dele e o mix de mídia e de formatos ficam nulos com nullReasons failed, os anúncios por país são contados como a linha de busca dela os dá, e a resposta não é guardada, então a próxima chamada os lê de novo (o briefing de concorrente traz o mesmo meta.partial e os mesmos avisos).
• Uma página de destino no próprio domínio da loja, ou em um subdomínio dele, é toShop verdadeiro em /v1/shops/{shopId}/advertisers e /advertisers/{advertiserId}/landing-pages; quando os domínios da loja deixam esse domínio de fora, meta.domains o lista primeiro a partir das páginas de destino das páginas dela (fromLandingPages verdadeiro, um limite inferior), e o shopAds de uma página nunca é menor que os anúncios no ar das páginas de destino dela na loja (shopAdsAtLeast verdadeiro quando é elevado).
• Em GET /v1/tiktok/library/{itemId}, profile.latestPosts[].mediaUrl é o vídeo do post, ou nulo com nullReasons not_reported (antes era a imagem de capa).
• Uma busca de anunciantes lê os 100 primeiros resultados e informa que termina na página que chega ao 100º (hasMore falso e o aviso), não na página vazia depois dela.
• Uma busca do TikTok ordenada por views ou likes com order=asc agora deixa de fora os posts cujas visualizações não são contadas (menos visualizações que curtidas), e o pagination.total dela é uma estimativa (totalEstimated) até a lista ser lida até o fim; todas as outras ordens os listam, com as visualizações nulas.

Também alterado em 22 de outubro de 2026 (itens salvos e ganchos de anúncios):

• Novo: GET /v1/boards/search encontra o que você salvou, em todos os quadros e nos seus favoritos, pelas palavras do que cada cópia salva mostra (todas as palavras precisam aparecer, em qualquer ordem; maiúsculas, minúsculas e acentos são ignorados), pelo id ou pelo nome do quadro, e aceita sourceType, boardId, savedFrom e savedTo; ele lê só os seus itens salvos, nunca a fonte de dados (MCP find_saved_items).
• Novo: POST /v1/tools/ad-hooks escreve três frases curtas de abertura para um anúncio do seu produto, e GET /v1/tools/ad-hooks informa a sua cota: sem limite mensal nos planos pagos e com um limite por minuto (429 com Retry-After); ler a cota não é contabilizado (MCP write_ad_hooks).
• O servidor MCP tem 64 ferramentas.

Também alterado em 23 de outubro de 2026 (visualizações salvas e filtros de lojas):

• Novo: GET /v1/views lista as buscas que você salvou nas páginas de lista do site, cada uma com a busca que ela faz (request: a busca, searchType, sortBy, order e os filtros nomeados, como os endpoints de busca os aceitam); POST /v1/views salva uma, PATCH /v1/views/{viewId} renomeia, move ou altera uma e DELETE /v1/views/{viewId} remove uma. Eles leem e gravam só as suas próprias visualizações, nunca a fonte de dados (MCP list_saved_views).
• As buscas de lojas aceitam excludeCurrencies (códigos de moeda como EUR), socialNetworks (instagram ou tiktok: uma loja com qualquer um deles) e shopifyPlan (headless). trafficGrowth também lê 90 dias (min90, max90), e adsGrowth, 7 dias (min7, max7), ou o period de uma regra (last90d, last7d); min e max continuam sendo os últimos 30 dias.
• O servidor MCP tem 65 ferramentas.

Também alterado em 23 de outubro de 2026 (links de produtos):

• Em GET /v1/shops/{shopId}, cada item de catalog.bestSellers traz handle e productUrl, a página do produto no próprio site da loja: o endereço que a fonte de dados dá quando ele está no domínio da loja (ou em um subdomínio dele) ou no domínio myshopify dela, senão https://<domain>/products/<handle> quando o handle é conhecido, senão nulo.
• Em GET /v1/shops/{shopId}/products, productUrl segue a mesma regra, então um endereço em outro site não é mais informado, e handle é nulo quando não é uma parte única de um endereço.

Também alterado em 23 de outubro de 2026 (linhas de lojas, lojas semelhantes e produtos):

• O createdAt de uma loja (o registro da loja, as linhas de lojas e as lojas semelhantes) é só a data de criação de uma loja Shopify. Para um site fora da Shopify, a fonte de dados dá o dia em que começou a monitorar o site, não a criação dele: createdAt agora é nulo (nullReasons tracking_date) e esse dia é o novo trackedSince. Uma data em 1º de janeiro de 2000 ou antes é o marcador da fonte de dados e é nula (not_reported).
• Os catalog.bestSellers das linhas de lojas trazem handle, productUrl (com a regra do registro da loja) e rank (1 é o mais vendido), e as linhas trazem profile.isHeadless e catalog.myShopifyDomain, como o registro da loja.
• O googleAds.reach.value de uma linha de loja é nulo: as linhas de lojas não trazem alcance do Google, que fica no registro da loja (extra.googleAds.reach).
• As lojas semelhantes (GET /v1/shops/{shopId}/similar, o similarShops do registro) mantêm o extra delas (logo, Trustpilot, histórico de vendas). Uma lista de semelhantes que a fonte de dados interrompe antes do fim responde meta.partial e um aviso na página que chega a esse ponto.
• Em GET /v1/shops/{shopId}/products, createdAt e publishedAt eram o relógio da própria loja enviado como UTC (8 horas mais cedo para uma loja no horário do Pacífico dos EUA). Agora estão em UTC, com o novo updatedAt, a partir da diferença da loja em relação ao UTC (meta.shopUtcOffset, como -08:00). Quando nenhuma diferença pode ser lida, os três são nulos (local_time) e createdAtLocal, publishedAtLocal e updatedAtLocal dão o relógio da loja, sem fuso horário.
• Um produto listado só entre os mais vendidos dos detalhes da loja tem publishedAt e updatedAt nulos (not_reported): os da fonte de dados eram cópias do horário de criação dele.
• Cada produto diz em quais listas está (lists: bestSellers, newest) e a posição dele entre os mais vendidos (listPosition, de 1 a 100).

Também alterado em 23 de outubro de 2026 (registros de lojas):

• Em GET /v1/shops/{shopId}, extra.googleAds.reach.value era sempre nulo: agora é o alcance do Google na UE da loja, com lowerBound e upperBound, e extra.googleAds acrescenta reachHistory, history (os anúncios do Google dela marcados como ativos por semana), updatedAt e latestAds.
• O growth30d de uma rede social agora é a variação de 30 dias da visão geral de seguidores (para algumas páginas do Facebook, era outra janela: 0.3636 quando a variação era 0.2898). GET /v1/shops/{shopId}/socials também o dá como growth30d.
• O perfil da loja no X é socials.x. socials.twitter foi renomeado para socials.x e continua, como o mesmo objeto, por mais uma versão. Cada rede tem url, e socials.others lista os outros links da loja.
• tiktok.profileMetrics.percentAds é uma porcentagem (de 0 a 100); o novo adsShare é o mesmo valor como fração. tiktok acrescenta avatarUrl, history, postsChange30d, postsChange30dPct e latestAds, e tiktok.activity.avgActiveAds7d e avgActiveAds30d, antes nulos, fazem a média diária dos anúncios do TikTok dela.
• Novo nos planos pagos: advertising.summary.firstAdSeenAt, longestRunningDays, medianRunningDays, landingPagesCount e as variações de 30 dias dos anúncios no ar, dos anúncios lançados e do alcance na UE (activeAdsChange30d, launchedChange30d, reachChange30d, cada uma também como fração, …Pct), e advertising.runningDaysMix, reachCountries, reachHistory, topLandingPages, adsByAgeRange e adsByGender. Em todos os planos: advertising.allPagesHistory e advertising.topCountries[].ads.
• Novo: catalog.bestSellers[].rank, sales.hasSubscription, technology.apps[].appStoreUrl e categories, profile.isHeadless, extra.updatedAt, e o createdAt e o trackedSince das datas de loja descritas acima.
• GET /v1/shops/{shopId}/advertisers acrescenta o logoUrl e o moreLandingPages de cada página, um profileUrl quando a visão geral de anúncios não tem nenhum, e o landingPagesCount e o moreLandingPages de cada domínio.

Também alterado em 23 de outubro de 2026 (produtos):

• Novo: GET /v1/products e POST /v1/products/query pesquisam e navegam pelos produtos das lojas, cada um com preço, estimativas de vendas, unidades vendidas, avaliações, posição entre os mais vendidos, anúncios da Meta, alcance e investimento na UE, países de venda, data de lançamento e loja, ordenados por relevance, newest (a data de lançamento), activeAds ou spend (investimento em anúncios na UE nos últimos 30 dias) (MCP search_products). searchType compara o texto com o nome do produto ou com o domínio da loja dele, e os filtros nomeados limitam o preço em USD, os anúncios ativos, a participação dos anúncios, o número de avaliações e o dia de lançamento, e aceitam moedas e assinatura; GET /v1/filters/products lista as moedas que eles aceitam.
• shop (o domínio ou o id de uma loja) lista só os produtos dessa loja, sem texto de busca ao lado, na busca de produtos e em search_products. Os quadros salvam produtos (sourceType product) como uma busca os mostrou pela última vez, e a busca em tudo o que foi salvo os encontra pelo título e pela loja.
• O servidor MCP tem 73 ferramentas.

Também alterado em 23 de outubro de 2026 (filtros de produtos):

• A busca de produtos aceita mais filtros nomeados: a estimativa de vendas de um mês ou de um dia (minEstMonthlySales, minEstDailySales e os máximos correspondentes; o limite de um dia equivale a 30 dias dele), unidades vendidas por mês ou por dia (minUnitsSoldMonthly, minUnitsSoldDaily), sellingCountries (um produto que vende para qualquer um deles), shopCountries, a nota das avaliações (minRating, maxRating), minAdsLaunched (anúncios da Meta lançados nos últimos 30 dias), minSpendShare, minEuReach (o alcance na UE em 30 dias), hasPartnershipAds, promoTypes (percent-off) e minShopProductsCount, cada um com o máximo correspondente quando existe; GET /v1/filters/products também lista os países das lojas.
• sortBy aceita estSales (a estimativa de vendas), adPressure (a participação dos anúncios) e bestSelling (a posição entre os mais vendidos da loja, posição 1 primeiro), e searchType aceita productDescription e url.
• Cada produto tem os anúncios mais recentes (advertising.latestAds, com as imagens em advertising.previewUrls) e as semanas dele (weeks: anúncios no ar, participação dos anúncios, investimento e alcance na UE por dia), e bestSeller.rankPercent é a posição dele como porcentagem dos produtos da loja (quanto menor, melhor).

Alterado em 24 de outubro de 2026 (parâmetros, leituras com falha e páginas profundas):

• Um parâmetro de consulta que uma rota não lê é recusado com 400 validation_failed, cuja mensagem o cita e lista os parâmetros que a rota aceita, quando antes era descartado sem aviso (um nome digitado errado, ou um filtro enviado a uma rota que não tem nenhum, respondia como se nunca tivesse sido enviado). As buscas recusam um filtro nomeado desconhecido, como antes. Um parâmetro simples (country, mediaType, active, type) que define, com outro valor, um filtro que um filtro nomeado também define é recusado também.
• Monitores de marcas: /ads e /timeline/metadata recusam um snapshotDate passado (eles leem a biblioteca de anúncios como ela está agora), /partnership-ads recusa um sortBy desconhecido, /v1/workspace/scaling-ads, um period desconhecido, e as listas de monitores, um hasNewAdsSince de mais de 30 dias atrás (os contadores de anúncios novos cobrem 30 dias). /v1/workspace/hooks, /ad-copies e /landing-pages leem as linhas de cada marca no sortBy e na order pedidos antes de juntá-las. Os relatórios entre marcas do site enviam euOnly só para os relatórios que o leem.
• As lojas semelhantes recusam displayInTrending em filters (a lista não tem a marcação do índice de lojas) e leem os limites de crescimento como porcentagens, como uma busca de lojas; um offset além do que uma requisição consegue ler (600 lojas além das já lidas) é recusado com um 400 que diz até onde é possível ir, e uma página em que a leitura parou tem meta.partial com um aviso. A biblioteca do TikTok de uma loja recusa filtros de perfil e de site (o próprio escopo da loja ocupa o lugar deles).
• Uma parte de uma resposta que a fonte de dados não conseguiu ler desta vez define meta.partial com um aviso (e a resposta não vai para o cache), nunca uma lacuna silenciosa ou uma lista vazia; uma resposta da fonte de dados que não é JSON é um 503 upstream_error, e uma loja salva, um novo monitor ou uma lista de opções de e-mail cuja leitura falha responde o erro, nunca not_found. Uma página mais profunda do que uma leitura alcança, em uma lista que deixa linhas de fora, tem meta.partial e hasMore verdadeiros, e os textos de anúncios, os parceiros e os testes de criativos de uma marca informam com meta.partial quando uma leitura não cobre a marca.
• GET /v1/google-ads/facets/networks aceita search, limit e offset, como as outras listas de opções. O metric de /v1/shops/compare é obrigatório (a referência dizia opcional).
• MCP: uma ferramenta recusa um argumento que o tipo escolhido não lê (shop_report, lookup_filter_ids, market_overview, scan_advertiser) e argumentos que se contradizem (trend_signal com sort_by, active_only com status, um argumento nomeado com filters); creative_inspiration_pack classifica juntos os anúncios de todas as palavras-chave.

Também alterado em 24 de outubro de 2026 (busca por imagem):

• Novo: POST /v1/products/image-search encontra os produtos das lojas que se parecem com uma imagem, cada um com a loja, os mais próximos primeiro. Envie a imagem como multipart/form-data: um arquivo PNG, JPG ou WEBP de no máximo 10 MB (image), ou uma URL direta da imagem (imageUrl), que nós mesmos baixamos. Cada linha é uma linha de produto como a busca de produtos a retorna, com similarity (de 0.7 a 1) e matchOnly (uma correspondência da qual o índice de produtos não tem registro: só o título, a imagem, o preço, a data de lançamento e a loja).
• A busca aceita os filtros nomeados da busca de produtos, sortBy (relevance, estSales, activeAds, adPressure, newest, spend, spend14d) e maxPerShop (as 1, 3, 5, 10 ou 20 correspondências mais próximas de cada loja), em páginas de até 32. GET /v1/products/image-search/{searchId} lê as outras páginas, ordenações, filtros e resultados por loja sem enviar a imagem de novo, e GET /v1/products/image-search/history lista as suas próprias buscas por imagem recentes.
• A imagem é regravada antes da busca, como um JPEG sem os metadados (EXIF, localização, comentários), e uma URL de imagem nunca sai dos nossos servidores. Novos erros: 400 invalid_image, 400 unsupported_url e 422 unreadable_image.
• No plano Free, a busca por imagem é ordenada por relevância, sem filtros. O servidor MCP tem 67 ferramentas: search_products_by_image é nova.

Alterado em 25 de outubro de 2026 (créditos):

• A API e o servidor MCP são medidos em créditos, e não em requisições: 1 crédito = 1 resultado retornado: os detalhes de uma marca, um anúncio ou uma linha de uma lista. Um resultado vazio é gratuito. Uma chamada custa os resultados que retorna, e a cota mensal dos planos é em créditos.
• As respostas medidas enviam X-Usage-Cost, X-Credits-Used, X-Credits-Remaining e X-Credits-Source; GET /v1/usage informa os créditos de recarga em credits.topup.balance.
• 402 insufficient_credits aparece quando os créditos do mês e os créditos de recarga se esgotam, com details.upgradeUrl e details.topUpUrl.
• O limite de requisições é compartilhado por todo o espaço de trabalho.

Os links de compartilhamento (shareUrl) abrem uma página web em https://sellwinners.com que qualquer pessoa pode ver. O mesmo registro está disponível em JSON em /v1/shared/ads/{token} e /v1/shared/boards/{token}. Um link cujo dono está no plano Free responde 403 forbidden até o dono voltar para um plano pago.

Os endpoints de identidade /v1/me, /v1/usage e /v1/workspace retornam os objetos no nível superior, ao lado de requestId. Os endpoints de sistema /v1, /v1/health e /v1/system/freshness não trazem requestId, e /v1 e /v1/health respondem um objeto simples sem data. O id da requisição também é enviado no cabeçalho X-Request-Id. Informe-o quando entrar em contato com o suporte.

Quadros, favoritos e monitores de marcas também têm endpoints POST, PATCH e DELETE. Eles aceitam um corpo JSON, enviado com Content-Type: application/json.

Paginação

Os endpoints de lista aceitam limit (até 100 nas buscas; as listagens de facetas aceitam até 500, e o /snapshots de uma marca, até 365) e page (1, 2, 3…) ou offset. Quando os dois são enviados, offset é usado. O tamanho de página padrão aparece em cada endpoint. As listagens de anúncios, anúncios do Google, TikTok, e-mails e mídia respondem com:

"pagination": { "page": 2, "limit": 25, "total": 1840, "totalPages": 74, "hasMore": true }

As listagens de lojas, produtos e anunciantes, e os anúncios de um anunciante, respondem com:

"pagination": { "limit": 32, "offset": 32, "total": 5120, "hasMore": true }

Para obter a próxima página, repita a mesma requisição com page mais um, ou com offset mais limit. No corpo de um POST …/query, envie "page" ou "offset" como campos. hasMore é false na última página. Quando a fonte de dados não continua uma busca além de certo ponto, a página que chega a ele responde hasMore falso com meta.partial verdadeiro e um aviso que diz quantos resultados podem ser lidos. A paginação alcança os primeiros 5.000 resultados de uma busca (em uma busca de anunciantes, os primeiros 100). Restrinja a busca com filtros ou mude a ordenação para ver outros resultados.

As listagens de anúncios do Google retornam um total exato, exceto uma lista restringida pela regra de status ou de dias no ar (veja a busca de anúncios do Google). Um "totalEstimated": true marca um total (e o totalPages dele) que é uma estimativa até a lista ser lida até o fim, como nas lojas semelhantes de uma loja e em uma busca de anúncios da Meta de uma loja (websiteIds).

Os quadros, os favoritos e os relatórios do monitor de marcas aceitam page e limit e respondem com page, limit, total, totalPages e hasMore. As listas de facetas, o /products de uma loja e as lojas /similar dela aceitam limit e offset e respondem com limit, offset, total e hasMore.

Ordenação & filtros

Os endpoints de busca aceitam sortBy e order (desc por padrão). Quando você envia um termo de busca, os resultados são ordenados por relevance, a menos que você escolha outra ordenação; sem termo de busca, o padrão é newest (lojas e produtos: relevance; mídia: reach). As buscas de anúncios do Google e do TikTok são sempre classificadas por relevância; nelas, sortBy se aplica quando você navega sem termo de busca.

Cada conjunto de dados tem um endpoint POST …/query que aceita um corpo JSON com query, filters, sortBy, order, limit e page (ou offset) para filtragem avançada. Use os endpoints de facetas para ver os valores e os ids que os filtros aceitam.

Os filtros podem ser enviados pelo nome: como parâmetros de consulta extras em uma busca GET (?status=active&minDaysRunning=30&mainCountries=US,GB) ou como campos de nível superior no corpo de um POST …/query ({"status": "active", "minDaysRunning": 30}). Cada endpoint abaixo lista os nomes que aceita. Nos endpoints de busca, um nome de filtro que o endpoint não suporta retorna um 400 validation_failed que lista os suportados, para que um erro de digitação nunca retorne silenciosamente resultados sem filtro; os relatórios do monitor de marcas ignoram os nomes que não conhecem. As listas aceitam valores separados por vírgula ou um array JSON, as datas usam 2026-01-31, e o objeto bruto filters continua funcionando junto com os filtros nomeados.

Os filtros de crescimento (trafficGrowth, adsGrowth, pageReachGrowth, adReachGrowth) aceitam regras escritas como {"comparison": "greater" | "lower", "value": 50} ou {"operator": "gte" | "lte", "value": 50}. Os valores são porcentagens dos últimos 30 dias; outros períodos não estão disponíveis. minRankDelta é o número mínimo de posições que um anúncio ganhou em rankDeltaWindow (7d, a menos que você envie 14d ou 30d). hideSavedAds deixa de fora os anúncios que você já salvou. Os ids de categoria de todos os filtros categoryIds vêm de /v1/facets/categories.

Limites de requisições & créditos

1 crédito = 1 resultado retornado: os detalhes de uma marca, um anúncio ou uma linha de uma lista. Um resultado vazio é gratuito. Cada plano inclui créditos para o mês, renovados às 00:00 UTC do dia 1º. Uma chamada custa os resultados que retorna, então um limit menor custa menos, e uma chamada de ferramenta MCP custa os resultados que retorna, como na API. Os créditos e o limite de requisições são por espaço de trabalho: todos os membros, todas as chaves, a API e o servidor MCP compartilham um único saldo de créditos e um único limite de requisições. Em um plano pago, o proprietário do espaço de trabalho pode comprar créditos de recarga na página de cobrança (€1 compra 120 créditos, a partir de €10): eles são usados depois dos créditos do mês, passam para os meses seguintes e nunca expiram.

Toda resposta medida inclui:

X-RateLimit-Limit       requests allowed per minute
X-RateLimit-Remaining   requests left this minute
X-Usage-Cost            credits this request cost
X-Credits-Used          credits this request cost (the same number)
X-Credits-Remaining     credits left after this request (monthly and top-up)
X-Credits-Source        recurring, topup or hybrid (when it cost credits)
X-Quota-Limit           credits included this month
X-Quota-Remaining       monthly credits left
X-Quota-Reset           when the monthly credits renew (UTC)
X-Request-Id            the id of this request

Acima do limite de requisições por minuto, você recebe 429 rate_limited com um cabeçalho Retry-After (em segundos). Quando os créditos do mês e os créditos de recarga se esgotam, você recebe 402 insufficient_credits, com details.upgradeUrl e details.topUpUrl, até os créditos mensais serem renovados. Confira seus créditos a qualquer momento com GET /v1/account ou GET /v1/usage. Essas chamadas não custam nada, ainda enviam X-Usage-Cost: 0, X-Credits-Used: 0 e X-Credits-Remaining, e funcionam mesmo quando os créditos se esgotaram.

Esses limites se aplicam à API e ao servidor MCP, nos planos pagos e no Free. O app web no site não é medido: nos planos pagos, ele é ilimitado dentro do uso justo.

O plano Free

O plano Free inclui o app web e o servidor MCP (150 créditos por mês), sem a API. Uma conta Free cria no painel uma chave para o servidor MCP (agentes de IA), dentro de 150 créditos por mês e 10 requisições por minuto; a API REST está nos planos pagos: com uma chave Free, ela responde 403 plan_not_eligible, com details.feature, details.requiredPlan e details.upgradeUrl, em todos os endpoints, exceto GET /v1/account, e nada é contabilizado. Uma chave criada em um plano pago fica pausada no Free e volta a funcionar assim que a conta volta para um plano pago. No Free, uma busca retorna os primeiros resultados, e uma ferramenta ou um endpoint cujos dados o Free não inclui responde com a mensagem dos planos pagos. A comparação de planos mostra o que o Free inclui. As marcas de demonstração ficam abertas por completo no site.

Erros

Os erros usam códigos de status HTTP padrão e um corpo JSON:

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "requestId": "req_8f2c1a9b4d7e6f3a2b1c0d9e",
    "details": null
  }
}

code é estável e seguro para usar em condições no seu código, message é escrito para pessoas, e details traz dados extras quando existem (os campos rejeitados de um 400; os créditos mensais, a data de renovação, upgradeUrl e topUpUrl de um 402).

URLs de mídia

As imagens e os vídeos das respostas são servidos pela nossa CDN em https://api.sellwinners.com/v1/media/file/…. Essas URLs não precisam de chave de API e não consomem créditos, então você pode incorporá-las diretamente em tags <img> e <video>. Um arquivo que a fonte de dados não tem mais é enviado como null por um dia, e um arquivo ausente responde um 404 vazio do tipo de mídia dele. As imagens de produtos e os ícones de apps hospedados na CDN da Shopify também são servidos pela nossa CDN. Para mostrar uma imagem pequena, adicione ?w=96 (miniaturas) ou ?w=480 (cards): uma imagem JPEG, PNG, WebP ou GIF é então enviada como WebP com no máximo essa largura, nunca ampliada; uma animação, uma imagem menor ou um vídeo vêm como estão. Para uma lista simples de criativos, pronta para exibição, use /v1/media.

Para mostrar uma imagem no tamanho original, mas mais leve, adicione ?w=full: uma imagem JPEG, PNG, WebP ou GIF é então enviada como WebP com a largura e a altura originais, com uma qualidade visualmente igual, quando isso economiza pelo menos um décimo do arquivo; caso contrário, e para uma animação ou um vídeo, o original vem como está. Sem w, o arquivo original é enviado.

Descoberta

Transforme um nome, um domínio ou um ID de página nos IDs que os outros endpoints usam.

curl "https://api.sellwinners.com/v1/lookup?q=allbirds.com&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/lookup/facebook-shop?shopId=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

Lojas

Encontre lojas Shopify e obtenha produtos, tráfego, vendas, redes sociais e anúncios.

curl "https://api.sellwinners.com/v1/shops?search=shoes&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/shops/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "mainMarketCountries": ["US"], "minMonthlyVisits": 50000, "page": 1, "search": "shoes", "sortBy": "monthlyVisits"}'

curl "https://api.sellwinners.com/v1/shops/allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/products?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/similar?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/advertisers" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/socials/history?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/sales/history?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/socials" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/tiktok" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/apps" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/pixels" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/stores" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/media-mix" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/emails?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/compare?shopIds=allbirds.com%2Con.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tools/shopify-apps?url=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tools/shopify-theme?url=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/feed" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/q4-season" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/q4-season/landing-pages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/q4-season/creatives" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/ad-texts?kind=hook&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/landing-pages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/landing-pages/detail?url=https%3A//www.allbirds.com/" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/advertisers/ADVERTISER_ID/landing-pages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/ad-ranking?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/shops/allbirds.com/ad-ranking/query" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/ad-ranking/series" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/creative-testing?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/creative-testing/2026-10-19" \
  -H "X-API-Key: YOUR_API_KEY"

Mercado

Os totais diários do mercado inteiro e a temporada do Q4.

curl "https://api.sellwinners.com/v1/market/overview" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/market/q4-overview" \
  -H "X-API-Key: YOUR_API_KEY"

Anúncios da Meta

Criativos de anúncios do Facebook e do Instagram com mídia, alcance e posição.

curl "https://api.sellwinners.com/v1/ads?search=skincare&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "mainCountries": ["US"], "mediaType": "video", "minDaysRunning": 14, "page": 1, "query": "skincare", "sortBy": "reach", "status": "active"}'

curl "https://api.sellwinners.com/v1/ads/AD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/AD_ID/reach-history?limit=30" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/AD_ID/media-url" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/facets/landing-pages?scopeDomain=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/facets/ad-copies?scopeDomain=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/facets/partners?scopeDomain=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/ads/AD_ID/share" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/ads/AD_ID/share" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shared/ads/TOKEN" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/tools/ad-hooks" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"angle": "pain", "language": "en", "niche": "skincare", "platform": "both", "product": "Vitamin C serum"}'

curl "https://api.sellwinners.com/v1/tools/ad-hooks" \
  -H "X-API-Key: YOUR_API_KEY"

Google Ads

Criativos de anúncios do Google.

curl "https://api.sellwinners.com/v1/google-ads?search=running%20shoes&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/google-ads/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "page": 1, "query": "running shoes", "status": "active"}'

curl "https://api.sellwinners.com/v1/google-ads/AD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

TikTok

Anúncios e posts orgânicos do TikTok.

curl "https://api.sellwinners.com/v1/tiktok/library?search=fitness&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/tiktok/library/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "minViews": 100000, "page": 1, "query": "fitness", "type": "ad"}'

curl "https://api.sellwinners.com/v1/tiktok/library/ITEM_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/tiktok/library?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Mídia

Criativos prontos para exibir: URLs de imagens e vídeos na nossa CDN.

curl "https://api.sellwinners.com/v1/media?search=sneakers&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/media/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "mediaType": "video", "page": 1, "query": "skincare", "status": "active"}'

curl "https://api.sellwinners.com/v1/media/file/FILE_KEY" \
  -H "X-API-Key: YOUR_API_KEY"

Anunciantes

Anunciantes (páginas do Facebook) e a atividade deles.

curl "https://api.sellwinners.com/v1/advertisers?search=nike&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/advertisers/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "minActiveAds": 10, "offset": 0, "query": "nike"}'

curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/history?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

E-mails

E-mails de marketing e newsletters das marcas.

curl "https://api.sellwinners.com/v1/emails?search=black%20friday&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/emails/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"campaignTypes": ["Marketing"], "limit": 10, "page": 1, "query": "black friday", "sentAfter": "2025-11-01"}'

curl "https://api.sellwinners.com/v1/emails/EMAIL_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/emails/EMAIL_ID/html" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/emails/stats?month=2026-09" \
  -H "X-API-Key: YOUR_API_KEY"

Produtos

Produtos das lojas com preço, vendas, avaliações, anúncios e alcance na UE.

curl "https://api.sellwinners.com/v1/products?search=serum&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/products/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "minActiveAds": 10, "minPriceUsd": 20, "offset": 0, "query": "serum", "sortBy": "activeAds"}'

curl "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/lookup?url=https%3A//example.com/products/blue-mug" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID/ads" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shared/products/TOKEN" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/facets" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/shops/image-search" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]"

curl -X POST "https://api.sellwinners.com/v1/products/image-search" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "maxPerShop=3"

curl "https://api.sellwinners.com/v1/products/image-search/history?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/image-search/SEARCH_ID?sortBy=activeAds&page=2" \
  -H "X-API-Key: YOUR_API_KEY"

Facetas

Os valores e IDs que os filtros de busca aceitam.

curl "https://api.sellwinners.com/v1/facets/categories?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/shopify-apps?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/technologies?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/pixels?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/themes?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/email-classifications" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/networks" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/countries?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/formats" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/statuses" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/categories?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/categories?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/languages?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/countries?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/content-types?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/media-types?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/emails/facets/promotionTypes?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/shops" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/advertisers" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/products" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/ads" \
  -H "X-API-Key: YOUR_API_KEY"

Quadros

Salve anúncios, lojas, produtos, e-mails e anunciantes em quadros e compartilhe-os.

curl "https://api.sellwinners.com/v1/boards?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind": "collection", "name": "Skincare winners", "surface": "ads", "visibility": "workspace"}'

curl "https://api.sellwinners.com/v1/boards/BOARD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/boards/BOARD_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"description": "Ads worth a second look.", "name": "Skincare winners 2026"}'

curl -X DELETE "https://api.sellwinners.com/v1/boards/BOARD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/restore" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/boards/BOARD_ID/parent" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"parentBoardId": "BOARD_ID"}'

curl "https://api.sellwinners.com/v1/boards/BOARD_ID/items?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/boards/search?q=serum&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/items" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"sourceId": "AD_ID", "sourceType": "meta_ad"}'

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/items/ITEM_ID/move" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"targetBoardId": "BOARD_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/boards/BOARD_ID/items/ITEM_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/boards/BOARD_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shared/boards/TOKEN" \
  -H "X-API-Key: YOUR_API_KEY"

Favoritos

Anúncios, lojas e e-mails favoritos, em pastas.

curl "https://api.sellwinners.com/v1/favorites/ads?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/ads" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"adId": "AD_ID", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/saved/FAVORITE_ID/folder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folderId": "FOLDER_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/saved/FAVORITE_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/RECORD_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/favorites/ads/folders?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/ads/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Winners", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/folders/reorder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folders": [{"id": "FOLDER_ID", "order": 0}]}'

curl -X POST "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID/visibility?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"visibility": "private"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Top performers"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode": "move_items_to_root"}'

curl "https://api.sellwinners.com/v1/favorites/shops?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/shops" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"scope": "workspace", "websiteId": "SHOP_ID"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/saved/FAVORITE_ID/folder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folderId": "FOLDER_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/saved/FAVORITE_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/RECORD_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/favorites/shops/folders?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/shops/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Winners", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/folders/reorder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folders": [{"id": "FOLDER_ID", "order": 0}]}'

curl -X POST "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID/visibility?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"visibility": "private"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Top performers"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode": "move_items_to_root"}'

curl "https://api.sellwinners.com/v1/favorites/emails?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/emails" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"emailId": 123456, "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/saved/FAVORITE_ID/folder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folderId": "FOLDER_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/saved/FAVORITE_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/RECORD_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/favorites/emails/folders?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/emails/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Winners", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/folders/reorder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folders": [{"id": "FOLDER_ID", "order": 0}]}'

curl -X POST "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID/visibility?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"visibility": "private"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Top performers"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode": "move_items_to_root"}'

Visualizações salvas

As buscas que você salvou nas páginas de lista do site, por página.

curl "https://api.sellwinners.com/v1/views" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/views" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"context": "shops", "name": "Big US shops", "state": "f.marketCountries=US\u0026f.minMonthlyVisits=100000\u0026sortBy=monthlyVisits"}'

curl -X PATCH "https://api.sellwinners.com/v1/views/VIEW_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Big US shops 2026", "position": 0}'

curl -X DELETE "https://api.sellwinners.com/v1/views/VIEW_ID" \
  -H "X-API-Key: YOUR_API_KEY"

Monitores de marcas

Acompanhe marcas e leia relatórios sobre os anúncios, os criativos e as páginas de destino delas.

curl "https://api.sellwinners.com/v1/brandtrackers?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/brandtrackers" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"domain": "allbirds.com"}'

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/overview" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/snapshots?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/timeline?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/timeline/metadata" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/partnership-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/partnership-ads/count" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/top-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ad-rank?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/scaling-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/creatives?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/testing?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/hooks?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/transcripts?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/headlines?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ad-copies?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/landing-pages?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/landing-pages/simple?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ad-copy-evolution?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/headline-evolution?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/landing-page-evolution?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/partners?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/media-mix" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/demography" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity/events?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity/calendar" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity/calendar/days" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/time-series" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/top-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/scaling-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/hooks?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/ad-copies?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/landing-pages?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/media-mix?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/folders" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/folders" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/brandtrackers/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Competitors"}'

curl -X PATCH "https://api.sellwinners.com/v1/brandtrackers/folders/FOLDER_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Direct competitors"}'

curl -X DELETE "https://api.sellwinners.com/v1/brandtrackers/folders/FOLDER_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"action": "move-to-default", "confirm": true}'