Biblioteca de Anúncios da Meta (Facebook e Instagram)

Biblioteca de Anúncios da Meta (Facebook e Instagram): Pesquise anúncios por palavra-chave, por anunciante ou Page, ache a Page pelo nome e veja alcance na UE e anúncios políticos.

Atualizado em 05/11/2026.

O que é Biblioteca de Anúncios da Meta (Facebook e Instagram) na APIcultura

Acesse Biblioteca de Anúncios da Meta (Facebook e Instagram) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Pesquise anúncios por palavra-chave, por anunciante ou Page, ache a Page pelo nome e veja alcance na UE e anúncios políticos. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Anúncios. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)	O que faz	Preço por chamada	Rota
`meta-anuncios-do-anunciante`	Anúncios de um anunciante	R$ 0,10	`POST /v1/call/meta-anuncios-do-anunciante`
`meta-anuncios-buscar`	Buscar anúncios por palavra-chave	R$ 0,02	`POST /v1/call/meta-anuncios-buscar`
`meta-anuncios-buscar-alternativa`	Buscar anúncios (alternativa)	R$ 0,02	`POST /v1/call/meta-anuncios-buscar-alternativa`
`meta-anuncio-detalhe`	Detalhe de um anúncio	R$ 0,02	`POST /v1/call/meta-anuncio-detalhe`
`meta-anuncio-criativo`	Criativo completo de um anúncio	R$ 0,05	`POST /v1/call/meta-anuncio-criativo`
`meta-achar-page-por-nome`	Achar a Page pelo nome	R$ 0,02	`POST /v1/call/meta-achar-page-por-nome`
`meta-oficial-buscar`	API oficial: buscar anúncios	R$ 0,01	`POST /v1/call/meta-oficial-buscar`
`meta-oficial-alcance-ue`	Alcance na UE e público	R$ 0,01	`POST /v1/call/meta-oficial-alcance-ue`
`meta-oficial-politicos`	Anúncios políticos e sociais	R$ 0,01	`POST /v1/call/meta-oficial-politicos`

Anúncios de um anunciante (`meta-anuncios-do-anunciante`)

Anúncios ativos de uma Page por ID, nome da empresa, domínio ou URL do Facebook. Roteia entre provedores com alternativa automática. Preço: R$ 0,10 por chamada.

page_id (str, opcional)
company_name (str, opcional)
company_domain (str, opcional)
facebook_url (url, opcional)

Schema de entrada de meta-anuncios-do-anunciante

{
  "required": [],
  "properties": {
    "page_id": {
      "type": "string",
      "maxLength": 2000
    },
    "company_name": {
      "type": "string",
      "maxLength": 2000
    },
    "company_domain": {
      "type": "string",
      "maxLength": 2000
    },
    "facebook_url": {
      "type": "string",
      "format": "url",
      "maxLength": 2000
    }
  }
}

Buscar anúncios por palavra-chave (`meta-anuncios-buscar`)

Anúncios da Biblioteca da Meta que combinam com uma palavra-chave. Preço: R$ 0,02 por chamada.

active_status (string, opcional), ex.: active
country (string, opcional), ex.: US
limit (integer, opcional), ex.: 20
query (string, obrigatório), ex.: running shoes

Schema de entrada de meta-anuncios-buscar

{
  "required": [
    "query"
  ],
  "properties": {
    "active_status": {
      "type": "string",
      "maxLength": 2000
    },
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Buscar anúncios (alternativa) (`meta-anuncios-buscar-alternativa`)

Busca anúncios do Facebook e Instagram por palavra-chave, com filtros. Preço: R$ 0,02 por chamada.

adType (string, opcional)
country (string, opcional), ex.: US
endDate (string, opcional)
mediaType (string, opcional)
query (string, obrigatório), ex.: nike
searchType (string, opcional), ex.: keyword_exact_phrase
sortBy (string, opcional)
startDate (string, opcional)
status (string, opcional, padrão "ACTIVE")

Schema de entrada de meta-anuncios-buscar-alternativa

{
  "required": [
    "query"
  ],
  "properties": {
    "adType": {
      "type": "string",
      "maxLength": 2000
    },
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "endDate": {
      "type": "string",
      "maxLength": 2000
    },
    "mediaType": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "searchType": {
      "type": "string",
      "maxLength": 2000
    },
    "sortBy": {
      "type": "string",
      "maxLength": 2000
    },
    "startDate": {
      "type": "string",
      "maxLength": 2000
    },
    "status": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Detalhe de um anúncio (`meta-anuncio-detalhe`)

Detalhes de um anúncio da biblioteca por ID. Preço: R$ 0,02 por chamada.

id (string, opcional), ex.: 1249043200627555
url (string, opcional)

Schema de entrada de meta-anuncio-detalhe

{
  "required": [],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Criativo completo de um anúncio (`meta-anuncio-criativo`)

Criativo e textos completos de um anúncio. Preço: R$ 0,05 por chamada.

id (string, obrigatório), ex.: 1519158199783790

Schema de entrada de meta-anuncio-criativo

{
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Achar a Page pelo nome (`meta-achar-page-por-nome`)

Encontra páginas do Facebook por nome da empresa, para obter o Page ID. Preço: R$ 0,02 por chamada.

query (string, obrigatório), ex.: nike

Schema de entrada de meta-achar-page-por-nome

{
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Mais 3 endpoints na tabela acima; os parâmetros seguem o input_schema de cada um.

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "meta-anuncios-do-anunciante", "input": {"company_name":"Nike"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/meta-anuncios-do-anunciante \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_name":"Nike"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,10 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam Biblioteca de Anúncios da Meta (Facebook e Instagram)

Experimente

Teste no playground interativo: Biblioteca de Anúncios da Meta (Facebook e Instagram) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Biblioteca de Anúncios da Meta (Facebook e Instagram) é marca de seus respectivos donos, citada apenas para identificar a integração.