Documentación de la API de datos de e-commerce

La API de SellWinners te da inteligencia de e-commerce y publicidad por HTTPS con respuestas en JSON: tiendas Shopify con sus productos y su tráfico; productos de tiendas con su precio, sus estimaciones de ventas, sus reseñas y sus anuncios; anuncios de Meta, Google y TikTok; anunciantes; y los emails que envían las marcas. Todos los endpoints también están disponibles para agentes de IA a través de nuestro servidor MCP alojado. Esta página cubre la autenticación, el formato de respuesta, la paginación, la ordenación y los filtros, los límites de peticiones y los créditos, los errores y las URL de medios, y después cada endpoint con sus parámetros y una petición de ejemplo, y las herramientas del servidor MCP.

Inicio rápido

1. Crea una cuenta, confirma tu email y elige un plan de pago: la API y el servidor MCP empiezan ahí.
2. Abre Claves de API y crea una clave. Cópiala enseguida: solo se muestra una vez.
3. Haz tu primera petición:

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);

Autenticación

Envía tu clave de API en cada petición en la cabecera X-API-Key, o como token bearer:

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

Las claves empiezan por ak_live_. Mantenlas en secreto: no las pongas en código front-end ni en repositorios públicos. Puedes crear varias claves (una por app o entorno) y revocar cualquiera desde tu panel; una clave revocada deja de funcionar de inmediato.

Respuestas

Todas las respuestas son JSON. Llevan un requestId y el resultado en data: una lista para las búsquedas y los listados, un objeto para un único registro. Las listas añaden un objeto pagination, y algunas respuestas añaden 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 }
}

Los registros son objetos anidados: un anuncio tiene media, advertiser, content, metrics, audience, rank y flags, y las tiendas, los anunciantes, los anuncios de Google, los elementos de TikTok y los emails se agrupan del mismo modo. Un valor desconocido es null. Los demás campos sin un lugar fijo se guardan en extra. El ejemplo de arriba está abreviado.

En un anuncio, content.title es el titular y content.callToAction es un texto legible como «Shop now». metrics.estimatedSpend es la estimación de inversión de la fuente cuando la hay (un anuncio individual de /v1/ads/{adId} la lee); si no, alcance x 9 / 1000 (9 USD por cada 1.000 personas alcanzadas); una estimación de inversión conserva dos decimales por debajo de 10 USD y va en dólares enteros a partir de 10 USD. rank.rankDelta es la posición actual menos la anterior, así que un valor negativo significa que el anuncio ha subido, y rank.improvementPct es una fracción (0,25 es un cuarto).

Los informes de posición del seguimiento de marcas (/ad-rank, /scaling-ads, /v1/workspace/scaling-ads y la herramienta MCP get_brandtracker_scaling_ads) añaden sus propias metrics: ahí metrics.rankDelta es la posición anterior menos la actual (positivo: puestos ganados) y metrics.improvementPct es la fracción de la posición anterior ganada, como en un anuncio (0,875 es el 87,5%). En un anuncio individual, metrics.reachDelta1d, reachDelta7d y reachDelta30d se rellenan a partir de su historial de alcance. Las tiendas nombran sus categorías: catalog.mainCategory en los listados, y además catalog.categories en una tienda individual.

En un anuncio de Google, media.type y media.format son text, image o video, y media.url es la imagen del anuncio: en un anuncio de vídeo, su miniatura (no hay archivo de vídeo). transparencyUrl es el anuncio en el Centro de transparencia de anuncios de Google, donde se reproduce un anuncio de vídeo; es null cuando el anuncio no tiene ids de Google. network es search, youtube, shopping, maps u other, y lo mismo los valores de extra.networks.

Cambios del 19 de octubre de 2026:

• El media.format de un anuncio de Google era un código de formato y ahora es text, image o video, su media.type puede ser text o video, y extra.networks usa los nombres en minúsculas de network.
• Un media.url de Google nunca es un archivo de vídeo, aunque media.type sea video.
• En el filtro formats de Google, image ahora significa anuncios de imagen (antes significaba anuncios de texto), así que usa text para los anuncios de texto. Los códigos anteriores static_image, html5_iframe y responsive_display, y sus nombres cortos, se siguen aceptando.

El status de un anuncio de Google es active solo mientras Google muestra el anuncio: uno que Google no ha mostrado en más de 7 días es unknown. daysRunning cuenta los días desde firstSeenAt hasta lastSeenAt, ambos incluidos; extra.servedDays es el recuento propio de la fuente de datos, que sigue contando después de que un anuncio se detiene. Los filtros coinciden con lo que muestra cada anuncio: status=active conserva los anuncios que Google mostró en los últimos 7 días y status=inactive, los que la fuente de datos marca como detenidos, así que un anuncio unknown no está en ninguno de los dos; minDaysRunning y maxDaysRunning, los anuncios cuyo daysRunning está dentro del rango. Una lista así tiene pagination.total en null y, cuando pocos de los anuncios leídos coinciden, termina antes, con meta.partial y un aviso.

Sin texto de búsqueda, sortBy=relevance muestra los más recientes; sortBy=reach solo admite order=desc. Con status=active, sortBy=reach muestra pocos anuncios: en orden de alcance, los primeros anuncios son sobre todo los que Google dejó de mostrar, así que ordena por los más recientes para ver los anuncios que Google muestra ahora (su aviso lo indica). Los anuncios de Google no admiten sortBy=longestRunning: la fuente de datos lo ordena por días que siguen contando después de que un anuncio se detiene, así que mostraba anuncios que Google ya no muestra, y responde 400 con ese motivo.

extra.startIsFloor marca un anuncio visto por primera vez el 31 de mayo de 2018, el primer día de los datos de anuncios de Google, así que puede ser más antiguo. audience.countries enumera todos los países de la audiencia, con un percentage solo para un anuncio mostrado en uno solo; remarketing e interest son null cuando se desconocen.

Google informa de un alcance solo para algunos de los anuncios mostrados en la UE, a menudo solo como 10.000.000, el máximo de su escala (10 millones o más): la mayoría de los anuncios no tienen ninguno, y nullReasons indica por qué reach.value es null (not_reported: un anuncio mostrado en la UE para el que Google no informa de ninguno; eu_only: un anuncio mostrado en otro lugar), salvo cuando es un alcance que el plan no incluye. extra.networks es la lista de plataformas del anuncio según la fuente de datos, que puede no nombrar network. extra.shop.google contiene los totales de Google del sitio web del anunciante; para un sitio que no es una tienda (una tienda de apps, una red social, un acortador de enlaces), advertiser.domain y websiteId son null.

Cambios del 20 de octubre de 2026:

• Un dominio (GET /v1/shops/{domain}, el lookup, un domain de TikTok, el informe de competidor) es el sitio con exactamente ese dominio, también fuera del índice de tiendas; uno al que la fuente de datos no llega responde 404.
• GET /v1/lookup ordena los resultados del mejor al peor: el propio sitio de un dominio, sus propias páginas de Facebook (la página principal primero) y luego las páginas con un nombre parecido; para un nombre, el propio sitio de la marca y sus propias páginas (la página principal primero), y luego las tiendas y páginas encontradas por el nombre.
• Cuando se encuentra el sitio de la marca, se excluye una tienda o página que solo tiene el nombre dentro de una palabra, y un sitio con ese nombre solo es exacto cuando publica anuncios; en otro caso, una coincidencia de nombre solo es exacta con tráfico o anuncios. Las páginas oficiales con otro nombre y sin ningún anuncio activo van después de las páginas encontradas por nombre.
• El signals.activeAdsSource de una fila de tienda indica de dónde vienen sus activeAds: page (los anuncios activos de su página principal, leídos en el momento, en la propia fila de la tienda) o index (el recuento del índice de tiendas, que puede ser más antiguo).
• Una búsqueda de tiendas por dominio (searchType=domain) muestra primero el sitio exacto, con extra.exactDomainMatch (y extra.inShopIndex en false cuando el índice de tiendas no lo incluye).
• Para un sitio que no es una tienda (una tienda de apps, una red social o de mensajería, un acortador de enlaces o una redirección de seguimiento), el extra.domain de una fila de anunciante es null, el registro de un anunciante lo nombra en extra.nonShopSite, omite extra.platforms y toma linkedShops de sus páginas de destino (fromLandingPages), y un anuncio no tiene shops.
• Las fechas y horas que la fuente de datos envía sin zona horaria están en UTC y ahora se envían con +00:00.
• En las estadísticas de emails, emailsByDayOfWeek usa como clave el número del día: 0 es domingo y 6, sábado.
• Las filas del lookup pueden llevar nullReasons, y el registro de una tienda, meta.partial cuando no se han podido leer sus cifras del listado.

