Meta Ads Library API: qué devuelve y qué no

¿Qué devuelve la Meta Ads Library API?

La Meta Ads Library API devuelve identidad de anunciante, creatividad del anuncio, targeting regional, fechas de ejecución, y (solo para anuncios políticos/sociales) rangos de gasto + rangos de impresiones. NO devuelve: CTR, tasa de conversión, solapamiento de custom audience, linaje de variantes A/B, ni ningún dato de performance de anuncios comerciales. El pipeline de CommonWealth Ops lee la misma superficie — los muros abajo son los límites estructurales que cualquiera integrando contra esta API golpeará.

La documentación oficial lista 15+ campos. En la práctica para un operador construyendo inteligencia:

• `ad_creation_time` / `ad_delivery_start_time` / `ad_delivery_stop_time` — las fechas de ciclo de vida. `stop_time` puede ser NULL mientras el anuncio sigue corriendo.
• `page_id` / `page_name` — la identidad del anunciante.
• `ad_creative_bodies` / `ad_creative_link_titles` / `ad_creative_link_descriptions` — el contenido de texto del anuncio.
• `ad_snapshot_url` — una URL estable a una captura del anuncio como Meta lo archivó. Útil para inspección visual.
• `languages` / `publisher_platforms` — flags de distribución en Facebook, Instagram, Messenger, Audience Network.
• `spend` / `impressions` / `demographic_distribution` — SOLO ANUNCIOS POLÍTICOS/SOCIALES. Devuelve bins de rango ($100-$499, $500-$999, etc.) para gasto; rangos de impresiones agrupados similarmente.

Lo que la API deliberadamente no devuelve

Cinco muros que cada desarrollador integrando contra esta API golpeará:

Muro 1 — Los anuncios comerciales no tienen datos de performance. Todos de `spend`, `impressions`, `demographicdistribution`, `deliveryby_region` se quitan de la respuesta para anuncios no-políticos/no-sociales. Esto es por política — Meta expone transparencia de gasto para anuncios políticamente relevantes bajo la Ley de Servicios Digitales de la UE y las reglas de anuncios políticos de EE.UU., no para anuncios comerciales DTC.

Muro 2 — Nunca datos de conversión o CTR. La plataforma no expone tasas de conversión, tasas de clic, costo-por-acción, o ningún dato de comportamiento post-impresión a través de la API pública para ningún tipo de anuncio. Esta es una decisión fundamental de diseño — la plataforma monetiza esas métricas a través de su Ads Manager API que requiere los permisos de acceso propios de la marca.

Muro 3 — Sin linaje de variantes A/B. Cuando una marca corre 5 anuncios con variaciones menores, la API devuelve 5 anuncios separados sin campo que los vincule como variantes del mismo test. Los operadores tienen que inferir relaciones de variantes desde heurísticas de similitud de texto creativo — propenso a errores y dependiente del idioma.

Muro 4 — Sin datos de custom audience o lookalike. El targeting de audiencia que Meta expone es región + edad/género (solo para anuncios políticos/sociales). Las custom audiences, lookalikes, y el targeting conductual están totalmente amurallados.

Muro 5 — Anuncios una vez activos desaparecen. Para anuncios comerciales, la API devuelve solo anuncios actualmente activos. Un anuncio retirado ayer se fue de la API hoy. Construir un registro histórico requiere capturar semanalmente y persistir localmente — que es exactamente lo que hace el pipeline de captura de CommonWealth Ops para los nichos fitness, skincare y suplementos.

Cómo se ve el pipeline práctico para un operador

Construir contra la Meta Ads Library API para trabajo de inteligencia requiere cuatro decisiones estructurales:

Decisión 1 — Estrategia de token. Token de usuario personal para desarrollo; token de system user para producción. La configuración del system user toma ~30 minutos a través del Meta Business Manager y es requerida para cualquier volumen de lectura sostenido.

Decisión 2 — Manejo de rate limit. 200 llamadas/hora/usuario significa que una pasada de captura de 30 nichos necesita gestión cuidadosa de cola. El pipeline de CommonWealth Ops usa exponential backoff + un budget tracker de rate-limit basado en Redis — patrones documentados en nuestro post cómo CommonWealth Ops recolecta inteligencia.

Decisión 3 — Corrección de paginación. Los page tokens de la API NO son idempotentes entre llamadas — si un nuevo anuncio entra al set de resultado entre páginas, la paginación se desplaza. Capturar un set completo de resultado requiere o (a) aceptar algunas filas duplicadas / perdidas en nichos rápidos, o (b) correr el loop completo de paginación dentro de una sola asignación de budget de rate-limit. CommonWealth Ops acepta el riesgo de duplicados/perdidos y deduplica por `ad_id` en la capa de base de datos.

Decisión 4 — Esquema de persistencia. La respuesta JSON plana de la API necesita normalización en un esquema relacional para trabajo de consulta. La tabla `scrapedads` de CommonWealth Ops tiene 17 columnas incluyendo el binning `viewsband` añadido en Sprint 25, `spendrange` dejado NULL para anuncios comerciales (muro de Meta), y `hooktext` transcrito con Whisper para el subset de creatividad de video.

Cómo usa CommonWealth Ops la API en producción

CommonWealth Ops captura datos de Meta Ads Library semanalmente para los nichos fitness, skincare y suplementos en múltiples geografías. La captura actual saca marcas como Flipkart, BigMuscles Nutrition, Lazada, Hardyn, Amazon India, Tori Repa, Angê, Jewel by ZERO, MyFitness, Rogue Fitness Europe, WHOOP y Freeletics en fitness; HK Vitals, Purplle beauty, La Roche-Posay Indonesia, BEARDO for Men, Lotus Botanicals, Pilgrim, Clinikally, y las variantes de la franquicia Plix + franquicia Pilgrim + franquicia Mamaearth en skincare.

El set capturado aterriza en un esquema PostgreSQL normalizado. Los suscriptores reciben el informe semanal de inteligencia por nicho derivado del historial persistido — que es el valor añadido que la API cruda no provee.

La metodología está completamente documentada en nuestro post cómo CommonWealth Ops recolecta inteligencia. Los desarrolladores integrando sus propios pipelines contra la API deberían emparejar la documentación oficial con la documentación de muros de CommonWealth Ops en nuestro post por qué la longevidad de un anuncio supera al gasto como señal para los límites estructurales que los docs no sacan claramente.

Ver precios →