BrokerIA Imoveis

Busca imoveis residenciais no catalogo de imobiliarias parceiras da BrokerIA no Brasil. Filtra por cidade, bairro, tipo (casa, apartamento, terreno), faixa de preco, quartos, vagas e area. Retorna lista com foto, endereco aproximado, preco anunciado e id pra consulta de detalhes.

{
  "type": "object",
  "properties": {
    "descricao": {
      "type": "string",
      "description": "Descricao em linguagem natural do imovel desejado"
    },
    "cidade": {
      "type": "string",
      "description": "Cidade. Ex: \"Campinas\""
    },
    "bairro": {
      "type": "string",
      "description": "Bairro"
    },
    "tipo": {
      "type": "string",
      "enum": [
        "apartamento",
        "casa",
        "terreno",
        "comercial",
        "cobertura",
        "studio"
      ]
    },
    "finalidade": {
      "type": "string",
      "enum": [
        "venda",
        "locacao",
        "ambos"
      ],
      "description": "Modalidade comercial: venda, locacao ou ambos. Permuta e condicao da venda."
    },
    "quartos_min": {
      "type": "number",
      "description": "Minimo de quartos"
    },
    "quartos_max": {
      "type": "number",
      "description": "Maximo de quartos"
    },
    "valor_min": {
      "type": "number",
      "description": "Valor minimo em reais"
    },
    "valor_max": {
      "type": "number",
      "description": "Valor maximo em reais"
    },
    "area_min": {
      "type": "number",
      "description": "Area minima em m2"
    },
    "vagas_min": {
      "type": "number",
      "description": "Minimo de vagas"
    },
    "imobiliaria": {
      "type": "string",
      "description": "Slug da imobiliaria. Ex: \"kasamais\""
    },
    "limit": {
      "type": "number",
      "default": 10
    },
    "offset": {
      "type": "number",
      "default": 0
    }
  },
  "required": [
    "descricao"
  ]
}

Retorna os detalhes publicos de um imovel especifico pelo id retornado por uma busca. Inclui fotos, descricao, caracteristicas (quartos, suites, vagas, area), endereco aproximado, preco anunciado e imobiliaria responsavel. Nao calcula financiamento nem avalia elegibilidade em programa de credito.

{
  "type": "object",
  "properties": {
    "imovel_id": {
      "type": "string",
      "description": "UUID do imovel"
    }
  },
  "required": [
    "imovel_id"
  ]
}

Compara de 2 a 4 imoveis lado a lado a partir dos ids retornados pelas buscas. Monta uma tabela com preco anunciado, area, quartos, vagas, bairro, imobiliaria responsavel e preco por metro quadrado. Util pra visualizar trade-offs objetivos. Nao indica qual e o "melhor" — a decisao e do usuario.

{
  "type": "object",
  "properties": {
    "imovel_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 4,
      "description": "Lista de 2 a 4 UUIDs de imoveis retornados pela busca"
    }
  },
  "required": [
    "imovel_ids"
  ]
}

Lista imoveis proximos a um endereco, CEP ou coordenada geografica de referencia. Retorna ate 20 imoveis ordenados por distancia em linha reta, com foto, preco anunciado, caracteristicas basicas e distancia em km. Util pra usuarios que priorizam morar perto de um local especifico (trabalho, escola).

{
  "type": "object",
  "properties": {
    "referencia": {
      "type": "string",
      "description": "Endereco, CEP, nome de bairro ou ponto de referencia (ex: \"Av Paulista 1578\", \"13084-060\")"
    },
    "lat": {
      "type": "number",
      "description": "Latitude (opcional, alternativa a referencia)"
    },
    "lng": {
      "type": "number",
      "description": "Longitude (opcional, alternativa a referencia)"
    },
    "raio_km": {
      "type": "number",
      "default": 5,
      "description": "Raio de busca em km (padrao 5)"
    },
    "limit": {
      "type": "number",
      "default": 10
    }
  }
}

Registra uma SOLICITACAO de visita a um imovel. Requer id do imovel, nome do visitante, telefone ou email, data preferida e periodo (manha/tarde/noite). A solicitacao e enviada pra imobiliaria responsavel, que entra em contato pra confirmar. Nao confirma visita nem reserva horario por conta propria.

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "description": "UUID do imovel (retornado pela busca)"
    },
    "visitor_name": {
      "type": "string",
      "description": "Nome completo do visitante"
    },
    "contact": {
      "type": "object",
      "description": "Pelo menos um meio de contato obrigatorio (phone ou email)",
      "properties": {
        "phone": {
          "type": "string",
          "description": "Telefone com DDD (ex: \"11999887766\")"
        },
        "email": {
          "type": "string",
          "format": "email"
        }
      }
    },
    "preferred_date": {
      "type": "string",
      "format": "date",
      "description": "Data preferida YYYY-MM-DD"
    },
    "preferred_period": {
      "type": "string",
      "enum": [
        "manha",
        "tarde",
        "noite"
      ],
      "description": "Periodo do dia"
    },
    "notes": {
      "type": "string",
      "description": "Observacoes opcionais"
    }
  },
  "required": [
    "property_id",
    "visitor_name",
    "contact",
    "preferred_date",
    "preferred_period"
  ]
}

