Datapika Meta Ad Library (remote)

01 / Saída gravada

Veja o que retorna.

JSON ↓ CSV ↓

· Build 1.0.9 · 20 linhas revisadas. Visualizando 5 abaixo.

page_name	title	format	is_active	days_active
Nike	Nike ACG Polartec ® 'Wolf Tree' Women's Mid-Rise Trousers	IMAGE	true	520
Nike	Shorts Dri-FIT de 18 cm versátiles sin forro para hombre Nike Form - Negro	IMAGE	true	502
Nike	The Best of Nike - Personalized to You	IMAGE	true	350
Nike	Shorts Nike Essential Kick Feminino	IMAGE	true	43
Nike	Nike	IMAGE	true	63

Campos públicos selecionados de uma execução gravada. O texto pode ser reduzido a 20 palavras e links não-HTTPS são omitidos. Valores ausentes são preservados; esta amostra não estabelece cobertura completa da fonte. Os downloads contêm todas as linhas revisadas e os campos selecionados. As células de texto CSV são escapadas para segurança em planilhas.

Inspecione o primeiro registro JSON

{
  "page_name": "Nike",
  "title": "Nike ACG Polartec ® 'Wolf Tree' Women's Mid-Rise Trousers",
  "format": "IMAGE",
  "is_active": true,
  "days_active": 520,
  "creative_count": 6,
  "start_date": "2025-04-07",
  "ad_library_url": "https://www.facebook.com/ads/library/?id=1702938977100376",
  "item_type": "ad"
}

02 / Execute sua própria consulta

A partir de um console, código ou agente.

Use o formulário de entrada da Apify ou inicie uma execução com seu próprio token de API. A pequena entrada inicial abaixo foi verificada contra o esquema de entrada publicado do build 1.1.1 em 9 de setembro de 2026. Amostras gravadas podem usar entradas diferentes ou builds mais antigos.

curl -X POST \
  "https://api.apify.com/v2/acts/openclawai~meta-ad-library-scraper/runs?maxTotalChargeUsd=1" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["https://www.facebook.com/nike"],"country":"US","maxAdsPerQuery":5,"activeStatus":"ACTIVE"}'

Isso inicia uma execução assíncrona paga com um limite total de US$ 1 por execução. Use o defaultDatasetId retornado para recuperar os resultados após a execução ser bem-sucedida. Nunca coloque seu token de API em código público de frontend.

Esquema de entrada completo ↗ · Configuração da API e exportação de dataset

03 / Referência de campos

Planeje seu modelo de dados.

Campos documentados selecionados do build 1.1.1, revisados em 9 de setembro de 2026. A disponibilidade varia conforme o modo e a fonte. Valores ausentes e nulos permanecem visíveis nas amostras gravadas.

Campo	Tipo	Significado
page_name	string | null	Nome da página do anunciante no Facebook.
title	string | null	Título do criativo principal.
format	string | null	VIDEO, IMAGE ou TEXT — derivado do criativo principal.
is_active	boolean | null	Verdadeiro se o anúncio está atualmente em execução.
days_active	integer | null	Dias entre o início e o fim (ou até hoje, se ainda ativo). Anúncios de longa duração geralmente são os mais lucrativos.
creative_count	integer | null	Número de variações de criativo neste anúncio.
start_date	string | null	Data em que o anúncio começou a ser veiculado (AAAA-MM-DD).
ad_library_url	string | null	Link direto para o anúncio na Biblioteca de Anúncios da Meta.
item_type	string | null	'ad' para um anúncio extraído, 'hint' para uma linha de orientação gratuita (sem resultados / entrada inválida), 'error' para uma linha de erro gratuita.

Baixar as referências de entrada e campos datadas ↓

04 / Saiba antes de executar

Cobertura, sem adivinhação.

Não é uma API de Marketing da Meta. Faixas de gasto e impressões aparecem apenas em anúncios que a Meta classifica como políticos ou de causa social; outros anúncios trazem campos de criativo e data.

Quanto custa extrair anúncios da Biblioteca de Anúncios da Meta?

Este scraper cobra US$ 0,005 por linha de anúncio, então 1.000 anúncios do Facebook ou Instagram custam US$ 5. Não há taxa inicial nem token de desenvolvedor da Meta; o ator lê a Biblioteca de Anúncios pública por meio de proxies residenciais incluídos no preço. O uso da plataforma Apify pode ser aplicado.

Ele retorna gastos e impressões de anúncios?

Sim, onde a Meta os publica. Anúncios políticos e de causa social trazem faixas de gasto e impressões, além de detalhamentos demográficos; anúncios comerciais trazem criativo, datas, plataformas e dias ativos, porque a Meta não divulga seus gastos.