API para Facebook

API para Facebook: Busca de anúncios

Busque na Biblioteca de Anúncios da Meta por palavra-chave e receba os anúncios correspondentes (anunciante, texto do criativo, CTA, plataformas e datas de veiculação) com paginação por cursor.

Comece grátisBaixar amostraou JSON

US$ 1,10/mil req., pague por requisição, sem assinatura.

fMeta Ad Library
facebook.com/ads/library/?q=protein%20powder
Meta
United StatesiAll adsprotein powder

~214 results

Vantage Nutrition

Active · Sponsored

20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.

photo

vantagenutrition.com

Subscribe and save 20%. Cancel anytime.

Shop Now
Library ID: 705513298640217FBIG

PureForm Labs

Active · Sponsored

Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.

video

pureformlabs.com

Free shipping on orders over $40.

Learn More
Library ID: 592047718834105FBIGMSG
O que a API retornouads[0]
{
"id": "705513298640217",
"sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
"pageId": "398201744920331",
"pageName": "Vantage Nutrition",
"active": true,
"startDate": 1756512000,
"endDate": 1758758400,
"text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
... 18 campos a mais
}
Disponibilidade
99,20%
30d · 384.018 chamadas
Requisições
388.167
30d · semanal, últimas 12 sem.
Resposta
1,7s
mediana · 30d

Preços e provedores

Preços do endpoint Busca de anúncios da API para Facebook: uma API, 4 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Você paga
US$ 11,00
US$ 1,10/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 90 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Busca de anúncios do Facebook em uma só requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `totalResults`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um anúncio que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.

Este exemplo mostra 35 de 46 campos. Ver todos os campos

{
  "found": true,
  "data": {
    "totalResults": 214,
    "nextCursor": "AQHRZ9d3f2k7m1x8c",
    "ads": [
      {
        "id": "705513298640217",
        "sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
        "pageId": "398201744920331",
        "pageName": "Vantage Nutrition",
        "active": true,
        "startDate": 1756512000,
        "endDate": 1758758400,
        "text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
        "title": "Protein that doesn't taste like chalk",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://vantagenutrition.com/protein",
        "displayFormat": "IMAGE",
        "platforms": [
          "facebook",
          "instagram"
        ],
        "adCount": 3,
        "pageProfilePicture": "https://scontent.fbcdn.net/vantage-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg",
            "width": 1080,
            "height": 1080
          }
        ],
        "caption": "vantagenutrition.com",
        "linkDescription": "Subscribe and save 20%. Cancel anytime.",
        "pageUrl": "https://www.facebook.com/vantagenutrition",
        "pageCategories": [
          "Product/service",
          "Health/beauty"
        ],
        "pageLikes": 61300,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ]
      },
      {
        "id": "592047718834105",
        "sourceUrl": "https://www.facebook.com/ads/library/?id=592047718834105",
        "pageId": "711029384710556",
        "pageName": "PureForm Labs",
        "active": true,
        "startDate": 1757203200,
        "endDate": 1759363200,
        "text": "Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.",
        "title": "25g of plant protein, zero bloat",
        "ctaText": "Learn More",
        "ctaType": "LEARN_MORE",
        "linkUrl": "https://pureformlabs.com/plant-protein",
        "displayFormat": "VIDEO",
        "platforms": [
          "facebook",
          "instagram",
          "messenger"
        ],
        "adCount": 1,
        "pageProfilePicture": "https://scontent.fbcdn.net/pureform-profile.jpg",
        "media": [
          {
            "type": "video",
            "url": "https://scontent.xx.fbcdn.net/v/t42.1790-2/pureform-protein-poster.jpg",
            "videoUrl": "https://video.xx.fbcdn.net/v/t42.9040-2/pureform-protein-ad.mp4",
            "width": 1080,
            "height": 1350
          }
        ],
        "caption": "pureformlabs.com",
        "linkDescription": "Free shipping on orders over $40.",
        "pageUrl": "https://www.facebook.com/pureformlabs",
        "pageCategories": [
          "Product/service",
          "Health/beauty"
        ],
        "pageLikes": 18900,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ]
      }
    ]
  }
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • querystring

    protein powder

    Palavra-chave a buscar na Biblioteca de Anúncios da Meta (ex.: "protein powder").

  • adTypeenum

    Restringe a todos os anúncios (padrão) ou apenas anúncios políticos e sobre temas sociais.

  • countrystring

    US

    Código de país de duas letras para delimitar os resultados. Omita para todos os países.

  • cursorstring

    Cursor de paginação opaco do nextCursor de uma resposta anterior.

  • endDatestring

    Filtra anúncios com impressões nesta data ou antes, no formato YYYY-MM-DD.

  • mediaTypeenum

    Filtro de tipo de mídia do criativo.

  • requireFieldsarray

    Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `totalResults`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um anúncio que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.

  • searchTypeenum

    keyword_exact_phrase

    Modo de correspondência da consulta: palavra-chave flexível (keyword_unordered, o padrão) ou frase exata (keyword_exact_phrase).

  • sortByenum

    Ordenação: impressions (mais impressões primeiro, o padrão) ou recent (mais recentes).

  • startDatestring

    Filtra anúncios com impressões nesta data ou depois, no formato YYYY-MM-DD.

  • statusenum

    Filtro de status do anúncio.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