Otros cambios del 20 de octubre de 2026 (TikTok):

• El publishedAt de un elemento de TikTok está en UTC. Iba 1 o 2 horas retrasado, así que una publicación hecha en las últimas horas de un día UTC aparecía al día siguiente y con un daysRunning de un día menos.
• Los filtros coinciden con él: publishedAfter y publishedBefore están en UTC (una fecha sola es el inicio de su día, y publishedBefore muestra las publicaciones anteriores a ella), minDaysRunning y maxDaysRunning cuentan desde el día UTC, como hace daysRunning, y sortBy=longestRunning empieza el 31 de agosto de 2016 a las 22:00 UTC.

Otros cambios del 20 de octubre de 2026 (anuncios de Google):

• GET /v1/google-ads, POST /v1/google-ads/query y la herramienta MCP no admiten sortBy=longestRunning (ni daysRunning) y responden 400 con el motivo: la fuente de datos lo ordena por días que siguen contando después de que un anuncio se detiene, así que mostraba anuncios que Google ya no muestra.
• Una búsqueda en Free cuyos primeros resultados quedan cortos con status=active responde meta.partial con un aviso que indica cuántos de los anuncios leídos muestra.
• En extra.shop, un sitio sin datos de tráfico no tiene monthlyVisits (antes era 0), un trafficGrowth30d solo aparece junto a visitas por encima de 0, y extra.shop.google omite un totalReach o un weeklyReach de 0 (nunca informados) y, cuando no cuenta ningún anuncio, los recuentos a 0.
• Un anuncio de Google guardado en un tablero se lee igual.

Otros cambios del 20 de octubre de 2026 (tiendas):

• En GET /v1/shops/{shopId}, advertising.summary.reach30d es el alcance en la UE de los últimos 30 días, sumado por fecha (antes era el total desde el inicio del seguimiento, ahora totalReach), spend30d es ese alcance x 9 / 1000, extra.estimatedSpendUsd es la inversión desde el inicio del seguimiento y extra.adsLaunched30d suma los anuncios lanzados en los últimos 30 días; todos son null para una tienda sin alcance en la UE ni en el Reino Unido.
• Los registros de tiendas, las tiendas de los listados y las estadísticas de emails llevan nullReasons, que asocia la ruta de un campo con el motivo por el que es null: not_shopify (las ventas y los productos solo se estiman para tiendas Shopify), no_estimate, not_measured, eu_uk_only, not_linked (sin perfil de TikTok), not_on_tp, no_reviews, none_found.
• Una estimación de ventas de cero junto a unidades vendidas es null, en los registros, los listados y el historial de ventas, cuyo period=week tiene un punto por semana.
• traffic.growth30d es una fracción (-0,1543 es -15,4%), y traffic.history empieza en el primer mes con visitas.
• catalog.mainCategory procede de los ids de categoría (la más específica de la rama principal), con catalog.categoryLeaves y productsCountCapped (25.001 es el techo de la fuente de datos: 25.000 o más).
• Una página de Trustpilot sin reseñas tiene una valoración null.
• tiktok.matchedBy es socials o handle cuando las cifras de TikTok proceden de los perfiles sociales de la tienda o de un perfil encontrado por su nombre de usuario (una coincidencia, no un vínculo de la fuente de datos).
• advertising.mainPageActiveAds son los anuncios activos de la página principal (la lectura de su resumen de anuncios, tal como la muestra su página principal en linkedAdvertisers; el recuento de los listados de tiendas solo cuando no la hay) y linkedAdvertisers[].rank, la posición de la página.
• Las tiendas similares excluyen la propia tienda y sus propios sitios, y cada página se completa con tiendas de más abajo en la lista (offset y limit cuentan la lista sin ellos).
• Los productos ordenados por popularidad ponen primero los más vendidos de la tienda (meta.order).
• Los emails de una tienda y sus estadísticas de emails cuentan todos los tipos de campaña, y sus cifras de 90 días son null cuando se desconocen.
• Una ordenación por ventas muestra una fila por tienda Shopify (extra.sharedSalesWith), y sortBy=estMonthlySales&order=asc excluye las tiendas sin estimación.

Otros cambios del 20 de octubre de 2026 (cifras de tiendas):

• Una ordenación por ventas de GET /v1/shops sigue leyendo más allá de los dominios que fusiona en una fila por tienda Shopify (antes se detenía tras las primeras filas), fusiona también los dominios de una tienda que aparecen más abajo en la lista, y su pagination.total es null hasta que la lista se lee hasta el final; sortBy=estMonthlySales&order=asc empieza en una estimación de 100 USD (minMonthlySales 100).
• Una estimación de ventas inferior a 0,50 USD por unidad vendida es null (no_estimate), en los registros, los listados y el historial de ventas.
• traffic.monthlyVisits es null para un sitio aún no medido, y traffic.growth30d, cuando el mes anterior no tuvo visitas (not_measured); el growth30d de una red social procede de su historial de seguidores cuando la fuente de datos da 0 o nada, y 0 seguidores es null (not_measured).
• Las tiendas de los listados indican por qué catalog.productsCount y sales.unitsSold son null.
• extra.storeWide marca un dominio con 0 visitas que lleva las ventas de su tienda (un 0 medido, u otro dominio de la tienda, nombrado en extra.sharedSalesWith, tiene las visitas; Free omite el nombre en el registro de una tienda).
• advertising.mainPageActiveAds son los anuncios activos de la página principal tal como los lee su resumen de anuncios (el recuento de los listados de tiendas solo cuando no lo hay).
• Las tiendas similares también excluyen las tiendas de la marca de la tienda, y extra.similarIndexed es false para una tienda que no está en el índice de similitud.
• catalog.mainCategory conserva la etiqueta propia de la fuente de datos solo cuando es el nombre de una categoría.
• Un archivo multimedia enlazado en una respuesta que la fuente de datos ya no tiene responde 200 con un cuerpo vacío y X-Media-Missing: true.

Otros cambios del 20 de octubre de 2026 (anunciantes y anuncios de Meta):

