O que a API faz

Envie o endereço e as características de um imóvel e receba o valor estimado, a faixa de mínimo e máximo, o preço do m² e uma nota de confiança. Depois, consulte as avaliações da sua conta e baixe o laudo em PDF.

É a mesma conta do laudo da home: compara com imóveis parecidos da mesma rua, do bairro e da cidade. O método está em Como funciona.

Aceita apartamento, casa e lote. Cada chamada devolve a avaliação concluída ou um erro que diz o motivo.

Primeira chamada

Autentique com o cabeçalho X-API-Key. A chave aparece uma única vez, no momento em que é criada.

POST https://datam2.com.br/api/v1/b2b/valuations/

curl -X POST "https://datam2.com.br/api/v1/b2b/valuations/" \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "Quadra 104 Norte, Alameda 5, Lote 10",
    "city": "Palmas",
    "state": "TO",
    "property_type": "apartment",
    "area": 80,
    "bedrooms": 2,
    "bathrooms": 1,
    "parking_spots": 1
  }'

A resposta tem status 201 e este formato:

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "failure_reason": null,
  "origin": "api",
  "address": "Quadra 104 Norte, Alameda 5, Lote 10",
  "neighborhood": "Plano Diretor Norte",
  "city": "Palmas",
  "state": "TO",
  "property_type": "apartment",
  "area": 80,
  "bedrooms": 2,
  "estimated_value": 450000,
  "min_value": 420000,
  "max_value": 480000,
  "price_per_sqm": 5625,
  "confidence_score": 85.5,
  "comparables_count": 34,
  "created_at": "2026-10-11T10:30:00.123456-03:00",
  "links": {
    "self": "/api/v1/b2b/valuations/550e8400-e29b-41d4-a716-446655440000/",
    "pdf": "/api/v1/b2b/valuations/550e8400-e29b-41d4-a716-446655440000/pdf/"
  }
}

400: Dados inválidos ou avaliação não concluída; o corpo traz o motivo e, quando há, o code (ex.: no_comparables).
401: Chave ausente, inválida, expirada ou revogada.
402: O contrato desconta laudos e a conta não tem nenhum (no_laudos). Compre um pacote no painel.
403: Chave de produção sem contrato (production_by_contract). Fale com a gente para liberá-la.
429: Limite de avaliações excedido (rate_limited); retry_after diz quanto esperar.

O que a chave faz

Todas as rotas usam o mesmo cabeçalho X-API-Key e valem para as avaliações da sua conta: as pedidas pela API e as feitas no painel.

POST/api/v1/b2b/valuations/: Avalia um imóvel. Conta no limite e, se o contrato desconta laudos, gasta 1 laudo por avaliação concluída.
GET/api/v1/b2b/valuations/: Lista as avaliações da conta, as mais recentes primeiro. Aceita ?status= e ?page=&page_size= (até 100).
GET/api/v1/b2b/valuations/{uuid}/: Uma avaliação, com a confiança, a base dos dados e os imóveis comparáveis usados na conta.
GET/api/v1/b2b/valuations/{uuid}/pdf/: O laudo em PDF, o mesmo do painel. Só para avaliação concluída (409 nas outras).

Ambiente de teste

Toda conta pode criar chaves de teste, que começam com dm2_sk_test_. Com elas a entrada é validada de verdade, mas a resposta é fixa: a área vezes um preço por m² fixo para cada tipo de imóvel. Não custa nada, não gasta laudo e não grava avaliação.

O valor do ambiente de teste não é avaliação de mercado. A resposta traz "sandbox": true e o cabeçalho X-Sandbox: true para o seu sistema saber a diferença. Como a avaliação de teste não é gravada, os links dela não abrem; a lista, o detalhe e o PDF lidos com a chave de teste são os das avaliações reais da conta.

Para testar como o seu sistema trata cada erro, inclua uma destas marcas no endereço:

sandbox:sem-comparaveis: 400. A base não tem imóveis parecidos o bastante (no_comparables).
sandbox:sem-saldo: 402. O contrato desconta laudos e a conta não tem nenhum (no_laudos).
sandbox:limite: 429. O limite de avaliações estourou (rate_limited).

Como contratar

A chave de produção, que começa com dm2_sk_live_, é liberada por contrato: a equipe a cria na sua conta, com as condições combinadas, e você a recebe uma única vez. O contrato define:

Limites

Avaliações por hora, por dia e por mês

Do tamanho do seu uso. Listar, detalhar e baixar o PDF não contam no limite.

Cobrança

Por laudo ou faturada à parte

Por laudo: cada avaliação concluída desconta 1 laudo da sua conta, comprado em pacotes no painel. Ou o uso é faturado à parte, pelo contrato. Avaliação que não conclui não desconta nada.

Validade

Por prazo ou sem expiração

A chave pode ser revogada a qualquer momento (segredo vazado, fim do contrato) e uma nova é emitida.

Para contratar, ou para tirar dúvida de integração:

WhatsApp: (63) 98144-3726
E-mail: contato@datam2.com.br

Chamar no WhatsApp Entender o método

Como começar

Crie sua conta. É grátis e não pede cartão.
Crie uma chave de teste. No painel, em API. Copie o segredo na hora: ele não é mostrado de novo.
Integre com a chave de teste. Ela responde com valor fixo, sem custo. Use o exemplo acima e as marcas de erro do ambiente de teste.
Fale com a gente para ir a produção. Combinamos os limites e a cobrança, e a equipe cria a chave de produção na sua conta. O endereço e o formato das chamadas são os mesmos: só troca a chave.

Criar conta Abrir meu painel de API