Facebook (páginas públicas)

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

Atualizado em 05/11/2026.

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). Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

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

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

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

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

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

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

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

{ "name": "call", "arguments": { "slug": "facebook-pagina", "input": {"profile":"nasa"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

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. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

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