• El alcance de un anunciante es el alcance en la UE y el Reino Unido, con las mismas ventanas que la búsqueda de anunciantes: advertising.reach30d, extra.reach14d, reach90d y totalReach son null para una página sin anuncios ni alcance en la UE o el Reino Unido, o para una ventana que la fuente de datos no ha contado, y nullReasons indica por qué (eu_uk_only, not_measured); una página creada dentro de una ventana tiene todo su alcance en ella (antes eran 0).
• En GET /v1/advertisers/{advertiserId}, el alcance es el que muestran los listados de anunciantes (antes se leía 30 lecturas atrás, y las lecturas se saltan días), las estimaciones de inversión son null cuando él lo es, extra.avgSpendUsd14d es la inversión diaria media de 14 días, extra.avgActiveAds14d es la media de 14 días de sus anuncios activos (antes eran sus anuncios nuevos de 14 días); cuando la fuente de datos no la ha calculado, para una página creada dentro de esos 14 días se calcula a partir de sus anuncios activos leídos desde su primer día (extra.averagedFrom), y si no, es null; y los recuentos de anuncios nuevos de una página creada dentro de la ventana cuentan todos sus anuncios.
• advertising.countryDistribution es la proporción de sus anuncios activos dirigidos a cada país (un anuncio se dirige a varios), extra.reachCountries contiene la proporción de cada país en el alcance en la UE, extra.platforms.meta contiene los anuncios propios de la página (antes contenía los de la página principal de la tienda), se omite un recuento de TikTok o Google sin cifra, extra.mainLandingPages recurre a la vista previa de las páginas de destino de una página nueva, y los lastAds de una página cuyos anuncios la búsqueda de anuncios aún no ha incorporado son los últimos que muestra su fila de anunciante, con meta.indexing, como en GET /v1/advertisers/{advertiser_id}/ads (con meta.liveAds).
• Nuevo: GET /v1/advertisers/{advertiserId}/history, los anuncios activos de la página y el alcance en la UE que ganó, día a día.
• Un recuento de seguidores de Instagram de 0 es null (la fuente de datos escribe 0 para una página sin ninguna cuenta que conozca).
• El metrics.reach de un anuncio de Meta y su inversión son null para un anuncio no mostrado en la UE ni en el Reino Unido (eu_uk_only; antes eran 0 o null) y para un anuncio de la UE cuyo alcance aún no se ha contado (not_measured; antes era 0), y las filas de medios indican por qué en nullReasons.reach; media.type es carousel para un anuncio de más de una imagen o vídeo, y extra.startIsFloor marca un anuncio iniciado el 1 de enero de 2018, el primer día de las fechas de anuncios de Meta de la fuente de datos.
• sortBy=adRank muestra primero la mejor posición (1), sea cual sea el orden.
• Un anuncio individual (GET /v1/ads/{adId}) toma el último alcance del que informa la fuente de datos y su inversión, cuenta sus variaciones de alcance por fecha mientras su historial de alcance esté al día (si no, son null), enumera sus imágenes y vídeos como lo hace su fila de búsqueda, rellena advertiser.reach30d y pageAnalytics.instagramFollowersHistory, añade pageAnalytics.reachHistory (la misma serie que impressionsHistory) y nombra una tienda que el registro solo da por su id (con su traffic en null y nullReasons shops.traffic cuando el sitio no está medido); sus audience.gender, ageMin, ageMax y metrics.aggregatedReach siempre son null, ya que la fuente de datos no los informa para un solo anuncio.
• En una búsqueda de anunciantes, sortBy=reach ordena por el alcance total desde el inicio del seguimiento, y newAds, por los anuncios nuevos de 14 días.
• La segmentación de un anuncio de Meta indica por qué su alcance es null: eu_uk_only solo para un anuncio que no se dirige a ningún país de la UE ni al Reino Unido; uno que sí se dirige a alguno, o cuya segmentación aún no se conoce, es not_measured en sus 7 primeros días y not_reported después (antes eran eu_uk_only), en los listados de anuncios, las filas de medios y el anuncio individual.
• Un anuncio individual lee sus historiales de alcance y de inversión como una sola serie, con una lectura al día (también sus variaciones), y toma la última lectura de esa serie y su inversión cuando el alcance del registro es más del doble y la serie llega hasta el último día del anuncio; su media recurre a su primer archivo listado, y advertiser.totalReach, al alcance en la UE de los detalles de la página.
• El registro de un anunciante cuya fila no lee ningún alcance junto a unos detalles de página que sí lo leen toma el alcance de estos (extra.totalReach, su inversión y advertising.reach30d calculado sobre él), sus proporciones de extra.reachCountries nunca se redondean a 0, extra.averagedFrom nunca es anterior al día en que se creó la página, y su historial diario (extra.history, GET /v1/advertisers/{advertiserId}/history) omite las lecturas que la fuente de datos no hizo (una racha de ceros de 14 días o menos entre lecturas por encima de 0).
• Un anuncio individual que toma la lectura de su serie conserva el alcance del registro en extra.recordReach (la cifra que muestran los listados de anuncios); en una búsqueda de anunciantes, una fila que no lee ningún alcance en la UE junto a unos detalles de página que sí lo leen toma el alcance de estos, como hace su registro; y GET /v1/advertisers/{advertiserId}/history conserva las lecturas de 0 de una página que ahora no tiene ningún anuncio en la UE y que ganó alcance antes de los días pedidos (no ganó ninguno; antes se omitían como not_measured).
• En Free, un anuncio cuyo alcance se desconoce indica el motivo igual que en los planes de pago; solo un alcance que el plan no incluye no tiene motivo.

Otros cambios del 20 de octubre de 2026 (estimaciones de inversión):

• Una inversión estimada inferior a 10 USD conserva dos decimales: un alcance de 140 a 9 USD por cada 1.000 personas alcanzadas da 1,26 (antes era 1), y una media diaria conserva sus propios centavos; a partir de 10 USD, una estimación de inversión va en dólares enteros (un alcance de 2.000 da 18).
• Esto se aplica al extra.estimatedSpendUsd y al extra.avgSpendUsd14d del registro de un anunciante, al advertising.summary.spend30d y al extra.estimatedSpendUsd de una tienda, al metrics.estimatedSpend de un anuncio de Meta, y al statistics.euData.estimatedSpend30d de un seguimiento de marca y al estimatedSpend de cada punto de /time-series (ambos tenían dos decimales con cualquier importe), tanto en la API como en las herramientas MCP. Cuando la cifra propia de la fuente de datos es esa estimación en dólares enteros, conserva sus centavos del mismo modo.

Otros cambios del 20 de octubre de 2026 (alcance de anunciantes e historial diario):

• GET /v1/advertisers/{advertiserId} añade extra.reachScope: outside_eu_uk para una página cuyo alcance por país se vio mayoritariamente fuera de la UE y el Reino Unido (la fuente de datos también informa del alcance de algunos anuncios mostrados en otros lugares; su alcance y las estimaciones hechas a partir de él son entonces ese alcance, no el alcance en la UE), y si no, eu_uk. Su extra.avgSpendUsd14d para una página creada dentro de los 14 días es su inversión dividida entre los días completos desde que se creó (uno como mínimo; antes era su alcance de 14 días entre 14 días cuando la fila de anunciante tenía uno).
• El extra.history del registro de un anunciante y GET /v1/advertisers/{advertiserId}/history empiezan el día en que se creó la página; extra.history.newAds omite sus 0 de los días que la fuente de datos no leyó, extra.followersHistory y los me gusta y seguidores de pageAnalytics de un anuncio omiten un 0 entre dos lecturas por encima de 0 o de uno de esos días, y las estimaciones de inversión diaria conservan dos decimales por debajo de 10 USD.
• Una página cuyos anuncios activos aún no están en ninguna lista tiene meta.indexing en su registro, y una primera página vacía de GET /v1/advertisers/{advertiser_id}/ads con meta.indexing y meta.liveAds.
• Un anuncio individual (GET /v1/ads/{adId}): extra.spendHistory empieza el día en que empezó el anuncio, cada spendUsd con dos decimales por debajo de 10 USD; advertiser.totalReach nunca es inferior a la última lectura de pageAnalytics.reachHistory (extra.pageRecordReach contiene entonces el total del registro, el que muestran los listados de anunciantes); extra.recordSpend es la inversión de extra.recordReach; extra.reachScope y extra.pageReachScope indican dónde se vio la mayor parte del alcance del anuncio y del de su página.

Otros cambios del 20 de octubre de 2026 (seguimiento de marcas):

• En GET /v1/brandtrackers y GET /v1/brandtrackers/{id}, un 0 en advertising.newAdsLastDay junto a lanzamientos en los últimos 7 días se contrasta con los lanzamientos de ayer de la tienda: su recuento, o null (not_measured) si no hay lectura de ese día; un listado comprueba como máximo 20 marcas por llamada, las de la página pedida.
• En /top-ads y /v1/workspace/top-ads, metrics.totalReach es el alcance en la UE del anuncio: null para un anuncio mostrado fuera de la UE y el Reino Unido (eu_uk_only) o para un anuncio de la UE aún no contado (not_measured), con nullReasons, y el último en una ordenación por alcance (antes era 0).
• /testing calcula sus estadísticas de alcance sobre los anuncios cuyo alcance se conoce, con nullReasons stats.reach para un lote que no tiene ninguno.
• En /hooks, /transcripts, /landing-pages y los ganchos y las páginas de destino del espacio de trabajo, un totalImpressions de 0 es null con el nuevo motivo no_eu_reach (no se ha contado ningún alcance en la UE ni en el Reino Unido para sus anuncios; not_measured con euOnly), y va el último en su ordenación.
• En /ad-rank, /scaling-ads y /v1/workspace/scaling-ads, cuando el historial de posiciones de un anuncio empieza dentro de una ventana de 14 o 30 días, metrics.previousRank y rankDelta cuentan desde su lectura más antigua en ella: metrics.since es ese día y meta.windowNote lo indica, y una cifra que no se puede dar es null con nullReasons.
• En /partners, isOwnPage es true para la página principal de la tienda, sus páginas oficiales con un nombre parecido al de la marca y una página con el mismo nombre que la marca (los creadores también pueden figurar como oficiales), y un alcance o una inversión null tiene nullReasons.
• La primera página de /ads con adCopyHashes tiene meta.latestAdDate y dataFreshnessLagDays, y con status=active, meta.stoppedCount.
• /demography es la audiencia en la UE y el Reino Unido, y un país por debajo de una diezmilésima del primero pasa de countryDistribution a otherCountries.
• /ad-copy-evolution y /headline-evolution tienen un punto por cada día registrado (0 cuando el texto no se usó, null en un día recortado a los textos que conserva), ordenan los textos por el día más reciente y omiten los días que la fuente de datos leyó mal (anuncios activos por debajo de una décima parte de los de los días de alrededor, un día o 2 o 3 seguidos, o muchos menos textos que los días a ambos lados), como indica meta.periodNote; meta.recordedDays cuenta los días. Los anuncios activos semanales y mensuales de /time-series también omiten 2 o 3 de esas lecturas seguidas.

