API para Facebook

API para Facebook: Detalhes do anúncio (versão completa)

Obtenha um anúncio da Biblioteca de Anúncios da Meta com o criativo: cada variante do carrossel, URLs de imagem e vídeo, título, corpo e call to action.

POST/v1/run/facebook.ad_details_full
Disponibilidade
100,00%
30d · 26 chamadas
Requisições
26
30d · semanal, últimas 12 sem.
Resposta
9,9s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira 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.
{
  "data": {
    "active": true,
    "adArchiveId": "a1b2c3d4",
    "body": "A short example description of this item.",
    "caption": "A short example description of this item.",
    "categories": [
      "example"
    ],
    "creatives": [
      {
        "body": "A short example description of this item.",
        "caption": "A short example description of this item.",
        "ctaText": "A short example description of this item.",
        "ctaType": "general",
        "image": "https://example.com/image.jpg",
        "imageResized": "https://example.com/image.jpg",
        "linkDescription": "https://example.com/page",
        "linkUrl": "https://example.com/page",
        "title": "Example title",
        "videoPreviewImage": "https://example.com/image.jpg",
        "videoUrl": "https://example.com/page"
      }
    ],
    "ctaText": "A short example description of this item.",
    "ctaType": "general",
    "displayFormat": "example",
    "endedUtc": 12.5,
    "images": [
      {
        "image": "https://example.com/image.jpg",
        "imageResized": "https://example.com/image.jpg"
      }
    ],
    "isReshared": true,
    "linkDescription": "https://example.com/page",
    "linkUrl": "https://example.com/page",
    "pageCategories": [
      "example"
    ],
    "pageDeleted": false,
    "pageId": "a1b2c3d4",
    "pageImage": "https://example.com/image.jpg",
    "pageLikes": 12500,
    "pageName": "Example title",
    "pageUrl": "https://example.com/page",
    "platforms": [
      "example"
    ],
    "sourceUrl": "https://example.com/page",
    "startedUtc": 12.5,
    "title": "Example title",
    "videos": [
      {
        "videoPreviewImage": "https://example.com/image.jpg",
        "videoUrl": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface FacebookAdDetailsFullResponse {
  data: {
    active?: boolean;
    adArchiveId: string;
    body?: string;
    caption?: string;
    categories?: string[];
    creatives?: {
      body?: string;
      caption?: string;
      ctaText?: string;
      ctaType?: string;
      image?: string;
      imageResized?: string;
      linkDescription?: string;
      linkUrl?: string;
      title?: string;
      videoPreviewImage?: string;
      videoUrl?: string;
    }[];
    ctaText?: string;
    ctaType?: string;
    displayFormat?: string;
    endedUtc?: number;
    images?: {
      image?: string;
      imageResized?: string;
    }[];
    isReshared?: boolean;
    linkDescription?: string;
    linkUrl?: string;
    pageCategories?: string[];
    pageDeleted?: boolean;
    pageId: string;
    pageImage?: string;
    pageLikes?: number;
    pageName?: string;
    pageUrl?: string;
    platforms?: string[];
    sourceUrl: string;
    startedUtc?: number;
    title?: string;
    videos?: {
      videoPreviewImage?: string;
      videoUrl?: string;
    }[];
  } | 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_full
curl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details_full \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"962050096457659"}'
CampoTipoValor de exemplo
Corpo da requisição
idstring"962050096457659"ID do anúncio na Biblioteca de Anúncios da Meta, o ID numérico em uma URL da Biblioteca de Anúncios (ex.: "962050096457659" de https://www.facebook.com/ads/library/?id=962050096457659).
Resposta
dataobject
data.activebooleanWhether the ad is currently running.
data.adArchiveIdstringAd Library archive ID (stable identity). Populated whenever the provider has data for the entity.
data.bodystringAd body text. Populated whenever the provider has data for the entity.
data.captionstringDisplay caption, usually the destination domain.
data.categoriesstring[]Ad Library categories the ad is filed under.
data.creativesobject[]One entry per creative variant of a carousel or dynamic ad, in the order Meta returns them. Single-creative ads return an empty array and carry their media in images/videos. Meta CDN media URLs are signed and expire, so fetch what you need at read time.
data.creatives[].bodystringVariant body text.
data.creatives[].captionstringVariant display caption.
data.creatives[].ctaTextstringVariant call-to-action label.
data.creatives[].ctaTypestringVariant call-to-action type.
data.creatives[].imagestringOriginal creative image URL.
data.creatives[].imageResizedstringResized creative image URL.
data.creatives[].linkDescriptionstringVariant secondary description.
data.creatives[].linkUrlstringVariant destination URL.
data.creatives[].titlestringVariant headline.
data.creatives[].videoPreviewImagestringPoster frame for the creative video.
data.creatives[].videoUrlstringCreative video URL (HD when supplied, otherwise SD).
data.ctaTextstringCall-to-action label (e.g. "Shop now").
data.ctaTypestringCall-to-action type (e.g. "SHOP_NOW").
data.displayFormatstringAd creative format (e.g. "DPA", "VIDEO", "IMAGE"). Populated whenever the provider has data for the entity.
data.endedUtcnumberRun end, or last-seen date while the ad is still running. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.imagesobject[]Standalone creative images for a single-image ad. Meta CDN media URLs are signed and expire.
data.images[].imagestringOriginal creative image URL.
data.images[].imageResizedstringResized creative image URL.
data.isResharedbooleanWhether the ad creative is a reshare of another post.
data.linkDescriptionstringSecondary link description line.
data.linkUrlstringCreative destination URL.
data.pageCategoriesstring[]Categories Facebook lists the advertising page under.
data.pageDeletedbooleanWhether the advertising page has been deleted.
data.pageIdstringAdvertiser page ID (stable identity). Populated whenever the provider has data for the entity.
data.pageImagestringAdvertiser page profile picture URL. Meta CDN URLs are signed and expire.
data.pageLikesintegerLike count of the advertising page.
data.pageNamestringAdvertiser page name. Populated whenever the provider has data for the entity.
data.pageUrlstringAdvertiser page URL.
data.platformsstring[]Publisher platforms the ad runs on.
data.sourceUrlstringInspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
data.startedUtcnumberRun start. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.titlestringCreative headline. Dynamic-product ads return a template such as "{{product.name}}".
data.videosobject[]Standalone creative videos for a single-video ad. Meta CDN media URLs are signed and expire.
data.videos[].videoPreviewImagestringPoster frame for the creative video.
data.videos[].videoUrlstringCreative video URL (HD when supplied, otherwise SD).
foundboolean
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çãoUSDUS$ 0,00462
Preço /mil req.USDUS$ 4,62

Dúvidas frequentes

Sobre o endpoint Detalhes do anúncio (versão completa) da API para Facebook

O endpoint Detalhes do anúncio (versão completa) da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.ad_details_full. Obtenha um anúncio da Biblioteca de Anúncios da Meta com o criativo: cada variante do carrossel, URLs de imagem e vídeo, título, corpo e call to action. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 4,62 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 (versão completa) da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 9,9 segundos, em 26 chamadas medidas.

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

Obtenha um anúncio da Biblioteca de Anúncios da Meta com o criativo: cada variante do carrossel, URLs de imagem e vídeo, título, corpo e call to action. 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 (versão completa) da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 9,9 segundos, em 26 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

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.Transcrição do anúncioa partir de US$ 1,20 /mil req.Busca de anúnciosa 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,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$ 6,00 /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,20 /mil req.Buscar páginasa partir de US$ 11,18 /mil resultadosBuscar postsa partir de US$ 30,00 /mil req.