Saltar al contenido

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.

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
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.
El primer anuncio que devolvió una búsqueda ADS en la página de soundcore en EE. UU. el 20 de noviembre de 2026, dibujado como la ficha de la biblioteca.
Paso 1

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.

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

855 anuncios en dos respuestas, cada uno una veztotalCount: 855

Dos búsquedas ADS en la página de soundcore en EE. UU. el 20 de noviembre de 2026; la segunda envió como cursor el nextCursor de la primera.
Paso 2

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.

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
La acción advertisers para “soundcore” en EE. UU. el 20 de noviembre de 2026: las primeras 4 de las 15 páginas que devolvió, en el orden en que las sugiere el buscador de la biblioteca, cada una con su pageId.
Paso 3

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

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 solicitud98

El recuento de la biblioteca para cada filtro en la página de soundcore en EE. UU., ejecutado el 20 de noviembre de 2026. mediaType y publisherPlatforms cuentan anuncios activos.

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.

Recomendados por ChatGPT · “What are the best wireless earbuds under $200?”Anuncios activos en Meta que lo nombran, EE. UU.
  1. Soundcore Liberty 5 Pro211 anuncios2 anunciantessoundcore210
  2. Apple AirPods Pro 3464 anuncios90 anunciantesCosmopolitan63James Martin Jewelers55BILL27
  3. Technics EAH-AZ800 anuncios
  4. Nothing Ear (3)1 anuncio1 anunciante
  5. Sony WF-1000XM51 anuncio1 anunciante
ChatGPT recomendó estos productos el 19 de noviembre de 2026. El 20 de noviembre de 2026, ADS buscó el nombre exacto de cada uno entre los anuncios activos en EE. UU.; las barras cuentan los anuncios que devolvió cada búsqueda y se nombran las marcas entre los anunciantes.

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 →
Coste por solicitud según el plan
Plan1.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.