Otros cambios del 20 de octubre de 2026 (informes del seguimiento de marcas, lookup y alcance de Google):

• En /ad-rank, /scaling-ads y /v1/workspace/scaling-ads, todas las posiciones de una fila proceden del historial de posiciones del anuncio: metrics.currentRank es su lectura del día en que se leyó la posición de la biblioteca de anuncios (la posición que muestra /top-ads; la biblioteca puede ir un día por detrás del historial) o, si no, su lectura más reciente; la trajectory termina ese día, y si no hay lectura el día en que empieza la ventana, cuenta la lectura más antigua dentro de ella (ya no se usa la variación propia de la fuente de datos en la ventana).
• Los 50 primeros anuncios de la biblioteca de anuncios (10 por marca cuando son varias marcas) se vuelven a clasificar con estas cifras: se excluye un anuncio que, según ellas, ganó menos de minRankDelta o está por debajo de maxCurrentRank (un anuncio cuyo historial de posiciones no da ninguna ganancia se valora por el recuento propio de la biblioteca de anuncios), pagination cubre los anuncios conservados y meta.rankNote indica qué se leyó y qué se excluyó, también entre varias marcas.
• Un /time-series diario (y el graph del resumen) es null en un día cuyos anuncios activos la fuente de datos leyó mal (por debajo de una décima parte de los de los días a ambos lados; el día más reciente se queda como se leyó, también en las evoluciones de textos), y también sus lanzamientos, igual que los lanzamientos del día siguiente cuando son casi todos sus anuncios activos; las semanas y los meses omiten esos lanzamientos, y leftOut enumera los días. /landing-page-evolution omite esos días en todas las páginas, y la lectura propia de una página por debajo de una décima parte de las lecturas a ambos lados, como indica su meta.periodNote, con el día hasta el que llega el historial cuando va retrasado.
• Un lote de /testing sin ningún alcance contado tiene nullReasons stats.reach no_eu_reach, salvo que uno de sus anuncios aún no esté contado (not_measured) o que todos se mostraran fuera de la UE y el Reino Unido (eu_uk_only); el alcance y la inversión que faltan en una fila de /partners son not_measured solo en los 7 días posteriores a su launchDate, y no_eu_reach después.
• /creatives llama carousel a un anuncio de varias imágenes o vídeos (antes era unknown).
• En GET /v1/lookup, el signals.monthlyVisits de una tienda es null para un sitio aún no medido (nullReasons not_measured; antes era 0), los anuncios activos de la fila de la tienda exacta (con cualquier type, también shop) son los de su página principal tal como los lee su resumen de anuncios, su mainPageActiveAds, y las filas de las propias páginas de la tienda leen los suyos del mismo modo, el signals.monthlyVisits de una marca en seguimiento (y su totalTraffic en GET /v1/brandtrackers) es null para un sitio aún no medido e indica por qué falta (not_measured, o no_shop para una página sin tienda), y en Free el alcance de una página que ningún plan tiene conserva su motivo (eu_uk_only, not_measured), también en los listados de anunciantes.
• Un reach.value null de un anuncio de Google tiene nullReasons (not_reported, eu_only), salvo cuando es un alcance que el plan no incluye.
• En GET /v1/shops/{shopId}, advertising.mainPageActiveAds son los anuncios activos de la página principal tal como los lee su resumen de anuncios, el recuento que muestra su página principal en linkedAdvertisers (antes era el recuento del índice de tiendas, que puede tener un día más de antigüedad).

Otros cambios del 20 de octubre de 2026 (TikTok y emails):

• El metrics.engagementRate de una fila de TikTok es (me gusta + comentarios + compartidos + guardados) / visualizaciones como fracción (0,0513 es 5,13%; las búsquedas enviaban un porcentaje y GET /v1/tiktok/library/{itemId}, otra métrica), y daysRunning son los días transcurridos desde que se publicó el post, en ambos casos.
• metrics.rank es la posición de la publicación entre las publicaciones de su creador (1 es la mejor).
• profile.followers es null cuando la fuente de datos no los ha contado (enviaba 0), content.category es null para su categoría comodín All, y content.hashtags son las etiquetas de la publicación, una vez cada una, escritas como en su descripción y sin la puntuación que las sigue (las de un registro son la lista de la fuente de datos; las de una fila de búsqueda, las de la descripción).
• Un registro de TikTok añade profile.adsCount, organicCount y avgPostsPerWeek90d, rellena profile.pageCreation y tiene links en null para una fila de la fuente de datos sin ningún TikTok detrás (un id de menos de 15 dígitos, o publicado antes del 31 de agosto de 2016 a las 22:00 UTC).
• sortBy=longestRunning empieza en los primeros TikToks (31 de agosto de 2016, 22:00 UTC).
• El registro de un email nombra su tipo de promoción, su categoría y su evento, y las visitas mensuales, los anuncios activos, los productos y las cifras de 90 días de su tienda son los que muestran los listados de emails, igual que las cifras last90Days de las estadísticas de emails.
• Una fila de email omite extra.shopActiveAds cuando es un 0 sin total de anuncios (sus nullReasons indican not_measured), y el shop.marketing.activeAds del registro del email es entonces null; cuando no se han podido leer las cifras de la tienda, el registro tiene meta.partial, un aviso y nullReasons failed para ellas.
• En la herramienta MCP analyze_shop_emails, dominant clasifica los tipos de campaña, las categorías, los tipos de promoción y los eventos cada uno por separado, y omite No Promotion y No Event.

Cambios del 21 de octubre de 2026:

• El metrics.views de un elemento de TikTok, y sus likes y saves que marcan 0 junto a ellas, son null con nullReasons not_measured (igual que engagementRate) cuando la fuente de datos enviaba 0 visualizaciones junto a me gusta, comentarios, compartidos o guardados por encima de 0, en las búsquedas y en GET /v1/tiktok/library/{itemId}; sortBy=views o likes con order=asc muestra las publicaciones con sus visualizaciones contadas (minViews 1).
• Una búsqueda de anuncios de Meta con websiteIds muestra los anuncios propios de las tiendas: todos los anuncios de la página principal de una tienda y de sus páginas oficiales con un nombre parecido, y los anuncios de sus otras páginas (creadores, editores y socios que publicaron sus anuncios) que enlazan a la tienda o a un sitio de su dominio; hasta que la lista se lee hasta el final, el pagination.total de la búsqueda son entonces los anuncios de las propias páginas de la tienda buscadas, una estimación (pagination.totalEstimated true), o null cuando la búsqueda no nombra ninguna de sus propias páginas.
• Con sortBy=longestRunning, cada lote de anuncios leído de la fuente de datos se ordena por daysRunning.
• En GET /v1/shops/{shopId}, advertising.activeAds cuenta los anuncios activos de las propias páginas de la tienda (linkedAdvertisers[].isOwnPage), y en su /products un más vendido clasificado tiene el título, el precio y la imagen de catalog.bestSellers (el precio de un más vendido puede ser el más bajo de sus variantes).
• El traffic.monthlyVisits de una tienda (y su growth30d) es null con not_measured cuando marca 0 porque su historial cayó a 0 junto a una estimación de ventas por encima de 0 y unidades vendidas, en los registros, las tiendas de los listados, las tiendas similares y el lookup; un dominio así sigue siendo extra.storeWide.
• En GET /v1/ads/{adId}, advertiser.totalReach es la última lectura de pageAnalytics.reachHistory mientras esa lectura tenga como máximo 2 días (extra.pageRecordReach contiene entonces el total del registro), extra.advertiserTotalAds se rellena a partir de las cifras listadas de la página (not_measured si no hay ninguna), las ganancias de alcance de 7 y 30 días de un anuncio iniciado dentro de la ventana son todo su alcance, y una ganancia inferior a la de menos días es null (not_measured).
• El statistics.ctaCount de un seguimiento de marca nombra cada llamada a la acción como lo hace content.callToAction («Shop now»).

