Imóveis à venda em São Paulo · itbisp.com

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Pedido em linguagem natural, em português: '3 quartos perto do metrô em Pinheiros até 1,8 mi com varanda', 'studio até 500 mil perto da estação Faria Lima', 'casa com quintal e piscina que aceita pet'. Vira filtros por regras; veja termos_entendidos na resposta. Natural-language request (Portuguese)."
    },
    "lat": {
      "type": "number",
      "description": "Latitude do ponto de referência (use com lon e raio_m). Reference point latitude."
    },
    "lon": {
      "type": "number",
      "description": "Longitude do ponto de referência. Reference point longitude."
    },
    "rua": {
      "type": "string",
      "description": "Nome da rua, com ou sem 'Rua'/'Av.': \"Rua dos Pinheiros\". Street name."
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "maxItems": 4,
      "minItems": 4,
      "description": "Caixa [oeste, sul, leste, norte] em graus. Bounding box [west, south, east, north]."
    },
    "tipo": {
      "type": "array",
      "items": {
        "enum": [
          "apartamento",
          "casa",
          "comercial",
          "terreno",
          "outro"
        ],
        "type": "string"
      },
      "description": "Tipos aceitos. Studio/flat/kitnet/cobertura são 'apartamento'; sobrado é 'casa'. Property types."
    },
    "ordem": {
      "enum": [
        "relevancia",
        "menor_preco",
        "maior_preco",
        "menor_m2",
        "maior_area",
        "maior_desconto",
        "mais_recentes",
        "mais_perto"
      ],
      "type": "string",
      "default": "relevancia",
      "description": "Ordem. 'relevancia' põe primeiro preço bom, com foto e confirmado por várias imobiliárias; 'mais_perto' exige lat/lon. Sort order."
    },
    "visao": {
      "type": "array",
      "items": {
        "enum": [
          "reformado",
          "andar_alto",
          "alto_padrao",
          "decorado"
        ],
        "type": "string"
      },
      "description": "Etiquetas estimadas pela foto principal do anúncio (todas valem). Photo-based tags (estimates)."
    },
    "bairro": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Um ou mais bairros, como as pessoas escrevem: [\"Pinheiros\", \"Vila Madalena\"]. Neighborhood names."
    },
    "limite": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "description": "Quantos imóveis devolver (1-20). Results per page."
    },
    "pagina": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Página de resultados. Page number."
    },
    "raio_m": {
      "type": "integer",
      "default": 1000,
      "maximum": 10000,
      "minimum": 100,
      "description": "Raio em metros em torno de lat/lon. Radius in meters."
    },
    "estacao": {
      "type": "string",
      "description": "Estação de metrô/trem/monotrilho mais próxima do imóvel: \"Fradique Coutinho\", \"Faria Lima\". Nearest station name."
    },
    "subtipo": {
      "type": "array",
      "items": {
        "enum": [
          "apartamento",
          "cobertura",
          "studio",
          "casa",
          "casa_condominio"
        ],
        "type": "string"
      },
      "description": "Subtipo estimado pelo anúncio: cobertura, studio, casa_condominio (casa em condomínio fechado)... Sub-type."
    },
    "area_max": {
      "type": "number",
      "description": "Área máxima em m². Max area (m²)."
    },
    "area_min": {
      "type": "number",
      "description": "Área mínima em m² (privativa/útil do anúncio). Min area (m²)."
    },
    "poligono": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "description": "Anel do polígono como lista de [lon, lat] (GeoJSON). Polygon ring as [lon, lat] pairs."
    },
    "preco_max": {
      "type": "number",
      "description": "Preço máximo em reais: 1,5 milhão = 1500000. Max price (BRL)."
    },
    "preco_min": {
      "type": "number",
      "description": "Preço mínimo em reais. Min price (BRL)."
    },
    "reformado": {
      "type": "boolean",
      "description": "Só imóveis reformados, pela foto ou pelo texto do anúncio. Renovated (photo or listing text)."
    },
    "vagas_min": {
      "type": "integer",
      "minimum": 0,
      "description": "Vagas de garagem, no mínimo. Min parking spots."
    },
    "suites_min": {
      "type": "integer",
      "minimum": 0,
      "description": "Suítes, no mínimo. Min suites."
    },
    "metro_max_m": {
      "type": "integer",
      "maximum": 5000,
      "minimum": 100,
      "description": "Distância máxima (metros, em linha reta) até a estação mais próxima. 'Perto do metrô' ≈ 800. Max distance to nearest station in meters."
    },
    "quartos_min": {
      "type": "integer",
      "minimum": 0,
      "description": "Quartos (dormitórios), no mínimo. Min bedrooms."
    },
    "so_preco_bom": {
      "type": "boolean",
      "default": false,
      "description": "Só imóveis com pedido abaixo do mercado (comparados ao mesmo prédio, rua ou bairro e ao pago no ITBI). Only below-market asking prices."
    },
    "um_por_predio": {
      "type": "boolean",
      "description": "Mostra no máximo um imóvel por prédio (o melhor de cada); cada resultado diz quantos outros estão à venda no prédio. One result per building."
    },
    "caracteristicas": {
      "type": "array",
      "items": {
        "enum": [
          "vista",
          "varanda",
          "varanda_gourmet",
          "churrasqueira",
          "piscina",
          "academia",
          "aceita_pet",
          "playground",
          "brinquedoteca",
          "salao_festas",
          "quadra",
          "sauna",
          "espaco_gourmet",
          "portaria_24h",
          "condominio_fechado",
          "closet",
          "lareira",
          "mobiliado",
          "ar_condicionado",
          "escritorio",
          "armarios_planejados",
          "elevador",
          "lavabo",
          "novo_texto",
          "reformado_texto",
          "deposito",
          "gerador"
        ],
        "type": "string"
      },
      "description": "Características que o imóvel precisa ter, lidas do texto e da lista de características dos anúncios (todas valem): vista, varanda, varanda_gourmet, churrasqueira, piscina, academia, aceita_pet, portaria_24h... Listing features (all required)."
    },
    "faixa_avaliacao": {
      "enum": [
        "so_abaixo",
        "ate_mercado",
        "sem_muito_caros"
      ],
      "type": "string",
      "description": "Corta pelo selo de preço: so_abaixo (só abaixo do mercado), ate_mercado (tira os acima do mercado), sem_muito_caros (tira só os 30%+ acima). Price label cut."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "id do imóvel (campo id de buscar_imoveis), ex. im_bae2c52d4cc3. Property id."
    },
    "limite": {
      "type": "integer",
      "default": 12,
      "maximum": 30,
      "minimum": 1,
      "description": "Quantos comparáveis mostrar. How many comparables."
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "id do imóvel devolvido por buscar_imoveis (ex.: im_1217cd8f3590). Property id."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "bairro"
  ],
  "properties": {
    "tipo": {
      "enum": [
        "apartamento",
        "casa",
        "comercial",
        "terreno"
      ],
      "type": "string",
      "default": "apartamento",
      "description": "Tipo de imóvel. Property type."
    },
    "bairro": {
      "type": "string",
      "description": "Nome do bairro: \"Moema\", \"Vila Madalena\". Neighborhood name."
    }
  },
  "additionalProperties": false
}