API de la Biblioteca de anuncios de Meta: anuncios de Facebook e Instagram en JSON
Busca en la Biblioteca de anuncios de Meta por palabra clave o por anunciante y recibe en JSON, a través de una API asíncrona, los anuncios que circulan en Facebook, Instagram, Messenger, WhatsApp y Threads, cada uno con su texto, imágenes y vídeo, página de destino, llamada a la acción, fecha de inicio y plataformas.
Búsquedas en la Biblioteca de anuncios de Meta ejecutadas el 20 de noviembre de 2026, dibujadas con los anuncios que devolvieron.
Todos los anuncios de un anunciante en Meta
Envía taskType ADS con payload.platform meta_ad_library y el ID de la página de Facebook de un anunciante en pageId, o una palabra clave en query. Cada anuncio llega con su ID de la biblioteca, su fecha de inicio, las plataformas donde circula, cuántos anuncios comparten su contenido, su texto, sus imágenes o su vídeo, su página de destino y su llamada a la acción, junto con el recuento de anuncios coincidentes de la biblioteca. Los resultados llegan por webhook o por sondeo.
soundcoreSponsored
libraryId2033461067351971- El ID del anuncio en la Biblioteca de anuncios de Meta; libraryUrl lo abre allí.
startDateisActive2026-11-14 · true- El día en que el anuncio empezó a circular y si sigue activo.
platformsFACEBOOK, INSTAGRAM- Las apps de Meta que muestran el anuncio.
versionsformat5 · DCO- Cuántos anuncios comparten este contenido y texto; DCO indica un anuncio que Meta compone con tarjetas.
pageNamepageLikeCountsoundcore · 147919- La página del anunciante y sus Me gusta, con pageId para buscar sus otros anuncios.
body🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.- El texto del anuncio sobre la imagen.
cards2- Cada tarjeta con su imagen o vídeo, texto y enlace; la biblioteca muestra la primera.
titlectaTextlinkUrlAeroClip 2 Open-Ear · Shop now- La barra de enlace bajo la imagen: título, descripción, botón y linkUrl.
Busca por palabra clave o por anunciante
query busca las palabras del texto de un anuncio en cualquier orden, o como frase exacta con searchType keyword_exact_phrase. pageId reúne los anuncios de un anunciante. country fija dónde circularon los anuncios, ALL busca en todos los países y limit devuelve hasta 500 anuncios en una solicitud. Envía el nextCursor de una respuesta como cursor para recibir los anuncios siguientes.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"limit": 500
}
}limit: 500Anuncios 1–50038,1scursor: "eyJ2IjoxLCJoIj…"Anuncios 501–85528,7s
855 anuncios en dos respuestas, cada uno una veztotalCount: 855
Encuentra el ID de página de un anunciante por su nombre
action advertisers devuelve las páginas de Facebook cuyo nombre coincide con query, en el orden en que las sugiere el buscador de la biblioteca, cada una con su pageId, su categoría, sus me gusta, su insignia de verificación y su cuenta de Instagram. Envía el pageId que elijas para recibir los anuncios de ese 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 followers265641373306592Filtra por estado, formato, plataforma y fecha
activeStatus elige anuncios activos, inactivos o todos, mediaType se queda con los anuncios de imagen, vídeo o meme, y publisherPlatforms con los de Facebook, Instagram, Audience Network, Messenger, WhatsApp o Threads. contentLanguages, startDate y endDate acotan los anuncios por idioma y por los días en que circularon, y sortBy los ordena por impresiones o por los más recientes.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"mediaType": "video",
"publisherPlatforms": [
"instagram"
],
"startDate": "2026-11-01"
}
}activeStatusall903active856inactive47
mediaTypememe761video98image0
publisherPlatformsfacebook856instagram856threads340audience_network202whatsapp176messenger0
Esta solicitud98
Lo que recomienda la IA y quién lo anuncia
Envía una pregunta de compra a un motor de respuestas y busca por su nombre en la Biblioteca de anuncios de Meta cada producto que recomienda para ver qué marcas anuncian los productos que elige la IA y qué otros anunciantes publican anuncios con esos nombres.
Soundcore Liberty 5 Pro211 anuncios2 anunciantes
soundcore210
Apple AirPods Pro 3464 anuncios90 anunciantes
Cosmopolitan63
James Martin Jewelers55
BILL27
Technics EAH-AZ800 anuncios
Nothing Ear (3)1 anuncio1 anunciante
Sony WF-1000XM51 anuncio1 anunciante
0.5 créditos por cada 30 anuncios
Una búsqueda cuesta 0.5 créditos por cada 30 anuncios que devuelve, con un mínimo de 0.5 créditos: la solicitud predeterminada de 30 anuncios cuesta 0.5 créditos, y una búsqueda de 500 anuncios, hasta 8.5. Una búsqueda de anunciantes cuesta 0.5 créditos. Solo se cobran las solicitudes completadas.
Ver precios →| Plan | 1.000 solicitudes |
|---|---|
| Basic | ≈ $1.25 |
| Max | ≈ $0.50 |
Coste efectivo suponiendo que se usan todos los créditos mensuales incluidos.
Funciones relacionadas
Empieza con 500 créditos gratis
Ejecuta tu primera tarea en el Playground o llama a la API con tu clave.





