Una API de biblioteca de anuncios para anuncios de Meta, Google y TikTok

Todas las búsquedas usan la misma clave, la misma paginación y los mismos códigos de error, y responden en JSON. Llama a la API desde un script o desde tu propia app, o deja que un agente de IA la llame a través del servidor MCP.

Anuncios de Meta, Google y TikTok en una sola API de bibliotecas de anuncios

Detrás de la clave hay tres conjuntos de datos de anuncios. Los anuncios de Meta cubren Facebook e Instagram, y los buscas por palabras del texto, de la marca o de la página de destino. Los anuncios de Google pueden ser de texto, de imagen o de vídeo, con un filtro para la red en la que se publicaron, YouTube incluido. Un anuncio de vídeo enlaza al Centro de transparencia de anuncios de Google, donde se reproduce. TikTok te da anuncios y publicaciones orgánicas en una sola búsqueda, con sus visualizaciones, me gusta y compartidos.

Cada anuncio apunta a la marca que hay detrás: la página del anunciante y, cuando existe, la tienda Shopify vinculada a ella. Así puedes ir de un anuncio a la tienda, y luego al tráfico y los más vendidos de la tienda, con la misma clave.

La lista completa está en la Documentación de la API. Si prefieres hacer clic en lugar de programar, las mismas búsquedas funcionan en nuestra herramienta espía de anuncios.

Consigue una clave de API y envía tu primera petición

1. Crea una cuenta, confirma tu email y elige un plan de pago: la API empieza ahí.
2. Abre Claves de API en tu panel y crea una clave. Cópiala enseguida: solo se muestra una vez.
3. Envía la clave en cada petición, en la cabecera X-API-Key o como token bearer.

Esta petición encuentra anuncios de vídeo de cuidado de la piel que siguen activos. Funciona en todos los planes de pago:

# Search Meta ads
curl "https://api.sellwinners.com/v1/ads?search=skincare&status=active&mediaType=video&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/ads Parámetros y campos en la documentación

La respuesta contiene un requestId, los anuncios en data y un objeto pagination. En cada anuncio, media tiene las URL de la miniatura y del vídeo, content el titular, el texto, la llamada a la acción y la página de destino, y advertiser la página que lo publica. metrics cuenta los duplicados y añade el alcance y la inversión estimada.

Una búsqueda de Meta devuelve un anuncio por marca, para que un solo anunciante no llene la página. Sube maxAdsPerBrand (hasta 15, o 0 para no poner límite) para ver más de cada una.

Filtra por nombre

Los anuncios de Meta admiten 111 filtros con nombre, enviados como parámetros de consulta en un GET o como campos del cuerpo en un POST. Algunos habituales son minDaysRunning, countries, cta y minDuplicates. Un nombre mal escrito recibe un 400 validation_failed que enumera los nombres que admite el endpoint, así que una errata nunca devuelve anuncios sin filtrar.

# Search Meta ads with advanced filters
curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "skincare", "status": "active", "mediaType": "video", "countries": ["US"], "minDaysRunning": 30, "sortBy": "reach", "limit": 10}'

POST /v1/ads/query Parámetros y campos en la documentación

El alcance es el alcance en la UE y el Reino Unido, y la inversión es siempre una estimación.

Todos los anuncios de una marca

Encuentra el id de anunciante de la marca con GET /v1/lookup?q=allbirds.com&type=advertiser y luego enumera sus anuncios, los de más tiempo activos primero:

# Meta ads of one advertiser
curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?sortBy=longestRunning&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/advertisers/{advertiser_id}/ads Parámetros y campos en la documentación

Nuestra página sobre la búsqueda en la biblioteca de anuncios de Meta explica esta vista en la aplicación web, junto con el mix de formatos y las páginas de destino de la marca.

Paginación de los resultados

Las búsquedas admiten limit (hasta 100) y page u offset. Para la página siguiente, repite la petición con page más uno, u offset más limit. Detente cuando hasMore sea false.

La paginación llega a los primeros 5.000 resultados de una búsqueda (en una búsqueda de anunciantes, a los 100 primeros). Para ir más allá, añade filtros o cambia el orden. La mayor parte de la investigación necesita la parte alta de una lista bien filtrada, no la página 200.

