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

URL: https://apicultura.app/ferramentas/meta-biblioteca-anuncios/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=anuncios). 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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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:

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

## Exemplo de chamada HTTP

```bash
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)

- [Minerador de ofertas: ache os anúncios que já funcionam no seu nicho](/workflows/minerador-de-ofertas/)
- [Espionar um concorrente: anúncios ativos e criativos a partir do nome](/workflows/espionar-concorrente/)

## Experimente

Teste no playground interativo: [Biblioteca de Anúncios da Meta (Facebook e Instagram) no playground](/ferramentas/ferramenta.html?slug=meta-biblioteca-anuncios). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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