ES
Empezar

Facebook · Ads

API de scraping de Búsqueda en la biblioteca de anuncios de Facebook

El endpoint de Búsqueda en la biblioteca de anuncios de Facebook es una llamada a la API: envía una búsqueda con tu clave de HProxy y recibe un objeto JSON limpio y estructurado. Busca en la Facebook Ad Library por palabra clave y recibe los anuncios activos con creatividades, anunciante, rango de gasto y fechas. HProxy gestiona los proxies, las sesiones, los antibots y el procesado en el servidor, así que no hay ningún navegador sin interfaz que vigilar ni ningún procesador que arreglar cuando Facebook cambia su código. Tú solo tocas el JSON. Los conjuntos de resultados más largos vuelven página a página con un cursor, así que puedes recorrerlos enteros sin tenerlos en memoria.
Consigue tu clave de APIReferencia de la API de Facebook
  • 0.15¢ por llamada
  • 1,49 $ por cada 1.000
  • Acepta una búsqueda
  • Los errores y los tiempos de espera agotados no se cobran

La llamada

Un GET, y búsqueda en la biblioteca de anuncios vuelve como JSON.

Tu clave va en una cabecera. 1 required parameter, and the answer is the object below it.

La referencia completa
curl "https://hproxy.com/api/v1/scrape/facebook/ad-search?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"
Respuesta200 OK · JSON
{
  "advertiser": { "name": "Brand Inc", "pageId": "104..." },
  "creatives": [
    { "format": "video", "body": "Shop the new drop", "media": "https://.../ad.mp4" }
  ],
  "spend": { "min": 5000, "max": 10000, "currency": "USD" },
  "dates": { "firstSeen": "2026-06-30", "lastSeen": "2026-07-17" }
}

Lo que vuelve

El objeto de búsqueda en la biblioteca de anuncios de Facebook.

creatives[]
Los archivos, el texto y el formato de cada anuncio activo.
advertiser
La página o el anunciante que tiene activo el anuncio.
spend / impressions
Rango de gasto y alcance cuando se publican.
dates
Fechas en que se vio por primera y por última vez.

Lo que acepta

Parameters.

querystringRequiredcoffee

Término de búsqueda o palabra clave.

sort_bystringtotal_impressions

Ordering to apply to the results. Allowed values: `total_impressions`, `relevancy_monthly_grouped`.

search_typestringkeyword_unordered

The search type parameter. Allowed values: `keyword_unordered`, `keyword_exact_phrase`.

ad_typestringtodos

The ad type parameter. Allowed values: `all`, `political_and_issue_ads`.

countrystringEstados Unidos

Código de región o país de dos letras, p. ej. ES.

statusstringALL

The status parameter. Allowed values: `ALL`, `ACTIVE`, `INACTIVE`.

media_typestringALL

The media type parameter. Allowed values: `ALL`, `IMAGE`, `VIDEO`, `MEME`, `IMAGE_AND_MEME`, `NONE`.

start_datestring2026-07-01

Filtra por fecha, como AAAA-MM-DD.

end_datestring2026-07-01

Filtra por fecha, como AAAA-MM-DD.

cursorstring0

Token de paginación de la respuesta anterior.

trimbooleantrue

Devolver una respuesta reducida (sin los campos extensos).

Cómo funciona

Scraping de búsqueda en la biblioteca de anuncios de Facebook, en tres pasos.

Tú escribes una línea. Los proxies, los muros antibots, el renderizado y el procesado ocurren en nuestro lado.

  1. 1

    Crea una cuenta gratis

    Regístrate y recarga la cantidad que quieras. El saldo sirve para todos los productos de HProxy.
  2. 2

    Coge tu clave de API

    Una clave del panel autentica todos los scrapers.
  3. 3

    Llama al endpoint

    Envía el GET que necesites y lee el JSON. Esa es toda la integración.

Lo que construye la gente con ello

Dónde vale la pena el endpoint de búsqueda en la biblioteca de anuncios de Facebook.

  • Observa las creatividades y los mensajes de los anuncios de la competencia.
  • Sigue el gasto en anuncios y el calendario de campañas en tu nicho.
  • Crea un archivo de referencia con lo que está activo ahora mismo.

Preguntas sobre búsqueda en la biblioteca de anuncios de Facebook

Respondido antes de que preguntes.

La referencia

Envía una petición HTTPS autenticada al endpoint de Búsqueda en la biblioteca de anuncios de Facebook con una búsqueda y tu clave de API de HProxy. Busca en la Facebook Ad Library por palabra clave y recibe los anuncios activos con creatividades, anunciante, rango de gasto y fechas. Sin proxies, sin navegador sin interfaz y sin procesar nada en tu lado. La respuesta es JSON listo para usar.

