PT
Começar

Facebook · Ads

API de scraper de Detalhe da biblioteca de anúncios do Facebook

O endpoint de Detalhe da biblioteca de anúncios do Facebook é uma chamada de API: envie um ID ou uma URL com a sua chave da HProxy e receba um objeto JSON limpo e estruturado. Puxe um anúncio da Biblioteca de Anúncios do Facebook por completo: cada criativo, o anunciante por trás, a faixa de gasto e as datas em que rodou. A HProxy roda os proxies, as sessões, o tratamento antibot e o processamento no servidor, então não há navegador headless para vigiar nem parser para consertar quando o Facebook muda o código. Você só mexe no JSON.
Pegue a sua chave de APIReferência da API Facebook
  • 0.15¢ por chamada
  • US$ 1,49 por 1.000
  • Aceita um ID ou uma URL
  • Erros e tempos esgotados não são cobrados

A chamada

Um GET, e detalhe da biblioteca de anúncios volta como JSON.

A sua chave vai em um cabeçalho. 1 required parameter, and the answer is the object below it.

A referência completa
curl "https://hproxy.com/api/v1/scrape/facebook/ad?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "X-API-Key: hpx_your_key_here"
Resposta200 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" }
}

O que volta

O objeto de detalhe da biblioteca de anúncios do Facebook.

creatives[]
Mídia, texto e formato de cada anúncio ativo.
advertiser
A página ou o anunciante que roda o anúncio.
spend / impressions
Faixa de gasto e alcance, quando divulgados.
dates
Datas da primeira e da última veiculação.

O que ele aceita

Parameters.

Envie qualquer um de id, url. id ou url é obrigatório

idstring1234567890

Identificador de uma resposta anterior.

urlurlhttps://www.facebook.com/nasa

URL alvo (perfil, post ou vídeo).

get_transcriptbooleantrue

Also include transcript in the response.

trimbooleantrue

Retornar uma carga reduzida (remove campos detalhados).

cache_max_agestring1d

Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.

Como funciona

Scraping de detalhe da biblioteca de anúncios do Facebook, em três passos.

Você escreve uma linha. Proxies, barreiras antibot, renderização e processamento acontecem do nosso lado.

  1. 1

    Criar uma conta grátis

    Cadastre-se e recarregue qualquer valor. O saldo paga todos os produtos da HProxy.
  2. 2

    Pegue a sua chave de API

    Uma chave do painel autentica todos os scrapers.
  3. 3

    Chame o endpoint

    Envie o GET de que precisa e leia o JSON. A integração inteira é só isso.

O que as pessoas constroem com ele

Onde o endpoint de detalhe da biblioteca de anúncios do Facebook vale a pena.

  • Espione os criativos e as mensagens dos anúncios dos concorrentes.
  • Acompanhe gastos com anúncios e o calendário das campanhas no seu nicho.
  • Monte um arquivo de referência com o que está rodando agora.

Perguntas sobre detalhe da biblioteca de anúncios do Facebook

Respondido antes de você perguntar.

A referência

Envie uma requisição HTTPS autenticada ao endpoint de Detalhe da biblioteca de anúncios do Facebook com um ID ou uma URL e a sua chave de API da HProxy. Puxe um anúncio da Biblioteca de Anúncios do Facebook por completo: cada criativo, o anunciante por trás, a faixa de gasto e as datas em que rodou. Sem proxies, sem navegador headless e sem processamento do seu lado. A resposta é JSON pronto para usar.

Este endpoint custa 0.15¢ por chamada bem-sucedida, o que dá US$ 1,49 por 1.000. A cobrança sai do seu saldo na HProxy, sem assinatura e sem mínimo mensal. Erros são repetidos e nunca cobrados; uma consulta cujo alvo não existe conta como uma chamada.

A API acessa só dados publicamente disponíveis do Facebook, as mesmas páginas que qualquer pessoa pode abrir em um navegador. Você é responsável por usar os dados de acordo com as leis aplicáveis e os termos do Facebook para o seu caso de uso.

Um objeto JSON estruturado com todos os dados de detalhe da biblioteca de anúncios que o Facebook expõe publicamente. Veja os campos listados acima. O esquema é consistente entre as chamadas, então você integra uma vez e pode confiar nele.

Não. Cada chamada roda na própria rede residencial da HProxy nos bastidores, então as requisições parecem usuários reais. A camada de proxy já está incluída no preço por chamada.

Documentação e IA

Conecte seu scraper a uma IA, quando quiser.

Toda a API de scraping está publicada em markdown, então um assistente lê cada endpoint, cada parâmetro e uma resposta real sem chave e escreve sua integração. E como um scrape é um GET que responde em JSON, um agente pode rodar o scraper sozinho, no próprio horário, com a sua chave.

Ler a documentação dos scrapersConfigure seu assistente

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama e qualquer assistente que fale MCP.

Um agente pode chamá-la

Um GET com sua chave retorna JSON estruturado, então um agente faz scraping no próprio horário. Nenhum navegador para controlar, nenhum parser para manter vivo entre execuções.

Ver os endpoints

Servidor MCP e CLI

Construído por nós para as ferramentas grátis e hospedado em mcp.hproxy.com: a lista de proxies, o verificador e a consulta de IP como ferramentas no Claude, ChatGPT, Cursor ou qualquer assistente que fale MCP. Nada para instalar, sem chave.

Adicione ao seu assistente

Documentação da API

Cada endpoint de scraping documentado de ponta a ponta, com os parâmetros que aceita e a resposta que realmente retorna.

Ler a documentação

Anúncios em outros lugares

Os mesmos dados em mais 2 plataformas.

Uma chave, um formato de JSON, um saldo. Mude de lado sem aprender uma segunda API.

Ad Library API

Mais sobre a API de Detalhe da biblioteca de anúncios do Facebook

O que o endpoint Detalhe da biblioteca de anúncios de Facebook retorna

Puxe um anúncio da Biblioteca de Anúncios do Facebook por completo: cada criativo, o anunciante por trás, a faixa de gasto e as datas em que rodou. O objeto JSON traz creatives[], advertiser, spend / impressionse dates. Do nosso lado nada é resumido nem cortado, então o que você lê na resposta é o que a própria página de detalhe da biblioteca de anúncios no Facebook contém.

O que você envia para a API Detalhe da biblioteca de anúncios de Facebook

A chamada precisa de um ID ou uma URL, e qualquer um entre ide url basta. Opcional: id, url, get_transcript, trime cache_max_age. A sua chave vai no cabeçalho X-API-Key, a resposta é JSON e a chamada custa 0.15¢, US$ 1,49 a cada 1.000.

Anúncios em outras plataformas

Os mesmos dados de anúncios estão disponíveis em mais 2 plataformas: LinkedIn Detalhe do anúncioe Google Detalhe do anúncio. Eles compartilham a forma do JSON deste endpoint, a cobrança por chamada e a sua única chave de API, então trocar Facebook por outra rede é mudar uma URL e não fazer uma segunda integração.

É permitido fazer scraping de detalhe da biblioteca de anúncios do Facebook?

O endpoint lê dados publicamente disponíveis do Facebook, as mesmas páginas que qualquer pessoa pode abrir em um navegador sem fazer login. Ele não toca contas privadas nem nada atrás de uma senha. Usar os dados depois de forma legal é responsabilidade sua, segundo as regras que se aplicam a você e ao Facebook.

Prontos quando você estiver.

Seu painel está a dez segundos de distância. Sem ligação de vendas, sem assinatura, sem mínimo.