PT
Começar

Facebook · Ads

API de scraper de Anúncios da empresa do Facebook

O endpoint de Anúncios da empresa do Facebook é uma chamada de API: envie um ID de página ou um companyName com a sua chave da HProxy e receba um objeto JSON limpo e estruturado. Puxe todos os anúncios que uma empresa está rodando no Facebook agora, com criativos, texto, formato, faixa de gasto e há quanto tempo cada um roda. 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. Conjuntos de resultados maiores voltam página por página com um cursor, para você percorrer o conjunto inteiro sem guardá-lo na memória.
Pegue a sua chave de APIReferência da API Facebook
  • 0.15¢ por chamada
  • US$ 1,49 por 1.000
  • Aceita um ID de página ou um companyName
  • Erros e tempos esgotados não são cobrados

A chamada

Um GET, e anúncios da empresa 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-company?pageId=1234567890" \
  -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 anúncios da empresa 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 pageId, companyName. pageId ou companyName é obrigatório

pageIdstring1234567890

Identificador de uma resposta anterior.

companyNamestringvalue

The companyName parameter.

countrystringEstados Unidos

Código de região/país de duas letras, por exemplo US.

statusstringALL

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

languagestringen

Código de idioma de duas letras, por exemplo en.

cursorstring0

Token de paginação da resposta anterior.

media_typestringALL

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

sort_bystringtotal_impressions

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

start_datestring2026-07-01

Filtre por data, no formato YYYY-MM-DD.

end_datestring2026-07-01

Filtre por data, no formato YYYY-MM-DD.

trimbooleantrue

Retornar uma carga reduzida (remove campos detalhados).

Como funciona

Scraping de anúncios da empresa 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 anúncios da empresa 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 anúncios da empresa do Facebook

Respondido antes de você perguntar.

A referência

Envie uma requisição HTTPS autenticada ao endpoint de Anúncios da empresa do Facebook com um ID de página ou um companyName e a sua chave de API da HProxy. Puxe todos os anúncios que uma empresa está rodando no Facebook agora, com criativos, texto, formato, faixa de gasto e há quanto tempo cada um roda. 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.

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.

Um objeto JSON estruturado com todos os dados de anúncios da empresa 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.

Sim. A resposta traz um cursor; passe-o de volta na próxima chamada para continuar de onde parou. Cada página é uma chamada cobrável, então você só paga pela profundidade que realmente puxa.

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.

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 Anúncios da empresa do Facebook

O que o endpoint Anúncios da empresa de Facebook retorna

Puxe todos os anúncios que uma empresa está rodando no Facebook agora, com criativos, texto, formato, faixa de gasto e há quanto tempo cada um roda. 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 anúncios da empresa no Facebook contém.

O que você envia para a API Anúncios da empresa de Facebook

A chamada precisa de um ID de página ou um companyName, e qualquer um entre pageIde companyName basta. Opcional: pageId, companyName, country, status, language, cursor, media_type, sort_by, start_date, end_datee trim. 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 Busca na biblioteca de anúnciose Google Anúncios da empresa na biblioteca de anúncios. 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 anúncios da empresa 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.