Este endpoint cuesta 0.15¢ por llamada correcta, que son 1,49 $ por cada 1.000. Se cobra de tu saldo de HProxy sin suscripción y sin mínimo mensual. Los errores se reintentan y nunca se cobran; una consulta cuyo objetivo no existe cuenta como llamada.

No. Cada llamada funciona por detrás en la propia red residencial de HProxy, así que las peticiones parecen usuarios reales. La capa de proxy ya está incluida en el precio por llamada.

Un objeto JSON estructurado con todos los datos de búsqueda en la biblioteca de anuncios que Facebook expone públicamente. Mira los campos listados arriba. El esquema es constante entre llamadas, así que integras una vez y puedes fiarte de él.

Sí. La respuesta lleva un cursor; pásalo en la siguiente llamada para seguir donde lo dejaste. Cada página es una llamada que se cobra, así que solo pagas la profundidad que obtienes de verdad.

La API solo accede a datos públicos de Facebook, las mismas páginas que cualquiera puede abrir en un navegador. Eres responsable de usar los datos conforme a las leyes aplicables y a las condiciones de Facebook para tu caso de uso.

Documentación e IA

Conecta tu scraper a una IA cuando quieras.

Toda la API de scrapers está publicada en markdown, así que un asistente lee cada endpoint, cada parámetro y una respuesta real sin clave y escribe tu integración. Y como un scrape es un GET que responde en JSON, un agente puede ejecutar el scraper por su cuenta, con su propio horario y con tu clave.

Leer la documentación de los scrapersConfigura tu asistente

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama y cualquier asistente compatible con MCP.

Un agente puede llamarla

Un GET con tu clave devuelve JSON estructurado, así que un agente hace scraping con su propio horario. Sin navegador que manejar ni parser que mantener vivo entre ejecuciones.

Ver los endpoints

Servidor MCP y CLI

Hecho por nosotros para las herramientas gratis y alojado en mcp.hproxy.com: la lista de proxies, el comprobador y la consulta de IPs como herramientas en Claude, ChatGPT, Cursor o cualquier asistente compatible con MCP. Nada que instalar, sin clave.

Añádelo a tu asistente

Documentación de la API

Cada endpoint de scraping documentado de principio a fin, con los parámetros que acepta y la respuesta que devuelve de verdad.

Leer la documentación

Anuncios en otras plataformas

Los mismos datos en 2 plataformas más.

Una clave, una forma de JSON, un saldo. Pasa de una a otra sin aprender una segunda API.

Ad Library API

Más sobre la API de Búsqueda en la biblioteca de anuncios de Facebook

Qué devuelve el endpoint Búsqueda en la biblioteca de anuncios de Facebook

Busca en la Facebook Ad Library por palabra clave y recibe los anuncios activos con creatividades, anunciante, rango de gasto y fechas. El objeto JSON incluye creatives[], advertiser, spend / impressionsy dates. En nuestro lado no se resume ni se recorta nada, así que lo que lees en la respuesta es lo que contiene la propia página de búsqueda en la biblioteca de anuncios en Facebook.

Qué envías a la API Búsqueda en la biblioteca de anuncios de Facebook

La llamada necesita una búsqueda. Obligatorio: query. Opcional: sort_by, search_type, ad_type, country, status, media_type, start_date, end_date, cursory trim. Tu clave viaja en la cabecera X-API-Key, la respuesta es JSON y la llamada se cobra a 0.15¢, 1,49 $ por cada 1.000.

Anuncios en otras plataformas

Los mismos datos de anuncios están disponibles en 2 plataformas más: LinkedIn Búsqueda en la biblioteca de anunciosy Google Anuncios de empresas en la biblioteca. Comparten la forma del JSON de este endpoint, su cobro por llamada y tu única clave de API, así que pasar de Facebook a otra red es cambiar una URL y no hacer una segunda integración.

¿Está permitido hacer scraping de búsqueda en la biblioteca de anuncios de Facebook?

El endpoint lee datos públicos de Facebook, las mismas páginas que cualquiera puede abrir en un navegador sin iniciar sesión. No toca cuentas privadas ni nada que esté detrás de una contraseña. Cómo uses después los datos te toca a ti mantenerlo dentro de la ley, según las normas que se te aplican a ti y a Facebook.

Listos cuando tú lo estés.

Tu panel está a diez segundos. Sin llamada comercial, sin suscripción, sin mínimo.