Pular para o conteúdo

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.

Active
Library ID: 2033461067351971
Started running on Nov 14, 2026
Platforms
This ad has multiple versions
5 ads use this creative and text
See summary details
soundcoreSponsored
🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
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.
O primeiro anúncio que uma busca ADS na página da soundcore nos EUA retornou em 20 de novembro de 2026, desenhado como o card da biblioteca.
Etapa 1

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.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "limit": 500
  }
}
  1. limit: 500Anúncios 1–50038,1 s
  2. cursor: "eyJ2IjoxLCJoIj…"Anúncios 501–85528,7 s

855 anúncios em duas respostas, cada um uma veztotalCount: 855

Duas buscas ADS na página da soundcore nos EUA em 20 de novembro de 2026; a segunda enviou como cursor o nextCursor da primeira.
Etapa 2

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.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "action": "advertisers",
    "query": "soundcore",
    "country": "US"
  }
}
USsoundcore
"soundcore"Search this exact phrase
Advertisers
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 followers265641373306592
A ação advertisers para “soundcore” nos EUA em 20 de novembro de 2026: as primeiras 4 das 15 páginas retornadas, na ordem em que a caixa de busca da biblioteca as sugere, cada uma com seu pageId.
Etapa 3

Filtre 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.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "mediaType": "video",
    "publisherPlatforms": [
      "instagram"
    ],
    "startDate": "2026-11-01"
  }
}
activeStatus
  • all903
  • active856
  • inactive47
mediaType
  • meme761
  • video98
  • image0
publisherPlatforms
  • facebook856
  • instagram856
  • threads340
  • audience_network202
  • whatsapp176
  • messenger0

Esta solicitação98

A contagem da biblioteca para cada filtro na página da soundcore nos EUA, em 20 de novembro de 2026. mediaType e publisherPlatforms contam anúncios ativos.

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.

Recomendados pelo ChatGPT · “What are the best wireless earbuds under $200?”Anúncios ativos na Meta que o citam, EUA
  1. Soundcore Liberty 5 Pro211 anúncios2 anunciantessoundcore210
  2. Apple AirPods Pro 3464 anúncios90 anunciantesCosmopolitan63James Martin Jewelers55BILL27
  3. Technics EAH-AZ800 anúncio
  4. Nothing Ear (3)1 anúncio1 anunciante
  5. Sony WF-1000XM51 anúncio1 anunciante
O ChatGPT recomendou estes produtos em 19 de novembro de 2026. Em 20 de novembro de 2026, ADS buscou o nome exato de cada um entre os anúncios ativos nos EUA; as barras contam os anúncios que cada busca retornou, e as marcas entre os anunciantes aparecem pelo nome.

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 →
Custo por solicitação no plano
Plano1.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.