Otros cambios del 21 de octubre de 2026 (tiendas):

• En GET /v1/shops/{shopId}, advertising.history son los anuncios activos de la página principal por día en todos los planes (en Free contaba los de todas las páginas), y la documentación indica que el alcance y la inversión de advertising.summary, extra.adsLaunched30d, extra.totalAds y extra.estimatedSpendUsd cubren todas las páginas de la tienda, mientras que advertising.activeAds cuenta sus propias páginas.
• Un catalog.productsCount de 0 de una tienda sin ningún producto listado, junto a visitas, una estimación de ventas o unidades vendidas, es null con not_measured, en los registros, las tiendas de los listados y el meta.productsCount de GET /v1/shops/{shopId}/products; sortBy=productsCount excluye esas tiendas y, con order=asc, envía minProductsCount 1 salvo que se indique un mínimo de productos.
• Una búsqueda de anuncios de Meta de una tienda acotada a páginas que no son suyas (trackedPages) que termina antes indica por qué en meta.warnings, sin pedir que se acote.
• GET /v1/filters/shops indica en meta.warnings cuándo la fuente de datos no enumera ningún valor, y nombra las listas que los dan.

Otros cambios del 21 de octubre de 2026 (paginación, emails y listas de anuncios):

• Paginar una búsqueda de anunciantes ya no falla cuando la fuente de datos no la continúa (respondía 503, y reintentar no servía): sus 100 primeros resultados se leen en una sola llamada, y la página que llega al final de lo que se puede leer responde hasMore false, con meta.partial true y un aviso que indica hasta dónde lee la búsqueda.
• Una página que empieza más allá del total exacto de una búsqueda está vacía, con hasMore false.
• Una búsqueda de TikTok ordenada por views o likes con order=asc empieza en los primeros TikToks (31 de agosto de 2016, 22:00 UTC), como hace longestRunning, y el metrics.views de un elemento de TikTok (y su engagementRate) es null con not_measured cuando marca menos visualizaciones que me gusta.
• El content.bodyPreview y el bodyLength de un email, y el content.body de un registro, son null con not_measured cuando la fuente de datos enviaba su marcador de posición para un cuerpo que no ha leído.
• Las fechas y horas que la fuente de datos da en UTC se escriben de una sola forma tanto en las listas como en los registros, con +00:00 y sin ceros finales en la fracción de segundo (2026-09-30T00:20:11.507+00:00; las horas en que se crearon o cambiaron tus propios tableros, favoritos, seguimientos de marcas y enlaces para compartir terminan en Z, como antes), y las filas de emails llevan los ids de su categoría, su tipo de promoción y su evento, como hace el registro del email.
• Todas las listas paginadas responden pagination.hasMore, y GET /v1/google-ads/facets/countries responde un objeto pagination.
• Un cuerpo de petición que no es JSON válido responde 400 validation_failed con el mensaje «The request body is not valid JSON.» y details.position, el carácter en el que se interrumpe.
• En las listas de anuncios de Meta, el alcance de una fila es la lectura del índice de anuncios, que puede ir un día por detrás del registro del anuncio, y sus ganancias de alcance son null junto a un alcance conocido cuando la fuente de datos no enumera ninguna (not_measured), salvo en una ventana en la que empezó el anuncio, donde ganó todo el alcance que marca su fila; en GET /v1/ads/{adId}, una ganancia que es null junto a un alcance conocido también tiene not_measured.

Cambios del 22 de octubre de 2026 (el plan Free):

• La API y el servidor MCP pasaron a los planes de pago: una clave de una cuenta del plan Free respondía 403 plan_not_eligible en todos los endpoints salvo GET /v1/account, con details.upgradeUrl, y no se contaba nada. En Free no se podía crear ninguna clave.
• El plan Free ha cambiado desde entonces: El plan Free explica lo que incluye ahora.
• Una clave creada en un plan de pago se conserva, y vuelve a funcionar en cuanto la cuenta vuelve a un plan de pago. Los enlaces para compartir creados por una cuenta en Free se pausan del mismo modo.

Otros cambios del 22 de octubre de 2026 (informes y registros de tiendas):

• En GET /v1/shops/{shopId}/ad-ranking/series, rankDelta es la posición final menos la posición inicial (negativa cuando el anuncio ha subido, como en todos los anuncios; antes eran los puestos ganados) e improvementPercent ahora es improvementPct, una fracción; cada fila de /ad-ranking lleva las mismas dos cifras sobre la ventana de la clasificación en rank.
• En el /activity/calendar de una marca en seguimiento, un día del calendario y /activity/calendar/days, meta.partial es true o false, meta.partialSources nombra las fuentes leídas en parte (en /calendar y en un día), y las horas de las vistas previas están en UTC, también las de una publicación de TikTok.
• En GET /v1/shops/{shopId}/landing-pages/detail, activeAds recurre a los anuncios de la página, shareOfAds es linkedAdsTotal sobre shopActiveAds, snapshots cuenta los días en que se capturó la página, lifetimeAds e impressions desaparecen (las impresiones volvían a ser el alcance), un alcance de 0 es null con nullReasons.reach no_eu_reach, y los linkedAds tienen los campos de las filas de una búsqueda de anuncios.
• El /feed de una tienda muestra sus propios anuncios de Meta, como hacen sus búsquedas de anuncios.
• GET /v1/market/q4-overview admite cualquier from y to dentro de la temporada.
• En /q4-season, winners enumera la clave de cada campaña de rebajas con sus creatividades, y las URL de las páginas de destino llevan su esquema.
• Los detectores de Shopify leen una tienda en su dominio sin www..
• GET /v1/advertisers/{advertiserId} y las páginas de destino, la audiencia y la combinación de medios de una marca en seguimiento devuelven un día pasado en meta.snapshotDate.
• Cuando las estadísticas de anuncios de Meta de una tienda no se pueden leer en ese momento, GET /v1/shops/{shopId} responde meta.partial true con un aviso: su alcance, las estimaciones de inversión hechas a partir de él y su combinación de medios y formatos son null con nullReasons failed, sus anuncios por país se cuentan como los da su fila de búsqueda, y la respuesta no se guarda, así que la siguiente llamada vuelve a leerlos (el informe de competidor lleva el mismo meta.partial y los mismos avisos).
• Una página de destino en el propio dominio de la tienda, o en un subdominio de él, tiene toShop true en /v1/shops/{shopId}/advertisers y /advertisers/{advertiserId}/landing-pages; cuando los dominios de la tienda no incluyen ese dominio, meta.domains lo muestra primero a partir de las páginas de destino de sus páginas (fromLandingPages true, un límite inferior), y el shopAds de una página nunca es inferior a los anuncios activos de sus páginas de destino en la tienda (shopAdsAtLeast true cuando se ha elevado).
• En GET /v1/tiktok/library/{itemId}, profile.latestPosts[].mediaUrl es el vídeo de la publicación, o null con nullReasons not_reported (antes era la imagen de portada).
• Una búsqueda de anunciantes lee sus 100 primeros resultados e indica que termina en la página que llega al centésimo (hasMore false y el aviso), no en la página vacía que viene después.
• Una búsqueda de TikTok ordenada por views o likes con order=asc ahora excluye las publicaciones cuyas visualizaciones no están contadas (menos visualizaciones que me gusta), y su pagination.total es una estimación (totalEstimated) hasta que la lista se lee hasta el final; cualquier otro orden las muestra, con sus visualizaciones en null.

