facebook-ad-library/
search

Busque anuncios públicos de la Facebook Ad Library por palabra clave y filtros, con anunciante, texto creativo, medios, entrega y métricas visibles en registros normalizados.

Facebook Ad Library Search API

Búsqueda de anuncios por palabra clave
Contexto creativo y de entrega
Datos publicitarios públicos
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Facebook Ad Library Search

Los resultados de Facebook Ad Library Search son anuncios públicos que coinciden con una palabra clave, con la identidad de la página del anunciante, el texto creativo y los medios, las fechas de entrega, las plataformas de publicación, los países y las métricas visibles. Estos registros sirven para descubrir creatividades, investigar anunciantes, monitorear anuncios activos y comparar consultas repetibles.

Funcionalidades de la Facebook Ad Library Search API

  • Coincidencia por palabra clave y por fraseBusque con una consulta no vacía y elija entre coincidencia de palabras clave sin orden o de frase exacta para controlar qué anuncios públicos cumplen los criterios.
  • Filtros y orden de búsquedaAcote los resultados por tipo de anuncio, país, estado de entrega, tipo de medio, intervalo de fechas y un orden compatible por impresiones o relevancia.
  • Registros normalizados de anuncios y anunciantesDevuelve la identidad del archivo del anuncio, la URL de origen pública, el contexto de la página del anunciante, el título creativo, el texto principal y la hora de recopilación en un registro uniforme.
  • Contexto creativo, de entrega y públicoConserva las imágenes o videos disponibles, las horas de inicio y fin, el estado activo, las plataformas de publicación, los países, los detalles del CTA, los destinos y las métricas visibles.
  • Recopilación acotada y deduplicadaPermite solicitar de 20 a 2,000 resultados, y los ID de archivo o las URL de anuncios públicos duplicados se guardan una sola vez entre las páginas de resultados disponibles.

Parámetros de la Facebook Ad Library Search API

ParámetrosObligatorioDescripción
queryObligatorioPalabra clave o frase obligatoria y no vacía que se usa para buscar anuncios públicos.
results_limitOpcionalNúmero máximo de anuncios únicos por guardar. El valor predeterminado es 100 y se aceptan enteros de 20 a 2,000.
search_typeOpcionalModo de coincidencia de palabras clave. El valor predeterminado es keyword_unordered; use keyword_exact_phrase cuando el orden de las palabras deba coincidir.
ad_typeOpcionalFiltro de categoría del anuncio. El valor predeterminado es all y se puede restringir a political_and_issue_ads.
countryOpcionalFiltro de país. Use ALL o un código de país de dos letras; los códigos de letras enviados se normalizan a mayúsculas.
statusOpcionalFiltro del estado de entrega. El valor predeterminado es ACTIVE y admite ALL, ACTIVE o INACTIVE.
media_typeOpcionalFiltro del medio de la creatividad. Admite ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME o NONE, y el valor predeterminado es ALL.
sort_byOpcionalOrden de los resultados. El valor predeterminado es total_impressions y también admite relevancy_monthly_grouped.
start_dateOpcionalFecha de inicio opcional del período de impresiones en formato YYYY-MM-DD.
end_dateOpcionalFecha de fin opcional del período de impresiones en formato YYYY-MM-DD; no puede ser anterior a start_date.

Cómo usar la Facebook Ad Library Search API