Límites de peticiones y créditos por plan

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. Los errores, los rechazos, las consultas a lookup y los valores de filtros no cuestan nada, y una llamada a una herramienta MCP cuesta los resultados que devuelve, igual que la API. Todos los miembros de un espacio de trabajo, sus claves, la API y el servidor MCP comparten un mismo saldo de créditos y un mismo límite de peticiones. Los créditos mensuales se renuevan a las 00:00 UTC del día 1 de cada mes; los créditos de recarga comprados en la página de facturación se conservan.

Cada respuesta incluye X-RateLimit-Remaining y X-Credits-Remaining, y X-Usage-Cost indica lo que ha costado la llamada, para que tu código pueda frenar antes de que se rechace. Si superas el límite por minuto, recibes 429 rate_limited con un Retry-After en segundos. Cuando se agotan los créditos mensuales y los créditos de recarga, recibes 402 insufficient_credits hasta que se renueven los créditos. GET /v1/usage muestra cómo vas y no cuesta nada. Más detalles en la sección de límites de peticiones y créditos.

Busca anuncios desde un agente de IA con el servidor MCP

El servidor MCP ofrece a un agente de IA los mismos datos como herramientas, a través de HTTP transmitible (streamable HTTP), con tu clave de API en la cabecera X-API-Key. La página de nuestro Servidor MCP para agentes de IA tiene la URL del servidor y configuraciones listas para Cursor, VS Code y Claude Desktop.

Para la investigación de anuncios, el agente llama sobre todo a search_ads, a scan_ad para abrir un anuncio, a search_google_ads_library, a search_tiktok_library y a search_advertisers. Pides en lenguaje natural: «Encuentra anuncios de vídeo de cuidado de la piel que sigan activos en EE. UU., abre los tres que llevan más tiempo y enumera sus ganchos». El agente lo convierte en filtros y llamadas. Las reglas del plan son las mismas que en la API.

En qué se diferencia de la API de la Biblioteca de anuncios de Meta

SellWinners no es la API oficial de Meta. Es un servicio independiente y no está afiliado a Meta. Meta tiene su propia API de la Biblioteca de anuncios. En su página de herramientas de la Biblioteca de anuncios («Meta Ad Library tools» en su Centro de transparencia), Meta dice que la API «permite un análisis más profundo de los anuncios sobre temas sociales, elecciones o política, así como de los anuncios que se entregan en la UE y territorios asociados», y habla de «usuarios autorizados». Consultamos esa página el 19 de octubre de 2026.

Las dos sirven para trabajos distintos. La API de Meta la gestiona Meta, con las reglas de Meta. SellWinners está hecha para la investigación de e-commerce:

• Una sola clave para los anuncios de Meta, Google y TikTok, con la misma paginación, los mismos errores y los mismos límites.
• Anuncios vinculados a la marca que hay detrás: la página del anunciante y la tienda Shopify cuando la hay.
• Filtros que te ayudan a detectar anuncios que siguen activos: días activo, duplicados, llamada a la acción y ranking del anuncio.
• Un servidor MCP, para que un agente de IA haga las búsquedas por ti.
• Alcance de los anuncios mostrados en la UE y el Reino Unido, y una inversión estimada.

Si tu trabajo trata de anuncios políticos o sobre temas sociales, la propia API de Meta está hecha para eso. Si quieres ver lo que publican las marcas de e-commerce en tres redes, y qué tiendas hay detrás de los anuncios, ese es el trabajo que hace SellWinners.

Próximos pasos

Empieza con una pregunta, como qué marcas de cuidado de la piel han mantenido el mismo vídeo activo durante un mes. Ejecútala una vez con curl y luego pásala a tu código. Para profundizar en una plataforma, abre la biblioteca de anuncios de TikTok, la biblioteca de anuncios de Google o la búsqueda de anunciantes. Si quieres vigilar a un competidor, puedes seguir los anuncios de una marca a lo largo del tiempo. Para el mercado en general, consulta cómo se comparan las herramientas espía de anuncios.

Buscar anuncios en Explorar