Otros cambios del 22 de octubre de 2026 (elementos guardados y ganchos de anuncios):

• Nuevo: GET /v1/boards/search encuentra lo que guardaste, en todos los tableros y en tus favoritos, por las palabras de lo que muestra cada copia guardada (deben aparecer todas las palabras, en cualquier orden; se ignoran las mayúsculas y los acentos), por su id o por el nombre de su tablero, y admite sourceType, boardId, savedFrom y savedTo; solo lee tus elementos guardados, nunca la fuente de datos (MCP find_saved_items).
• Nuevo: POST /v1/tools/ad-hooks escribe tres frases de apertura cortas para un anuncio de tu producto, y GET /v1/tools/ad-hooks da tu cupo: sin límite mensual en los planes de pago, y con un límite por minuto (429 con Retry-After); consultar el cupo no se cuenta (MCP write_ad_hooks).
• El servidor MCP tiene 64 herramientas.

Otros cambios del 23 de octubre de 2026 (vistas guardadas y filtros de tiendas):

• Nuevo: GET /v1/views enumera las búsquedas que guardaste en las páginas de listas del sitio web, cada una con la búsqueda que hace (request: la búsqueda, searchType, sortBy, order y los filtros con nombre, tal como los admiten los endpoints de búsqueda); POST /v1/views guarda una, PATCH /v1/views/{viewId} le cambia el nombre, la mueve o la modifica y DELETE /v1/views/{viewId} la elimina. Solo leen y escriben tus propias vistas, nunca la fuente de datos (MCP list_saved_views).
• Las búsquedas de tiendas admiten excludeCurrencies (códigos de moneda como EUR), socialNetworks (instagram o tiktok: una tienda con cualquiera de ellas) y shopifyPlan (headless). trafficGrowth también lee 90 días (min90, max90) y adsGrowth, 7 días (min7, max7), o el period de una regla (last90d, last7d); min y max siguen siendo los últimos 30 días.
• El servidor MCP tiene 65 herramientas.

Otros cambios del 23 de octubre de 2026 (enlaces de productos):

• En GET /v1/shops/{shopId}, cada elemento de catalog.bestSellers lleva handle y productUrl, la página del producto en el propio sitio de la tienda: la dirección que da la fuente de datos cuando está en el dominio de la tienda (o en un subdominio de él) o en su dominio myshopify; si no, https://<domain>/products/<handle> cuando se conoce su handle; y si no, null.
• En GET /v1/shops/{shopId}/products, productUrl sigue la misma regla, así que ya no se da una dirección de otro sitio, y handle es null cuando no es una única parte de una dirección.

Otros cambios del 23 de octubre de 2026 (filas de tiendas, tiendas similares y productos):

• El createdAt de una tienda (el registro de la tienda, las filas de tiendas y las tiendas similares) solo es la fecha de creación de una tienda Shopify. Para un sitio fuera de Shopify, la fuente de datos da el día en que empezó a seguir el sitio, no su creación: createdAt ahora es null (nullReasons tracking_date) y ese día es el nuevo trackedSince. Una fecha igual o anterior al 1 de enero de 2000 es el marcador de posición de la fuente de datos y es null (not_reported).
• Los catalog.bestSellers de las filas de tiendas llevan handle, productUrl (con la regla del registro de la tienda) y rank (1 es el más vendido), y las filas llevan profile.isHeadless y catalog.myShopifyDomain, como hace el registro de la tienda.
• El googleAds.reach.value de una fila de tienda es null: las filas de tiendas no llevan alcance de Google, que está en el registro de la tienda (extra.googleAds.reach).
• Las tiendas similares (GET /v1/shops/{shopId}/similar, el similarShops del registro) conservan su extra (logo, Trustpilot, historial de ventas). Una lista de similares que la fuente de datos detiene antes del final responde meta.partial y un aviso en la página que llega a ese punto.
• En GET /v1/shops/{shopId}/products, createdAt y publishedAt eran la hora local de la tienda enviada como UTC (8 horas antes de la hora real para una tienda con la hora del Pacífico de EE. UU.). Ahora están en UTC, con el nuevo updatedAt, a partir del desfase de la tienda respecto a UTC (meta.shopUtcOffset, como -08:00). Cuando no se puede leer ningún desfase, los tres son null (local_time) y createdAtLocal, publishedAtLocal y updatedAtLocal dan la hora local de la tienda, sin zona horaria.
• Un producto que solo figura entre los más vendidos de los detalles de la tienda tiene publishedAt y updatedAt en null (not_reported): los de la fuente de datos eran copias de su hora de creación.
• Cada producto indica en qué listas está (lists: bestSellers, newest) y su puesto entre los más vendidos (listPosition, de 1 a 100).

Otros cambios del 23 de octubre de 2026 (registros de tiendas):

• En GET /v1/shops/{shopId}, extra.googleAds.reach.value siempre era null: ahora es el alcance en la UE de la tienda en Google, con lowerBound y upperBound, y extra.googleAds añade reachHistory, history (sus anuncios de Google marcados como activos por semana), updatedAt y latestAds.
• El growth30d de una red social es ahora la variación a 30 días del resumen de seguidores (para algunas páginas de Facebook era otra ventana: 0,3636 donde la variación era 0,2898). GET /v1/shops/{shopId}/socials también lo da como growth30d.
• El perfil de X de la tienda es socials.x. socials.twitter pasa a llamarse socials.x y se mantiene, como el mismo objeto, durante una versión. Cada red tiene url, y socials.others enumera los demás enlaces de la tienda.
• tiktok.profileMetrics.percentAds es un porcentaje (de 0 a 100); el nuevo adsShare es lo mismo como fracción. tiktok añade avatarUrl, history, postsChange30d, postsChange30dPct y latestAds, y tiktok.activity.avgActiveAds7d y avgActiveAds30d, antes null, promedian sus anuncios de TikTok por día.
• Nuevo en los planes de pago: advertising.summary.firstAdSeenAt, longestRunningDays, medianRunningDays, landingPagesCount y las variaciones a 30 días de los anuncios activos, los anuncios lanzados y el alcance en la UE (activeAdsChange30d, launchedChange30d, reachChange30d, cada uno también como fracción, con el sufijo Pct), y advertising.runningDaysMix, reachCountries, reachHistory, topLandingPages, adsByAgeRange y adsByGender. En todos los planes: advertising.allPagesHistory y advertising.topCountries[].ads.
• Nuevo: catalog.bestSellers[].rank, sales.hasSubscription, technology.apps[].appStoreUrl y categories, profile.isHeadless, extra.updatedAt, y el createdAt y el trackedSince de las fechas de tienda descritas arriba.
• GET /v1/shops/{shopId}/advertisers añade el logoUrl y el moreLandingPages de cada página, un profileUrl cuando el resumen de anuncios no tiene ninguno, y el landingPagesCount y el moreLandingPages de cada dominio.

Otros cambios del 23 de octubre de 2026 (productos):

• Nuevo: GET /v1/products y POST /v1/products/query buscan y exploran productos de tiendas, cada uno con su precio, sus estimaciones de ventas, sus unidades vendidas, sus reseñas, su posición entre los más vendidos, sus anuncios de Meta, su alcance y su inversión en la UE, sus países de venta, su fecha de lanzamiento y su tienda, ordenados por relevance, newest (la fecha de lanzamiento), activeAds o spend (la inversión publicitaria en la UE de los últimos 30 días) (MCP search_products). searchType compara el texto con el nombre del producto o con el dominio de su tienda, y los filtros con nombre acotan el precio en USD, los anuncios activos, la cuota de anuncios, el número de reseñas y el día de lanzamiento, y admiten monedas y suscripción; GET /v1/filters/products enumera las monedas que admiten.
• shop (el dominio o el id de una tienda) muestra solo los productos de esa tienda, sin texto de búsqueda al lado, en la búsqueda de productos y en search_products. Los tableros guardan productos (sourceType product) tal como los mostró una búsqueda por última vez, y la búsqueda en todo lo guardado los encuentra por su título y su tienda.
• El servidor MCP tiene 73 herramientas.

Otros cambios del 23 de octubre de 2026 (filtros de productos):