each addata.ads[]
  • activeboolean

    true

  • adCountinteger

    3

    Number of ads in this campaign (collation count). Null when the source does not report it.

  • captionstring

    vantagenutrition.com

    Caption line of the ad creative, usually the advertiser's display domain.

  • categoriesstring[]

    Ad Library categories the ad is filed under.

  • ctaTextstring

    Shop Now

    Populated whenever the provider has data for the entity.

  • ctaTypestring

    SHOP_NOW

    Populated whenever the provider has data for the entity.

  • displayFormatstring

    IMAGE

    Populated whenever the provider has data for the entity.

  • endDateinteger

    1758758400

    Epoch seconds.

  • idstring

    705513298640217

    Ad Library archive ID. Populated whenever the provider has data for the entity.

  • isResharedboolean

    false

    Whether the ad creative is a reshare of another post.

  • linkDescriptionstring

    Subscribe and save 20%. Cancel anytime.

    Description text shown under the ad's link.

  • linkUrlstring

    https://vantagenutrition.com/protein

    Populated whenever the provider has data for the entity.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    398201744920331

    Populated whenever the provider has data for the entity.

  • pageLikesinteger

    61300

    Like count of the advertising page.

  • pageNamestring

    Vantage Nutrition

    Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

    https://scontent.fbcdn.net/vantage-profile.jpg

    Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.

  • pageUrlstring

    https://www.facebook.com/vantagenutrition

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Populated whenever the provider has data for the entity.

  • sourceUrlstring

    https://www.facebook.com/ads/library/?id=705513298640217

    Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.

  • startDateinteger

    1756512000

    Epoch seconds. Populated whenever the provider has data for the entity.

  • textstring

    20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.

    Ad body text. Populated whenever the provider has data for the entity.

  • titlestring

    Protein that doesn't taste like chalk

    Populated whenever the provider has data for the entity.

each creativedata.ads[].creatives[]

One entry per card of a carousel, dynamic-product, or dynamic-creative ad, in the order Meta returns them, each with its own text and destination. Single-creative ads return an empty array. The same card images and videos also appear in media. Meta CDN media URLs are signed and expire.

  • bodystring

    Card body text.

  • captionstring

    Card display caption, usually the destination domain.

  • ctaTextstring

    Card call-to-action label (e.g. "Shop Now").

  • ctaTypestring

    Card call-to-action type (e.g. "SHOP_NOW").

  • imagestring

    Card image URL. For a video card this is the poster frame.

  • linkDescriptionstring

    Card secondary description line.

  • linkUrlstring

    Card destination URL.

  • titlestring

    Card headline.

  • videoUrlstring

    Card video file URL (HD when supplied, otherwise SD). Present only on video cards.

each mediadata.ads[].media[]

Creative attached to the ad: one element per image, video, or carousel card, in the order the ad presents them. Empty when the ad has none.

  • heightinteger

    1080

    Pixel height of the media item, when the lane reports it.

  • typestring

    photo

    One of photo, video, or gif.

  • urlstring

    https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg

    Image URL. For a video or GIF this is the poster/thumbnail frame.

  • videoUrlstring

    Playable video file URL. Present only for video and gif items.

  • widthinteger

    1080

    Pixel width of the media item, when the lane reports it.

datadata
  • nextCursorstring

    AQHRZ9d3f2k7m1x8c

    Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.

  • totalResultsintegerpode ser exigido

    214

    Total number of ads matching the search. Null when the source cannot report an exact count.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Vende esta API? Veja o schema completo que o seu endpoint precisa retornar.

Dúvidas frequentes

Sobre o endpoint Busca de anúncios da API para Facebook

O endpoint Busca de anúncios da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.ads_search. Busque na Biblioteca de Anúncios da Meta por palavra-chave e receba os anúncios correspondentes (anunciante, texto do criativo, CTA, plataformas e datas de veiculação) com paginação por cursor. A AnyAPI distribui cada requisição entre 4 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,2% das chamadas ao endpoint Busca de anúncios da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,7 segundos, em 384.018 chamadas medidas.

Custa a partir de US$ 1,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque na Biblioteca de Anúncios da Meta por palavra-chave e receba os anúncios correspondentes (anunciante, texto do criativo, CTA, plataformas e datas de veiculação) com paginação por cursor. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,2% das chamadas ao endpoint Busca de anúncios da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,7 segundos, em 384.018 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 90 chamadas de Busca de anúncios do Facebook a US$ 0,0011 cada.

A AnyAPI consulta a próxima das suas 4 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/facebook.ads_search com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.
Mais para chamar

Outros endpoints de Facebook

Perfila partir de US$ 1,20 /mil req.Posts do perfila partir de US$ 1,20 /mil req.Posta partir de US$ 1,20 /mil req.Comentários do posta partir de US$ 1,20 /mil req.Reels do perfila partir de US$ 1,20 /mil req.Detalhes do anúncioa partir de US$ 1,20 /mil req.Detalhes do anúncio (versão completa)a partir de US$ 3,74 /mil req.Transcrição do anúncioa partir de US$ 1,20 /mil req.Respostas a comentáriosa partir de US$ 1,20 /mil req.Anúncios da empresaa partir de US$ 1,10 /mil req.Detalhes do eventoa partir de US$ 1,20 /mil req.Eventosa partir de US$ 1,20 /mil req.Busca de eventosa partir de US$ 1,20 /mil req.Seguidoresa partir de US$ 3,15 /mil resultadosPosts do grupoa partir de US$ 1,20 /mil req.Marketplacea partir de US$ 1,20 /mil req.Item do Marketplacea partir de US$ 1,20 /mil req.Busca de localização no Marketplacea partir de US$ 1,20 /mil req.Contato da páginaa partir de US$ 1,20 /mil req.Consultar páginaa partir de US$ 9,75 /mil req.Fotosa partir de US$ 1,20 /mil req.Transcrição do posta partir de US$ 1,20 /mil req.Eventos do perfila partir de US$ 1,20 /mil req.Buscar empresasa partir de US$ 1,10 /mil req.Buscar páginasa partir de US$ 9,18 /mil resultadosBuscar postsa partir de US$ 30,00 /mil req.