Envíe una palabra clave con los filtros que definen su muestra de anuncios y lea todos los registros normalizados de la tarea asíncrona completada.

  1. Prepare una consulta no vacía y elija, si lo desea, los controles de coincidencia, anuncio, país, estado, medios, orden, fechas y límite de resultados.
  2. Envíe la solicitud por POST a /v1/facebook-ad-library/search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
  4. Lea data.results.items y luego siga next_cursor mientras has_more siga en true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"country":"US","status":"ACTIVE","media_type":"VIDEO","search_type":"keyword_unordered"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Facebook Ad Library Search API

  • Descubrimiento de anuncios guiado por palabras clave: Use la consulta enviada, los ID de anuncio, el texto creativo, los nombres de anunciantes y las URL públicas para armar un conjunto rastreable de anuncios públicos coincidentes.
  • Comparación de creatividades y formatos: Compare los títulos creativos, el texto principal, las imágenes, los videos, los formatos de visualización, los valores de CTA, los destinos y las plataformas de publicación entre los registros coincidentes.
  • Monitoreo de anuncios activos: Repita una consulta definida y compare entre observaciones los ID de anuncio, el estado activo, las horas de inicio y fin, las plataformas de publicación y las horas de recopilación.
  • Investigación de anunciantes candidatos: Use los ID de página de los anunciantes, los nombres, los alias, las URL, los Me gusta visibles de la página y la creatividad coincidente para identificar las páginas que merecen una investigación más puntual.

Consejos de expertos para la Facebook Ad Library Search API

  • Use keyword_exact_phrase cuando el orden de las palabras tenga significado; use keyword_unordered cuando los anuncios puedan variar el orden de la frase.
  • Aplique los filtros de país, estado, medios, tipo de anuncio y fechas antes de aumentar results_limit para que la muestra guardada siga siendo precisa.
  • Trate results_limit como el tope de la recopilación y luego siga los cursores de resultados de la tarea hasta que has_more sea false para leer todos los registros almacenados.
  • Deduplique las ejecuciones repetidas por el ID de archivo del anuncio o la URL pública del anuncio, y conserve extra.search_query y collected_at como contexto de la observación.
  • Trate el alcance, el gasto, los Me gusta de la página, las fechas de fin, los medios, el CTA o los valores de país ausentes como datos públicos no disponibles y no como cero.

Además de la Facebook Ad Library Search API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook Ad Library.

  • Facebook Ad Library Company Search API — Encuentra páginas candidatas de anunciantes por nombre de empresa o de página, con ID de página, clasificaciones, imágenes, audiencia visible y señales de Instagram vinculadas.
  • Facebook Ad Library Company Ads API — Recolecta los anuncios públicos de un anunciante a partir del ID de su página, con campos de creativo, entrega, mercado, contenido multimedia, CTA y señales visibles.
  • Facebook Ad Library Ad API — Recolecta un anuncio público de la Ad Library desde su URL, con campos de creativo, anunciante, contenido multimedia, entrega, CTA y señales visibles.

Explorar otras plataformas

Combine los datos de Facebook Ad Library con datos públicos de otras plataformas sociales compatibles.

Facebook Ad Library Search API — FAQ

Facebook Ad Library Search API recupera anuncios públicos a partir de una palabra clave o frase no vacía y filtros de búsqueda opcionales. Devuelve la identidad normalizada del anuncio, el contexto de la página del anunciante, el texto creativo y los medios, los campos de entrega y las métricas visibles.

query es obligatorio. La solicitud también acepta results_limit, sort_by, search_type, ad_type, country, status, media_type, start_date y end_date.

keyword_unordered busca las palabras de query sin exigir su orden original, mientras que keyword_exact_phrase conserva el orden de la frase. El valor predeterminado es keyword_unordered.

Un resultado normalizado puede incluir la identidad del anuncio y del anunciante, el texto creativo, las imágenes o videos, las fechas y el estado de entrega, las plataformas de publicación, los países, los campos de CTA y destino, los Me gusta de la página, el alcance, el contexto de gasto y la hora de recopilación. Los campos públicos quedan vacíos cuando no se exponen.

Es posible que ningún anuncio público coincida con la palabra clave, o que los filtros de país, estado, medios, tipo de anuncio o fechas seleccionados excluyan todos los registros disponibles. La disponibilidad de la fuente pública también puede dejar vacía una tarea completada.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 20 a 2,000 como el máximo de anuncios únicos por guardar. Una vez completada la tarea, siga next_cursor mientras has_more sea true para leer todas las páginas de resultados almacenadas.

Cada anuncio normalizado devuelto cuesta 0.5 créditos de SocQ. Los resultados vacíos no generan cargo por resultado.