• La búsqueda de productos admite más filtros con nombre: la estimación de ventas de un mes o de un día (minEstMonthlySales, minEstDailySales y sus máximos; el límite de un día equivale a 30 días de él), las unidades vendidas al mes o al día (minUnitsSoldMonthly, minUnitsSoldDaily), sellingCountries (un producto que se vende en cualquiera de ellos), shopCountries, la puntuación de las reseñas (minRating, maxRating), minAdsLaunched (anuncios de Meta lanzados en los últimos 30 días), minSpendShare, minEuReach (el alcance en la UE en 30 días), hasPartnershipAds, promoTypes (percent-off) y minShopProductsCount, cada uno con su máximo cuando lo tiene; GET /v1/filters/products también enumera los países de las tiendas.
• sortBy admite estSales (la estimación de ventas), adPressure (la cuota de anuncios) y bestSelling (la posición entre los más vendidos de su tienda, la posición 1 primero), y searchType admite productDescription y url.
• Cada producto tiene sus últimos anuncios (advertising.latestAds, con sus imágenes en advertising.previewUrls) y sus semanas (weeks: anuncios activos, cuota de anuncios, inversión y alcance en la UE por día), y bestSeller.rankPercent es su posición como porcentaje de los productos de la tienda (cuanto más bajo, mejor).

Cambios del 24 de octubre de 2026 (parámetros, lecturas fallidas y páginas profundas):

• Un parámetro de consulta que una ruta no lee se rechaza con 400 validation_failed, cuyo mensaje lo nombra y enumera los parámetros que admite la ruta, cuando antes se descartaba sin avisar (un nombre mal escrito, o un filtro enviado a una ruta que no tiene ninguno, respondía como si nunca se hubiera enviado). Las búsquedas rechazan un filtro con nombre desconocido, como antes. También se rechaza un parámetro simple (country, mediaType, active, type) que fija un filtro que un filtro con nombre también fija, con otro valor.
• Seguimiento de marcas: /ads y /timeline/metadata rechazan un snapshotDate pasado (leen la biblioteca de anuncios tal como está ahora), /partnership-ads, un sortBy desconocido, /v1/workspace/scaling-ads, un period desconocido, y las listas de seguimientos, un hasNewAdsSince de hace más de 30 días (los contadores de anuncios nuevos cubren 30 días). /v1/workspace/hooks, /ad-copies y /landing-pages leen las filas de cada marca en el sortBy y el order pedidos antes de fusionarlas. Los informes de varias marcas del sitio web envían euOnly solo a los informes que lo leen.
• Las tiendas similares rechazan displayInTrending en filters (la lista no tiene el indicador del índice de tiendas) y leen sus límites de crecimiento como porcentajes, igual que una búsqueda de tiendas; un offset más allá de lo que puede leer una petición (600 tiendas a partir de las ya leídas) se rechaza con un 400 que indica hasta dónde se puede llegar, y una página en la que se detuvo la lectura tiene meta.partial con un aviso. La biblioteca de TikTok de una tienda rechaza los filtros de perfil y de sitio (el ámbito propio de la tienda ocupa su lugar).
• Una parte de una respuesta que la fuente de datos no ha podido leer esta vez activa meta.partial con un aviso (y la respuesta no se guarda en caché), nunca un hueco silencioso ni una lista vacía; una respuesta de la fuente de datos que no es JSON es un 503 upstream_error, y una tienda guardada, un seguimiento nuevo o una lista de opciones de emails cuya lectura falla responde con el error, nunca con not_found. Una página más profunda de lo que alcanza una lectura de una lista que omite filas tiene meta.partial y hasMore true, y los textos de anuncios, los socios y las pruebas de creatividades de una marca indican con meta.partial cuándo una lectura no cubre la marca.
• GET /v1/google-ads/facets/networks admite search, limit y offset, como las demás listas de opciones. El metric de /v1/shops/compare es obligatorio (la referencia decía opcional).
• MCP: una herramienta rechaza un argumento que el tipo elegido no lee (shop_report, lookup_filter_ids, market_overview, scan_advertiser) y los argumentos que se contradicen (trend_signal con sort_by, active_only con status, un argumento con nombre con filters); creative_inspiration_pack clasifica juntos los anuncios de todas las palabras clave.

Otros cambios del 24 de octubre de 2026 (búsqueda por imagen):

• Nuevo: POST /v1/products/image-search encuentra los productos de tiendas que se parecen a una imagen, cada uno con su tienda, los más parecidos primero. Envía la imagen como multipart/form-data: un archivo PNG, JPG o WEBP de 10 MB como máximo (image), o una URL directa de imagen (imageUrl), que descargamos nosotros mismos. Cada fila es una fila de producto tal como la devuelve la búsqueda de productos, con similarity (de 0,7 a 1) y matchOnly (una coincidencia de la que el índice de productos no tiene registro: solo su título, su imagen, su precio, su fecha de lanzamiento y su tienda).
• La búsqueda admite los filtros con nombre de la búsqueda de productos, sortBy (relevance, estSales, activeAds, adPressure, newest, spend, spend14d) y maxPerShop (las 1, 3, 5, 10 o 20 coincidencias más cercanas de cada tienda), en páginas de hasta 32. GET /v1/products/image-search/{searchId} lee sus otras páginas, ordenaciones, filtros y resultados por tienda sin volver a enviar la imagen, y GET /v1/products/image-search/history enumera tus propias búsquedas por imagen recientes.
• La imagen se vuelve a escribir antes de buscarla, como un JPEG sin sus metadatos (EXIF, ubicación, comentarios), y una URL de imagen nunca sale de nuestros servidores. Errores nuevos: 400 invalid_image, 400 unsupported_url y 422 unreadable_image.
• En el plan Free, la búsqueda por imagen se ordena por relevancia, sin filtros. El servidor MCP tiene 67 herramientas: search_products_by_image es nueva.

Cambios del 25 de octubre de 2026 (créditos):

• La API y el servidor MCP se miden en créditos en lugar de peticiones: 1 crédito = 1 resultado devuelto: los datos de una marca, un anuncio o una fila de una lista. Un resultado vacío es gratis. Una llamada cuesta los resultados que devuelve, y el cupo mensual de los planes está en créditos.
• Las respuestas medidas envían X-Usage-Cost, X-Credits-Used, X-Credits-Remaining y X-Credits-Source; GET /v1/usage informa de los créditos de recarga en credits.topup.balance.
• 402 insufficient_credits llega cuando se han agotado tanto los créditos del mes como los créditos de recarga, con details.upgradeUrl y details.topUpUrl.
• Todo el espacio de trabajo comparte el límite de peticiones.

Los enlaces para compartir (shareUrl) abren una página web en https://sellwinners.com que cualquiera puede ver. El mismo registro está disponible en JSON en /v1/shared/ads/{token} y /v1/shared/boards/{token}. Un enlace cuyo propietario está en el plan Free responde 403 forbidden hasta que el propietario vuelva a un plan de pago.

Los endpoints de identidad /v1/me, /v1/usage y /v1/workspace devuelven sus objetos en el nivel superior, junto a requestId. Los endpoints del sistema /v1, /v1/health y /v1/system/freshness no llevan requestId, y /v1 y /v1/health responden un objeto simple sin data. El id de la petición también se envía en la cabecera X-Request-Id. Indícalo cuando contactes con el soporte.

Los tableros, los favoritos y el seguimiento de marcas también tienen endpoints POST, PATCH y DELETE. Admiten un cuerpo JSON, enviado con Content-Type: application/json.

Paginación

Los endpoints de listas admiten limit (hasta 100 en las búsquedas; los listados de facetas admiten hasta 500 y los /snapshots de una marca, hasta 365) y page (1, 2, 3…) u offset. Cuando se envían ambos, se usa offset. El tamaño de página predeterminado figura en cada endpoint. Los listados de anuncios, anuncios de Google, TikTok, emails y medios responden con:

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

Los listados de tiendas, productos y anunciantes, y los anuncios de un anunciante, responden con:

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

Para obtener la página siguiente, repite la misma petición con page más uno, o con offset más limit. En el cuerpo de un POST …/query, envía "page" u "offset" como campos. hasMore es false en la última página. Cuando la fuente de datos no continúa una búsqueda más allá de cierto punto, la página que llega a él responde hasMore false con meta.partial true y un aviso que indica cuántos resultados se pueden leer. La paginación llega a los primeros 5.000 resultados de una búsqueda (en una búsqueda de anunciantes, a los primeros 100). Acota la búsqueda con filtros o cambia la ordenación para ver otros resultados.