Apresenta uma estimativa educacional, em intervalo (minimo e maximo), do valor de parcela mensal de referencia pra um imovel residencial no Brasil, calculada a partir de parametros medios publicos (taxa de juros media divulgada, prazo informado, entrada informada). Nao e cotacao, nao e pre-aprovacao, nao consulta bureau de credito, nao classifica em programa habitacional. NAO substitui analise de correspondente bancario autorizado pelo Banco Central do Brasil. [EN] Educational reference range (min-max) for a monthly real estate payment in Brazil, based on public average parameters. Not a quote, not a pre-approval, no credit bureau check. Does NOT substitute analysis by a Bacen-authorized banking correspondent.

{
  "type": "object",
  "properties": {
    "valor_imovel_brl": {
      "type": "number",
      "minimum": 1,
      "maximum": 5000000,
      "description": "Valor do imovel em reais (max R$ 5 milhoes)"
    },
    "renda_familiar_brl": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000,
      "description": "Renda familiar mensal em reais (max R$ 100 mil)"
    },
    "primeiro_imovel": {
      "type": "boolean",
      "description": "Se e o primeiro imovel da familia"
    },
    "idade": {
      "type": "integer",
      "minimum": 18,
      "maximum": 80,
      "description": "Idade do proponente principal"
    },
    "entrada_brl": {
      "type": "number",
      "minimum": 0,
      "default": 0
    },
    "prazo_meses": {
      "type": "integer",
      "minimum": 60,
      "maximum": 420,
      "default": 360
    },
    "valor_fgts_brl": {
      "type": "number",
      "minimum": 0,
      "default": 0,
      "description": "Valor de FGTS a usar (em reais, nao boolean)"
    },
    "fgts_acima_36_meses": {
      "type": "boolean",
      "default": false
    },
    "estado": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "default": "SP"
    },
    "cidade": {
      "type": "string",
      "default": ""
    },
    "dependentes": {
      "type": "boolean",
      "default": false
    },
    "tipo_imovel": {
      "type": "string",
      "enum": [
        "novo",
        "usado"
      ],
      "default": "novo"
    },
    "sistema_amortizacao": {
      "type": "string",
      "enum": [
        "sac",
        "price"
      ],
      "default": "sac"
    },
    "modalidade_indexador": {
      "type": "string",
      "enum": [
        "tr_plus",
        "poupanca_plus"
      ],
      "default": "tr_plus"
    }
  },
  "required": [
    "valor_imovel_brl",
    "renda_familiar_brl",
    "primeiro_imovel",
    "idade"
  ],
  "additionalProperties": false
}

Estima um intervalo educacional de valor de imovel que poderia caber na renda mensal informada (criterio de comprometimento medio publico ~30%). NAO e uma cotacao, NAO e uma pre-aprovacao, NAO consulta seu historico de credito, NAO determina aprovacao. Opcionalmente conta quantos imoveis do catalogo BrokerIA cabem no intervalo na cidade informada. Use ANTES de buscar imoveis para ajudar o usuario a definir uma faixa de preco realista.

{
  "type": "object",
  "properties": {
    "renda_familiar_brl": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000,
      "description": "Renda familiar mensal em reais (max R$ 100 mil)"
    },
    "entrada_brl": {
      "type": "number",
      "minimum": 0,
      "default": 0,
      "description": "Entrada disponivel em reais"
    },
    "idade": {
      "type": "integer",
      "minimum": 18,
      "maximum": 80
    },
    "primeiro_imovel": {
      "type": "boolean"
    },
    "cidade": {
      "type": "string",
      "description": "Cidade de interesse (opcional). Se informada, conta quantos imoveis do catalogo cabem no intervalo."
    },
    "valor_fgts_brl": {
      "type": "number",
      "minimum": 0,
      "default": 0
    },
    "fgts_acima_36_meses": {
      "type": "boolean",
      "default": false
    },
    "dependentes": {
      "type": "boolean",
      "default": false
    },
    "tipo_imovel": {
      "type": "string",
      "enum": [
        "novo",
        "usado"
      ],
      "default": "novo"
    }
  },
  "required": [
    "renda_familiar_brl",
    "entrada_brl",
    "idade",
    "primeiro_imovel"
  ],
  "additionalProperties": false
}

Retorna estatisticas agregadas do catalogo de imobiliarias parceiras da BrokerIA para uma cidade (ou cidade+bairro): total de imoveis disponiveis, precos em percentis (25/50/75), distribuicao por tipo e por numero de quartos, quantidade de imobiliarias parceiras atuantes na regiao. Util pra orientar o usuario sobre faixa de preco tipica e oferta antes de uma busca.

{
  "type": "object",
  "properties": {
    "cidade": {
      "type": "string",
      "minLength": 2,
      "description": "Nome da cidade (ex: \"Joao Pessoa\")"
    },
    "bairro": {
      "type": "string",
      "description": "Nome do bairro (opcional). Se omitido, retorna stats da cidade inteira."
    }
  },
  "required": [
    "cidade"
  ],
  "additionalProperties": false
}