# Facebook (páginas públicas)

> Facebook (páginas públicas): Páginas, posts, grupos públicos, eventos e Marketplace.

URL: https://apicultura.app/ferramentas/facebook-publico/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Facebook (páginas públicas) na APIcultura

Acesse Facebook (páginas públicas) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Páginas, posts, grupos públicos, eventos e Marketplace. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Redes (dados públicos)](/catalogo/?cat=social). 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 |
|---|---|---|---|
| `facebook-pagina` | Página pública | R$ 0,02 | `POST /v1/call/facebook-pagina` |
| `facebook-posts-pagina` | Posts de uma página | R$ 0,02 | `POST /v1/call/facebook-posts-pagina` |
| `facebook-contato-pagina` | Contato de uma página | R$ 0,02 | `POST /v1/call/facebook-contato-pagina` |
| `facebook-posts-grupo` | Posts de grupo público | R$ 0,02 | `POST /v1/call/facebook-posts-grupo` |
| `facebook-buscar-eventos` | Buscar eventos | R$ 0,02 | `POST /v1/call/facebook-buscar-eventos` |
| `facebook-marketplace` | Buscar no Marketplace | R$ 0,02 | `POST /v1/call/facebook-marketplace` |

### Página pública (`facebook-pagina`)

Dados de uma página ou perfil público. Preço: R$ 0,02 por chamada.

- `profile` (string, obrigatório), ex.: `nasa`

### Schema de entrada de facebook-pagina

```json
{
  "required": [
    "profile"
  ],
  "properties": {
    "profile": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Posts de uma página (`facebook-posts-pagina`)

Posts recentes de uma página. Preço: R$ 0,02 por chamada.

- `limit` (integer, opcional), ex.: `5`
- `page` (string, obrigatório), ex.: `nasa`

### Schema de entrada de facebook-posts-pagina

```json
{
  "required": [
    "page"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "page": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Contato de uma página (`facebook-contato-pagina`)

Contatos públicos de uma página. Preço: R$ 0,02 por chamada.

- `language` (string, opcional, padrão "en-US")
- `page` (string, obrigatório), ex.: `https://www.facebook.com/joesstonecrab`

### Schema de entrada de facebook-contato-pagina

```json
{
  "required": [
    "page"
  ],
  "properties": {
    "language": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Posts de grupo público (`facebook-posts-grupo`)

Posts de um grupo público. Preço: R$ 0,02 por chamada.

- `sort` (string, opcional)
- `url` (string, obrigatório), ex.: `https://www.facebook.com/groups/1270525996445602/`

### Schema de entrada de facebook-posts-grupo

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "sort": {
      "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
    }
  }
}
```

### Buscar eventos (`facebook-buscar-eventos`)

Busca eventos públicos. Preço: R$ 0,02 por chamada.

- `query` (string, obrigatório), ex.: `music festival`

### Schema de entrada de facebook-buscar-eventos

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

### Buscar no Marketplace (`facebook-marketplace`)

Anúncios do Facebook Marketplace. Preço: R$ 0,02 por chamada.

- `availability` (string, opcional)
- `condition` (string, opcional)
- `dateListed` (string, opcional)
- `deliveryMethod` (string, opcional)
- `lat` (string, obrigatório), ex.: `30.2677`
- `lng` (string, obrigatório), ex.: `-97.7475`
- `priceMax` (integer, opcional, mín. 0), ex.: `500`
- `priceMin` (integer, opcional, mín. 0), ex.: `100`
- `query` (string, obrigatório), ex.: `bike`
- `sort` (string, opcional)

### Schema de entrada de facebook-marketplace

```json
{
  "required": [
    "lat",
    "lng",
    "query"
  ],
  "properties": {
    "availability": {
      "type": "string",
      "maxLength": 2000
    },
    "condition": {
      "type": "string",
      "maxLength": 2000
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "dateListed": {
      "type": "string",
      "maxLength": 2000
    },
    "deliveryMethod": {
      "type": "string",
      "maxLength": 2000
    },
    "lat": {
      "type": "string",
      "maxLength": 2000
    },
    "lng": {
      "type": "string",
      "maxLength": 2000
    },
    "priceMax": {
      "type": "number"
    },
    "priceMin": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

## 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": "facebook-pagina", "input": {"profile":"nasa"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/facebook-pagina \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"profile":"nasa"}'
```

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

## Experimente

Teste no playground interativo: [Facebook (páginas públicas) no playground](/ferramentas/ferramenta.html?slug=facebook-publico). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Facebook (páginas públicas) é marca de seus respectivos donos, citada apenas para identificar a integração.