Los listados de anuncios de Google devuelven un total exacto, salvo una lista que acota la regla de estado o de días activo (consulta la búsqueda de anuncios de Google). Un "totalEstimated": true marca un total (y su totalPages) que es una estimación hasta que la lista se lee hasta el final, como en las tiendas similares de una tienda y en una búsqueda de anuncios de Meta de una tienda (websiteIds).

Los tableros, los favoritos y los informes del seguimiento de marcas admiten page y limit y responden con page, limit, total, totalPages y hasMore. Las listas de facetas, los /products de una tienda y sus tiendas /similar admiten limit y offset y responden con limit, offset, total y hasMore.

Ordenación y filtros

Los endpoints de búsqueda aceptan sortBy y order (desc por defecto). Cuando pasas un término de búsqueda, los resultados se ordenan por relevance salvo que elijas otra ordenación; sin término de búsqueda, el valor predeterminado es newest (tiendas y productos: relevance; medios: reach). Las búsquedas de anuncios de Google y TikTok siempre se ordenan por relevancia; en ellas, sortBy se aplica cuando exploras sin término de búsqueda.

Cada conjunto de datos tiene un endpoint POST …/query que admite un cuerpo JSON con query, filters, sortBy, order, limit y page (u offset) para el filtrado avanzado. Usa los endpoints de facetas para ver los valores y los ids que admiten los filtros.

Los filtros se pueden enviar por su nombre: como parámetros de consulta adicionales en una búsqueda GET (?status=active&minDaysRunning=30&mainCountries=US,GB) o como campos de nivel superior del cuerpo de un POST …/query ({"status": "active", "minDaysRunning": 30}). Cada endpoint de abajo enumera los nombres que admite. En los endpoints de búsqueda, un nombre de filtro que el endpoint no admite devuelve un 400 validation_failed que enumera los admitidos, así que una errata nunca devuelve en silencio resultados sin filtrar; los informes del seguimiento de marcas ignoran los nombres que no conocen. Las listas admiten valores separados por comas o un array JSON, las fechas usan 2026-01-31, y el objeto filters sin procesar sigue funcionando junto a los filtros con nombre.

Los filtros de crecimiento (trafficGrowth, adsGrowth, pageReachGrowth, adReachGrowth) admiten reglas escritas como {"comparison": "greater" | "lower", "value": 50} o {"operator": "gte" | "lte", "value": 50}. Los valores son porcentajes de los últimos 30 días; no hay otros periodos disponibles. minRankDelta es el número mínimo de posiciones que ganó un anuncio en rankDeltaWindow (7d salvo que envíes 14d o 30d). hideSavedAds excluye los anuncios que ya guardaste. Los ids de categoría de cualquier filtro categoryIds proceden de /v1/facets/categories.

Límites de peticiones y créditos

1 crédito = 1 resultado devuelto: los datos de una marca, un anuncio o una fila de una lista. Un resultado vacío es gratis. Cada plan incluye créditos para el mes, que se renuevan a las 00:00 UTC del día 1. Una llamada cuesta los resultados que devuelve, así que un limit más pequeño cuesta menos, y una llamada a una herramienta MCP cuesta los resultados que devuelve, igual que la API. Los créditos y el límite de peticiones son por espacio de trabajo: todos sus miembros, todas sus claves, la API y el servidor MCP comparten una misma bolsa de créditos y un mismo límite de peticiones. En un plan de pago, el propietario del espacio de trabajo puede comprar créditos de recarga en la página de facturación (con €1 compras 120, desde €10): se usan después de los créditos del mes, se acumulan y nunca caducan.

Toda respuesta medida incluye:

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

Por encima del límite de peticiones por minuto recibes 429 rate_limited con una cabecera Retry-After (en segundos). Cuando se han agotado tanto los créditos del mes como los créditos de recarga, recibes 402 insufficient_credits, con details.upgradeUrl y details.topUpUrl, hasta que se renuevan los créditos mensuales. Consulta tus créditos cuando quieras con GET /v1/account o GET /v1/usage. Estas llamadas no cuestan nada, siguen enviando X-Usage-Cost: 0, X-Credits-Used: 0 y X-Credits-Remaining, y funcionan incluso cuando los créditos se han agotado.

Estos límites se aplican a la API y al servidor MCP, en los planes de pago y en Free. La aplicación web del sitio no se mide: en los planes de pago es ilimitada, dentro de un uso razonable.

El plan Free

El plan Free incluye la aplicación web y el servidor MCP (150 créditos al mes), sin la API. Una cuenta Free crea una clave para el servidor MCP (agentes de IA) en su panel, con 150 créditos al mes y 10 peticiones por minuto; la API REST está en los planes de pago: con una clave Free responde 403 plan_not_eligible, con details.feature, details.requiredPlan y details.upgradeUrl, en todos los endpoints salvo GET /v1/account, y no se cuenta nada. Una clave creada en un plan de pago queda en pausa en Free, y vuelve a funcionar en cuanto la cuenta vuelve a un plan de pago. En Free, una búsqueda devuelve sus primeros resultados, y una herramienta o un endpoint cuyos datos Free no incluye responde con el mensaje de los planes de pago. La comparativa de planes muestra lo que incluye Free. Las marcas de demostración están abiertas por completo en el sitio web.

Errores

Los errores usan códigos de estado HTTP estándar y un cuerpo JSON:

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

code es estable y puedes basar tu lógica en él sin riesgo, message está escrito para personas, y details lleva datos adicionales cuando los hay (los campos rechazados de un 400; los créditos mensuales, su fecha de renovación, upgradeUrl y topUpUrl de un 402).

URL de medios

Las imágenes y los vídeos de las respuestas se sirven desde nuestra CDN en https://api.sellwinners.com/v1/media/file/…. Estas URL no necesitan clave de API ni gastan créditos, así que puedes insertarlas directamente en etiquetas <img> y <video>. Un archivo que la fuente de datos ya no tiene se envía como null durante un día, y un archivo que falta responde un 404 vacío de su tipo de medio. Las imágenes de productos y los iconos de apps alojados en la CDN de Shopify también se sirven desde nuestra CDN. Para mostrar una imagen pequeña, añade ?w=96 (miniaturas) o ?w=480 (tarjetas): una imagen JPEG, PNG, WebP o GIF se envía entonces como WebP con ese ancho como máximo, sin ampliarla nunca; una animación, una imagen más pequeña o un vídeo llegan tal cual. Para una lista plana de creatividades lista para mostrar, usa /v1/media.

Para mostrar una imagen a su tamaño original pero más ligera, añade ?w=full: una imagen JPEG, PNG, WebP o GIF se envía entonces como WebP con su ancho y su alto originales, con una calidad que se ve igual, si así se ahorra al menos una décima parte del archivo; si no, y para una animación o un vídeo, el original llega tal cual. Sin w, se envía el archivo original.

Descubrimiento

Convierte un nombre, un dominio o un id de página en los ids que usan los demás endpoints.

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"

Tiendas

Encuentra tiendas de Shopify y obtén sus productos, tráfico, ventas, redes sociales y anuncios.

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

Los totales diarios de todo el mercado y su temporada 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"

Anuncios de Meta

Creatividades de anuncios de Facebook e Instagram con medios, alcance y posición.

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

Creatividades de anuncios de 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

Anuncios y publicaciones orgánicas de 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"

Medios

Creatividades listas para mostrar: URL de imágenes y vídeos en nuestra 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 de Facebook) y su actividad.

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"

Emails

Emails de marketing y newsletters de las 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"

Productos

Productos de tiendas con su precio, ventas, reseñas, anuncios y alcance en la 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

Los valores y los ids que admiten los filtros de búsqueda.

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"

Tableros

Guarda anuncios, tiendas, productos, emails y anunciantes en tableros y compártelos.

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

Anuncios, tiendas y emails favoritos, en carpetas.

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"}'

Vistas guardadas

Las búsquedas que guardaste en las páginas de listas del sitio, 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"

Seguimiento de marcas

Sigue marcas y consulta informes sobre sus anuncios, creatividades y páginas de destino.

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}'