API para Facebook

API para Facebook: Anúncios da empresa

Liste os anúncios da Biblioteca de Anúncios da Meta que uma empresa está veiculando, por ID da página ou nome da empresa (texto do criativo, formato, 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/?view_all_page_id=1185617869915074
Meta
United StatesiAll adsTrailhead Outdoors

Trailhead Outdoors

AdsAbout

Trailhead Outdoors

Active · Sponsored

Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.

photo

trailheadoutdoors.com

Free returns within 60 days.

Shop Now
Library ID: 1185617869915074FBIG

Trailhead Outdoors

Active · Sponsored

Our down quilt drops to 15F and packs down to the size of a grapefruit. Made for thru hikers who count every ounce.

photo

trailheadoutdoors.com

Ships in 2 to 3 business days.

Shop Now
Library ID: 1092837465210983FBIGMSG
O que a API retornouads[0]
{
"id": "1185617869915074",
"pageId": "281940573310482",
"pageName": "Trailhead Outdoors",
"active": true,
"startDate": 1755302400,
"endDate": 1758758400,
"currency": "USD",
"text": "Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.",
... 18 campos a mais
}
Disponibilidade
99,89%
30d · 442.678 chamadas
Requisições
443.111
30d · semanal, últimas 12 sem.
Resposta
1,5s
mediana · 30d

Preços e provedores

Preços do endpoint Anúncios da empresa da API para Facebook: uma API, 2 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 Anúncios da empresa do Facebook em uma só requisição

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 34 de 46 campos. Ver todos os campos

{
  "found": true,
  "data": {
    "nextCursor": "AbTr8k2m9x1v7c3q",
    "totalResults": 18,
    "ads": [
      {
        "id": "1185617869915074",
        "pageId": "281940573310482",
        "pageName": "Trailhead Outdoors",
        "active": true,
        "startDate": 1755302400,
        "endDate": 1758758400,
        "currency": "USD",
        "text": "Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.",
        "displayFormat": "DCO",
        "platforms": [
          "facebook",
          "instagram"
        ],
        "adCount": 2,
        "pageProfilePicture": "https://scontent.fbcdn.net/trailhead-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/wren-tent-creative-1.jpg",
            "width": 1080,
            "height": 1080
          }
        ],
        "caption": "trailheadoutdoors.com",
        "linkDescription": "Free returns within 60 days.",
        "pageUrl": "https://www.facebook.com/trailheadoutdoors",
        "pageCategories": [
          "Product/service",
          "Outdoor recreation"
        ],
        "pageLikes": 22400,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ],
        "title": "The 3 season tent that packs to a water bottle",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://trailheadoutdoors.com/products/wren-2-tent"
      },
      {
        "id": "1092837465210983",
        "pageId": "281940573310482",
        "pageName": "Trailhead Outdoors",
        "active": true,
        "startDate": 1753488000,
        "endDate": 1759104000,
        "currency": "USD",
        "text": "Our down quilt drops to 15F and packs down to the size of a grapefruit. Made for thru hikers who count every ounce.",
        "displayFormat": "IMAGE",
        "platforms": [
          "facebook",
          "instagram",
          "messenger"
        ],
        "adCount": 1,
        "pageProfilePicture": "https://scontent.fbcdn.net/trailhead-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/trailhead-quilt-creative.jpg",
            "width": 1080,
            "height": 1350
          }
        ],
        "caption": "trailheadoutdoors.com",
        "linkDescription": "Ships in 2 to 3 business days.",
        "pageUrl": "https://www.facebook.com/trailheadoutdoors",
        "pageCategories": [
          "Product/service",
          "Outdoor recreation"
        ],
        "pageLikes": 22400,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ],
        "title": "15F down quilt, packs to a grapefruit",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://trailheadoutdoors.com/products/down-quilt-15f"
      }
    ]
  }
}

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.

  • companyNamestring

    Trailhead Outdoors

    Nome da empresa a buscar (ex.: "nike"). Correspondência exata e sensível a maiúsculas e minúsculas no índice da Biblioteca de Anúncios da Meta; um anunciante sem página indexada retorna found:false.

  • countrystring

    Código de país de duas letras para delimitar os resultados. O padrão é 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.

  • languagestring

    Código de idioma de duas letras para filtrar anúncios (ex.: "EN", "ES", "FR").

  • mediaTypeenum

    Filtro de tipo de mídia do criativo.

  • pageIdstring

    ID da página da empresa na Biblioteca de Anúncios. Informe pageId ou companyName.

  • sortByenum

    recent

    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. O padrão é ACTIVE.

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

    2

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

  • captionstring

    trailheadoutdoors.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

    Call-to-action button label on the ad.

  • ctaTypestring

    SHOP_NOW

    Call-to-action button type on the ad, e.g. "SHOP_NOW".

  • currencystring

    USD

  • displayFormatstring

    DCO

    Populated whenever the provider has data for the entity.

  • endDateinteger

    1758758400

    Epoch seconds.

  • idstring

    1185617869915074

    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

    Free returns within 60 days.

    Description text shown under the ad's link.

  • linkUrlstring

    https://trailheadoutdoors.com/products/wren-2-tent

    Destination URL the ad links to.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    281940573310482

    Populated whenever the provider has data for the entity.

  • pageLikesinteger

    22400

    Like count of the advertising page.

  • pageNamestring

    Trailhead Outdoors

    Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

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

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

  • pageUrlstring

    https://www.facebook.com/trailheadoutdoors

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Populated whenever the provider has data for the entity.

  • startDateinteger

    1755302400

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

  • textstring

    Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.

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

  • titlestring

    The 3 season tent that packs to a water bottle

    Headline of the ad creative.

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/wren-tent-creative-1.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

    AbTr8k2m9x1v7c3q

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

  • totalResultsinteger

    18

    Total number of ads Facebook reports for the page.

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

O endpoint Anúncios da empresa da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.company_ads. Liste os anúncios da Biblioteca de Anúncios da Meta que uma empresa está veiculando, por ID da página ou nome da empresa (texto do criativo, formato, plataformas e datas de veiculação), com paginação por cursor. A AnyAPI distribui cada requisição entre 2 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,9% das chamadas ao endpoint Anúncios da empresa da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,5 segundos, em 442.678 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.

Liste os anúncios da Biblioteca de Anúncios da Meta que uma empresa está veiculando, por ID da página ou nome da empresa (texto do criativo, formato, 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,9% das chamadas ao endpoint Anúncios da empresa da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,5 segundos, em 442.678 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 Anúncios da empresa do Facebook a US$ 0,0011 cada.

A AnyAPI consulta a próxima das suas 2 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.company_ads 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.Busca de anúnciosa partir de US$ 1,10 /mil req.Respostas a comentáriosa partir de US$ 1,20 /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.