API para Facebook

API para Facebook: Detalhes do anúncio

Consulte um único anúncio da Biblioteca de Anúncios da Meta por ID ou URL e receba anunciante, texto do criativo, call to action, plataformas e datas de veiculação em JSON limpo.

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

fMeta Ad Library
facebook.com/ads/library/?id=962050096457659
Meta
United StatesiAll adsSolace Sleep

Solace Sleep

Active · Sponsored

Fall asleep 40% faster with the Solace weighted blanket. Engineered with glass microbeads for even pressure all night. Ships free, try it for 100 nights.

video

solacesleepco.com

Free shipping. 100 night trial. Financing available.

Shop Now
Library ID: 962050096457659FBIGMSG

Ad details

Status
Active
Started running on
September 15, 2025
Platforms
facebook, instagram, messenger
Library ID
962050096457659
O que a API retornou
{
"adArchiveId": "962050096457659",
"sourceUrl": "https://www.facebook.com/ads/library/?id=962050096457659",
"pageId": "104882733481920",
"pageName": "Solace Sleep",
"active": true,
"startDate": 1757894400,
"endDate": null,
"currency": "USD",
... 17 campos a mais
}
Disponibilidade
99,27%
30d · 13.156 chamadas
Requisições
13.159
30d · semanal, últimas 12 sem.
Resposta
1,5s
mediana · 30d

Preços e provedores

Preços do endpoint Detalhes do anúncio 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$ 12,00
US$ 1,20/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 83 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Detalhes do anúncio 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 25 de 42 campos. Ver todos os campos

{
  "found": true,
  "data": {
    "adArchiveId": "962050096457659",
    "sourceUrl": "https://www.facebook.com/ads/library/?id=962050096457659",
    "pageId": "104882733481920",
    "pageName": "Solace Sleep",
    "active": true,
    "startDate": 1757894400,
    "endDate": null,
    "currency": "USD",
    "text": "Fall asleep 40% faster with the Solace weighted blanket. Engineered with glass microbeads for even pressure all night. Ships free, try it for 100 nights.",
    "title": "The blanket that ends 2am scrolling",
    "ctaText": "Shop Now",
    "linkUrl": "https://solacesleepco.com/weighted-blanket?utm_source=fb",
    "displayFormat": "VIDEO",
    "platforms": [
      "facebook",
      "instagram",
      "messenger"
    ],
    "pageProfilePicture": "https://scontent.fbcdn.net/solace-profile.jpg",
    "caption": "solacesleepco.com",
    "linkDescription": "Free shipping. 100 night trial. Financing available.",
    "pageUrl": "https://www.facebook.com/solacesleepco",
    "pageCategories": [
      "Product/service",
      "Home decor"
    ],
    "pageLikes": 48200,
    "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.

  • idstring

    962050096457659

    ID do anúncio na Biblioteca de Anúncios da Meta (ex.: "702369045530963"). Informe id ou url.

  • urlstring

    URL do anúncio na Biblioteca de Anúncios da Meta (ex.: "https://www.facebook.com/ads/library?id=1185617869915074"). Informe id ou url.

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.

datadata
  • activeboolean

    true

    Whether the ad is currently running.

  • adArchiveIdstring

    962050096457659

    Ad Library archive ID (stable identity). Populated whenever the provider has data for the entity.

  • captionstring

    solacesleepco.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 label. Populated whenever the provider has data for the entity.

  • currencystring

    USD

    Spend currency, may be empty.

  • displayFormatstring

    VIDEO

    Ad creative format. Populated whenever the provider has data for the entity.

  • endDateinteger

    null

    Run end, epoch seconds.

  • isResharedboolean

    false

    Whether the ad creative is a reshare of another post.

  • linkDescriptionstring

    Free shipping. 100 night trial. Financing available.

    Description text shown under the ad's link.

  • linkUrlstring

    https://solacesleepco.com/weighted-blanket?utm_source=fb

    Creative destination URL. 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

    104882733481920

    Advertiser page ID (stable identity). Populated whenever the provider has data for the entity.

  • pageLikesinteger

    48200

    Like count of the advertising page.

  • pageNamestring

    Solace Sleep

    Advertiser page name. Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

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

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

  • pageUrlstring

    https://www.facebook.com/solacesleepco

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Publisher platforms the ad runs on. Populated whenever the provider has data for the entity.

  • sourceUrlstring

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

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

  • startDateinteger

    1757894400

    Run start, epoch seconds. Populated whenever the provider has data for the entity.

  • textstring

    Fall asleep 40% faster with the Solace weighted blanket. Engineered with glass microbeads for even pressure all night. Ships free, try it for 100 nights.

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

  • titlestring

    The blanket that ends 2am scrolling

    Creative title. Populated whenever the provider has data for the entity.

each creativedata.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.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

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

  • typestring

    One of photo, video, or gif.

  • urlstring

    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

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

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.

Dúvidas frequentes

Sobre o endpoint Detalhes do anúncio da API para Facebook

O endpoint Detalhes do anúncio da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.ad_details. Consulte um único anúncio da Biblioteca de Anúncios da Meta por ID ou URL e receba anunciante, texto do criativo, call to action, plataformas e datas de veiculação em JSON limpo. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,3% das chamadas ao endpoint Detalhes do anúncio da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,5 segundos, em 13.156 chamadas medidas.

Custa a partir de US$ 1,20 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.

Consulte um único anúncio da Biblioteca de Anúncios da Meta por ID ou URL e receba anunciante, texto do criativo, call to action, plataformas e datas de veiculação em JSON limpo. 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,3% das chamadas ao endpoint Detalhes do anúncio da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,5 segundos, em 13.156 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 83 chamadas de Detalhes do anúncio do Facebook a US$ 0,0012 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.ad_details 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.