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.

POST/v1/run/facebook.ad_details

Disponibilidade

100,00%

30d · 63 chamadas

Requisições

30d · semanal, últimas 12 sem.

Resposta

2,5s

mediana · 30d

Preços

Um preço, em dólares

Provedores

Giraffe63 atendidas100,00% de disponibilidade2382ms p50100,00% (63 chamadas)2382ms (63 chamadas)63US$ 1,20/mil req.preço fixo

Teste

Faça sua primeira requisição

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

Abrir emPrompt copiado

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.

{
  "data": {
    "active": true,
    "adArchiveId": "a1b2c3d4",
    "caption": "A short example description of this item.",
    "categories": [
      "example"
    ],
    "ctaText": "A short example description of this item.",
    "currency": "USD",
    "displayFormat": "example",
    "endDate": 42,
    "isReshared": true,
    "linkDescription": "https://example.com/page",
    "linkUrl": "https://example.com/page",
    "media": [
      {
        "height": 42,
        "type": "general",
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page",
        "width": 1024
      }
    ],
    "pageCategories": [
      "example"
    ],
    "pageDeleted": false,
    "pageId": "a1b2c3d4",
    "pageLikes": 12500,
    "pageName": "Example title",
    "pageProfilePicture": "https://example.com/image.jpg",
    "pageUrl": "https://example.com/page",
    "platforms": [
      "example"
    ],
    "sourceUrl": "https://example.com/page",
    "startDate": 42,
    "text": "A short example description of this item.",
    "title": "Example title"
  },
  "found": true,
  "reason": "not_found"
}

Interface da resposta

interface FacebookAdDetailsResponse {
  data: {
    active?: boolean | null;
    adArchiveId: string;
    caption?: string;
    categories?: string[];
    ctaText?: string | null;
    currency?: string | null;
    displayFormat?: string | null;
    endDate?: number | null;
    isReshared?: boolean;
    linkDescription?: string;
    linkUrl?: string | null;
    media?: {
      height?: number;
      type: string;
      url: string;
      videoUrl?: string;
      width?: number;
    }[];
    pageCategories?: string[];
    pageDeleted?: boolean;
    pageId: string;
    pageLikes?: number;
    pageName?: string | null;
    pageProfilePicture?: string;
    pageUrl?: string;
    platforms?: string[] | null;
    sourceUrl: string;
    startDate?: number | null;
    text?: string | null;
    title?: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

Referência

Requisição, resposta e preço

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

POST /v1/run/facebook.ad_details

curl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"962050096457659"}'

Campo	Tipo	Valor de exemplo
Corpo da requisição
id	string	"962050096457659"ID do anúncio na Biblioteca de Anúncios da Meta (ex.: "702369045530963"). Informe id ou url.
url	string	URL do anúncio na Biblioteca de Anúncios da Meta (ex.: "https://www.facebook.com/ads/library?id=1185617869915074"). Informe id ou url.
Resposta
data	object
data.active	boolean	Whether the ad is currently running.
data.adArchiveId	string	Ad Library archive ID (stable identity). Populated whenever the provider has data for the entity.
data.caption	string	Caption line of the ad creative, usually the advertiser's display domain.
data.categories	string[]	Ad Library categories the ad is filed under.
data.ctaText	string	Call-to-action label. Populated whenever the provider has data for the entity.
data.currency	string	Spend currency, may be empty.
data.displayFormat	string	Ad creative format. Populated whenever the provider has data for the entity.
data.endDate	integer	Run end, epoch seconds.
data.isReshared	boolean	Whether the ad creative is a reshare of another post.
data.linkDescription	string	Description text shown under the ad's link.
data.linkUrl	string	Creative destination URL. Populated whenever the provider has data for the entity.
data.media	object[]	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.
data.media[].height	integer	Pixel height of the media item, when the lane reports it.
data.media[].type	string	One of photo, video, or gif.
data.media[].url	string	Image URL. For a video or GIF this is the poster/thumbnail frame.
data.media[].videoUrl	string	Playable video file URL. Present only for video and gif items.
data.media[].width	integer	Pixel width of the media item, when the lane reports it.
data.pageCategories	string[]	Categories Facebook lists the advertising page under.
data.pageDeleted	boolean	Whether the advertising page has been deleted.
data.pageId	string	Advertiser page ID (stable identity). Populated whenever the provider has data for the entity.
data.pageLikes	integer	Like count of the advertising page.
data.pageName	string	Advertiser page name. Populated whenever the provider has data for the entity.
data.pageProfilePicture	string	Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.
data.pageUrl	string	Canonical Facebook URL of the advertising page.
data.platforms	string[]	Publisher platforms the ad runs on. Populated whenever the provider has data for the entity.
data.sourceUrl	string	Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
data.startDate	integer	Run start, epoch seconds. Populated whenever the provider has data for the entity.
data.text	string	Ad body text. Populated whenever the provider has data for the entity.
data.title	string	Creative title. Populated whenever the provider has data for the entity.
found	boolean
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.
Preço
Preço por requisição	USD	US$ 0,0012
Preço /mil req.	USD	US$ 1,20

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 retorna um schema normalizado, seja qual for a fonte que atende. 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, 100,0% das chamadas ao endpoint Detalhes do anúncio da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,5 segundos, em 63 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, 100,0% das chamadas ao endpoint Detalhes do anúncio da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,5 segundos, em 63 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.

Mais para chamar

Outros endpoints de Facebook

Uma chave, uma carteira e
sua primeira chamada de Facebook.

Ganhe ~150 requisições grátis

API para Facebook: Detalhes do anúncio

Um preço, em dólares

Faça sua primeira requisição

Requisição, resposta e preço

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

Quanto custa o endpoint Detalhes do anúncio da API para Facebook?

O que o endpoint Detalhes do anúncio da API para Facebook retorna?

Quão confiável é o endpoint Detalhes do anúncio da API para Facebook?

Outros endpoints de Facebook

Uma chave, uma carteira esua primeira chamada de Facebook.

Uma chave, uma carteira e
sua primeira chamada de Facebook.