Plataforma de SPY Externas

Extrae anuncios, productos, métricas y keywords de las principales plataformas públicas de publicidad digital: Meta Ads Library, TikTok Creative Center y Google Ads Transparency Center.

✅ 100% gratuito — No requiere suscripciones a plataformas de pago. Usa fuentes oficiales y públicas.

---

¿Qué hace este Actor?

Este Actor actúa como una plataforma de inteligencia publicitaria que consolida datos de múltiples fuentes oficiales en un solo lugar. Ideal para:

• 🔍 Investigadores de marketing que analizan tendencias de anuncios
• 📊 Agencias digitales que hacen benchmarking competitivo
• 🛒 E-commerce y dropshippers que identifican productos ganadores
• 💼 Freelancers y consultores que reportan estrategias de la competencia

---

Plataformas soportadas

Plataforma	Fuente de datos	Acceso
Meta Ads Library	Facebook/Instagram anuncios activos	Gratuito (token opcional)
TikTok Creative Center	Anuncios trending en TikTok	Gratuito
Google Ads Transparency	Anuncios de Google Search y Display	Gratuito

---

Datos extraídos

• 📢 Anuncios activos: texto, imagen/video, CTA, fechas
• 🏪 Información del anunciante: nombre, país, categoría
• 📈 Métricas de rendimiento: impresiones, alcance, tipo de medio
• 🔑 Keywords y hashtags: términos usados en los anuncios
• 🌍 Segmentación: países objetivo, idioma

---

Parámetros de entrada

Parámetro	Tipo	Descripción	Requerido
platform	String	Plataforma a consultar: meta, tiktok, google	✅ Sí
keywords	Array	Lista de palabras clave a buscar	⬜ Opcional
advertiser	String	Nombre del anunciante específico	⬜ Opcional
country	String	Código de país (ej: US, MX, ES)	⬜ Opcional
ad_type	String	Tipo de anuncio: ALL, IMAGE, VIDEO, TEXT	⬜ Opcional
max_results	Integer	Número máximo de resultados (default: 50)	⬜ Opcional
date_from	String	Fecha inicio en formato YYYY-MM-DD	⬜ Opcional
date_to	String	Fecha fin en formato YYYY-MM-DD	⬜ Opcional
meta_token	String	Token de acceso a Meta API (amplía límites)	⬜ Opcional

---

Formato de salida

Cada anuncio extraído se guarda en el dataset de Apify con esta estructura:

{
  "platform": "meta",
  "ad_id": "123456789",
  "advertiser_name": "Marca Ejemplo",
  "advertiser_country": "MX",
  "ad_text": "Texto del anuncio...",
  "media_type": "VIDEO",
  "status": "ACTIVE",
  "start_date": "2024-01-15",
  "end_date": null,
  "impressions": "1000-5000",
  "countries": ["MX", "US", "ES"],
  "currency": "MXN",
  "url": "https://www.facebook.com/ads/library/?id=123456789",
  "scraped_at": "2024-06-01T12:00:00Z"
}

---

Ejemplos de uso

Buscar anuncios de fitness en Meta

{
  "platform": "meta",
  "keywords": ["gym", "fitness", "suplementos"],
  "country": "MX",
  "ad_type": "VIDEO",
  "max_results": 100
}

Analizar anuncios trending en TikTok

{
  "platform": "tiktok",
  "keywords": ["dropshipping", "winning product"],
  "country": "US",
  "max_results": 50
}

Investigar competidores en Google Ads

{
  "platform": "google",
  "advertiser": "Nike",
  "country": "US",
  "max_results": 30
}

---

Token de Meta API (opcional)

Para obtener más resultados de Meta Ads Library, puedes usar un token de acceso:

1. Ve a developers.facebook.com
2. Crea una aplicación gratuita
3. Genera un token de acceso de usuario
4. Agrégalo en el campo meta_token

Sin token, el Actor sigue funcionando con límites más bajos.

---

Preguntas frecuentes

¿Necesito pagar alguna suscripción? No. Este Actor usa únicamente fuentes de datos públicas y gratuitas.

¿Es legal usar estos datos? Sí. Todas las plataformas cubiertas tienen una biblioteca pública de anuncios por transparencia regulatoria (GDPR, regulaciones electorales, etc.).

¿Puedo usarlo en mis proyectos comerciales? Sí, puedes usar los datos extraídos para análisis competitivo, investigación de mercado y creación de estrategias publicitarias.

¿Con qué frecuencia se actualizan los datos? Los datos se extraen en tiempo real cada vez que ejecutas el Actor.

---

Soporte

¿Tienes preguntas o encontraste un bug? Abre un issue en la sección de Issues del Actor.

---

Desarrollado por ycarrillo