Entrar Comece grátis

A Nobur, direto no seu sistema

Uma API REST e webhooks assinados para levar imóveis, propostas e contratos ao seu ERP, site ou automação.

  • Incluída em todos os planos
  • REST e JSON
  • Webhooks assinados
$ curl -i "https://api.nobur.com.br/public/v1/brokers?limit=1" \    -H "X-API-Key: $NOBUR_API_KEY"

Resposta

HTTP/2 200content-type: application/jsonx-ratelimit-limit: 300x-ratelimit-remaining: 299x-ratelimit-reset: 1791729180 {  "items": [    {      "id": "brk_7k2m9q4xh3c8vn1tdz5r",      "name": "Helena Duarte",      "creci": "48213-F",      "email": "helena@duarteimoveis.com.br",      "visibility": "organization",      "created_at": "2026-10-08T14:32:10Z",      … mais 5 campos    }  ],  "page_info": {    "has_next_page": true,    "total": 37,    … mais 3 campos  }}

A API em números

  • 100

    itens por lote

  • 24 h

    de idempotência

  • 300/min

    por credencial

  • RFC 9457

    nos erros

  • 1.000+

    chamadas por dia

8 recursos com CRUD, lote e webhooks. Referência na documentação Cotas por plano

Webhooks

Avisamos quando algo muda

Escolha os eventos e receba um POST no seu endpoint, assinado com HMAC-SHA256.

21 eventos
Recurso created updated deleted
broker broker.created broker.updated broker.deleted
property property.created property.updated property.deleted
listing listing.created listing.updated listing.deleted
party party.created party.updated party.deleted
proposal proposal.created proposal.updated proposal.deleted
contract contract.created contract.updated contract.deleted
document document.created document.updated document.deleted

+ webhook.ping no envio de teste

  • Até 5 tentativas
  • Envio de teste com tempo de resposta
  • Histórico de entregas

Duas credenciais, um header

Chave de API para integrações, token pessoal para os seus scripts. As duas vão em X-API-Key.

Dúvidas de quem integra

A API tem custo adicional?

Não. A API está incluída em todos os planos, inclusive no Essencial, que é gratuito.

O plano define só a cota diária de chamadas:

  • Essencial: 1.000
  • Profissional: 10.000
  • Corporativo: 50.000
  • Empresarial: Ilimitado

O uso da própria plataforma não consome essa cota.

Como a API autentica as requisições?

Pelo header X-API-Key, com uma destas credenciais:

  • Chave de API (nbr_): papel e escopos próprios, para integrações entre sistemas
  • Token de acesso pessoal (pat_): age com as permissões de quem o criou

Se a credencial alcança mais de uma organização, informe qual em X-Organization-ID.

Detalhes em Autenticação.

Como sei que um webhook veio da Nobur?

Confira a assinatura antes de processar.

O header X-Webhook-Signature traz sha256= seguido de um HMAC-SHA256 do corpo, calculado com o segredo que a API devolve ao criar o webhook. Calcule o mesmo hash do seu lado e compare.

O que acontece se o meu endpoint estiver fora do ar?

A Nobur tenta de novo.

  • Até 5 tentativas no total
  • A primeira repetição após 1 minuto, dobrando o intervalo até 10 minutos
  • Repete em respostas 5xx, 429 e falhas de conexão; outras respostas 4xx não

Cada entrega fica no histórico do webhook, em GET /webhooks/{id}/deliveries.

Existe SDK ou especificação OpenAPI?

Não há SDK oficial, mas há especificação OpenAPI 3.1.

Ela está publicada em openapi/v1.yaml, e dela dá para gerar um cliente na linguagem que você usa.

Gere a sua primeira chave hoje

Crie a conta, abra as configurações e faça a primeira chamada. Sem cartão de crédito.