API da Biblioteca de Anúncios da Meta: anúncios do Facebook e do Instagram em JSON
Pesquise na Biblioteca de Anúncios da Meta por palavra-chave ou por anunciante e receba em JSON, por uma API assíncrona, os anúncios veiculados no Facebook, Instagram, Messenger, WhatsApp e Threads, cada um com texto, imagens e vídeo, página de destino, chamada para ação, data de início e plataformas.
Buscas na Biblioteca de Anúncios da Meta executadas em 20 de novembro de 2026, desenhadas com os anúncios que retornaram.
Todos os anúncios de um anunciante na Meta
Envie taskType ADS com payload.platform meta_ad_library e o ID da página do Facebook de um anunciante em pageId, ou uma palavra-chave em query. Cada anúncio chega com seu ID na biblioteca, data de início, as plataformas em que é veiculado, quantos anúncios usam o mesmo criativo, texto, imagens ou vídeo, página de destino e chamada para ação, junto com a contagem de anúncios correspondentes da biblioteca. Os resultados chegam por webhook ou polling.
soundcoreSponsored
libraryId2033461067351971- O ID do anúncio na Biblioteca de Anúncios da Meta; libraryUrl o abre lá.
startDateisActive2026-11-14 · true- O dia em que o anúncio começou a ser veiculado e se ainda está ativo.
platformsFACEBOOK, INSTAGRAM- Os apps da Meta que exibem o anúncio.
versionsformat5 · DCO- Quantos anúncios usam este criativo e este texto; DCO indica um anúncio que a Meta monta a partir de cartões.
pageNamepageLikeCountsoundcore · 147919- A página do anunciante e suas curtidas, com pageId para buscar seus outros anúncios.
body🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.- O texto do anúncio acima da imagem.
cards2- Cada cartão com sua imagem ou vídeo, texto e link; a biblioteca mostra o primeiro.
titlectaTextlinkUrlAeroClip 2 Open-Ear · Shop now- A barra de link sob a imagem: título, descrição, botão e linkUrl.
Busque por palavra-chave ou por anunciante
query encontra as palavras do texto de um anúncio em qualquer ordem, ou como frase exata com searchType keyword_exact_phrase. pageId reúne os anúncios de um anunciante. country define onde os anúncios foram veiculados, ALL busca em todos os países e limit retorna até 500 anúncios em uma solicitação. Envie o nextCursor de uma resposta como cursor para receber os anúncios seguintes.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"limit": 500
}
}limit: 500Anúncios 1–50038,1 scursor: "eyJ2IjoxLCJoIj…"Anúncios 501–85528,7 s
855 anúncios em duas respostas, cada um uma veztotalCount: 855
Encontre o ID da página de um anunciante pelo nome
action advertisers retorna as páginas do Facebook cujo nome corresponde a query, na ordem em que a busca da biblioteca as sugere, cada uma com seu pageId, categoria, curtidas, selo de verificação e conta do Instagram. Envie o pageId escolhido para receber os anúncios desse anunciante.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"action": "advertisers",
"query": "soundcore",
"country": "US"
}
}
soundcore@soundcoreaudio · 148K follow this · Electronics@soundcoreaudio · 154K followers266556540473351
AnkerSoundcoreuk@ankersoundcoreUK · 1.8K follow this · Information Technology Company328639343660125
Anker soundcore Polska@AnkersoundcorePL · 1.4K follow this · Electronics@anker_soundcore_polska · 2.9K followers613865685153030
soundcore Deutschland1.2K follow this · Music & Audio@soundcore_de · 17.8K followers265641373306592Filtre por status, formato, plataforma e data
activeStatus escolhe anúncios ativos, inativos ou todos, mediaType mantém os anúncios de imagem, vídeo ou meme, e publisherPlatforms os do Facebook, Instagram, Audience Network, Messenger, WhatsApp ou Threads. contentLanguages, startDate e endDate restringem os anúncios aos idiomas e aos dias em que foram veiculados, e sortBy os ordena por impressões ou pelos mais recentes.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"mediaType": "video",
"publisherPlatforms": [
"instagram"
],
"startDate": "2026-11-01"
}
}activeStatusall903active856inactive47
mediaTypememe761video98image0
publisherPlatformsfacebook856instagram856threads340audience_network202whatsapp176messenger0
Esta solicitação98
O que a IA recomenda e quem anuncia
Envie uma pergunta de compra a um mecanismo de respostas e busque pelo nome cada produto recomendado na Biblioteca de Anúncios da Meta para ver quais marcas anunciam os produtos escolhidos pela IA e quais outros anunciantes veiculam anúncios com esses nomes.
Soundcore Liberty 5 Pro211 anúncios2 anunciantes
soundcore210
Apple AirPods Pro 3464 anúncios90 anunciantes
Cosmopolitan63
James Martin Jewelers55
BILL27
Technics EAH-AZ800 anúncio
Nothing Ear (3)1 anúncio1 anunciante
Sony WF-1000XM51 anúncio1 anunciante
0.5 créditos a cada 30 anúncios
Uma busca custa 0.5 créditos a cada 30 anúncios retornados, com mínimo de 0.5 créditos: a solicitação padrão de 30 anúncios custa 0.5 créditos, e uma busca de 500 anúncios, até 8.5. Uma busca de anunciantes custa 0.5 créditos. Só as solicitações concluídas são cobradas.
Ver preços →| Plano | 1.000 solicitações |
|---|---|
| Basic | ≈ $1.25 |
| Max | ≈ $0.50 |
Custos efetivos supondo o uso de todos os créditos mensais incluídos.
Recursos relacionados
Comece com 500 créditos grátis
Execute sua primeira tarefa no Playground ou chame a API com sua chave.





