Skip to main content

Informações sobre os Dados de Anúncios

Este documento explica a estrutura e o significado dos dados retornados pelos endpoints da API Adsky, incluindo categorias, status de geolocalização e outros campos importantes.

🏠 Categorias e Subcategorias de Imóveis​

As categorias e subcategorias são utilizadas para identificar o tipo do imóvel anunciado. Nos parâmetros de busca, utilize o property_type como array de integers das categorias desejadas.

Categoria 1: Apartamento​

  • 1: Apartamento Padrão
  • 7: Quitinete
  • 8: Studio
  • 9: Duplex
  • 10: Triplex
  • 11: Flat
  • 12: Loft
  • 22: Cobertura

Categoria 2: Casa​

  • 2: Casa Padrão
  • 13: Casa Geminada
  • 14: Casa em Condomínio

Categoria 3: Terreno​

  • 3: Terreno Padrão

Categoria 4: Sobrado​

  • 4: Sobrado Padrão
  • 15: Sobrado Geminado
  • 16: Sobrado em Condomínio

Categoria 5: Comercial​

  • 5: Sala Comercial
  • 17: Ponto
  • 18: Loja
  • 19: Conjunto
  • 20: Laje
  • 21: Sobreloja
  • 23: Casa Comercial

Categoria 6: Barracão​

  • 6: Barracão Padrão

Categoria 7: Rural​

  • 24: Rural Padrão
  • 25: Sítio
  • 26: Fazenda
  • 27: Chácara
  • 28: Rancho

Exemplo de uso:

{
  "property_type": [1, 2],
  "lat": -23.5505,
  "lon": -46.6333
}

📍 Status de Geolocalização​

O campo geo_process_address_status indica a qualidade da geolocalização do endereço do imóvel. Quanto menor o número, maior a precisão.

Status 1: Endereço Completo​

  • Descrição: Geolocalização a partir de um endereço completo (rua e número)
  • Qualidade: Máxima precisão
  • Condição: Cidade, rua e número encontrados e validados com sucesso

Status 2: Reverse/Coordenadas​

  • Descrição: Geolocalização a partir de latitude e longitude
  • Qualidade: Alta precisão
  • Condição: Baseado em coordenadas fornecidas, com endereço próximo validado

Status 3: Sem Número Específico​

  • Descrição: Geolocalização a partir de um logradouro, sem o número
  • Qualidade: Boa precisão
  • Condição: Rua identificada, mas número não encontrado ou não fornecido

Status 4: Apenas Bairro​

  • Descrição: Geolocalização a partir de um bairro
  • Qualidade: Precisão moderada
  • Condição: Apenas cidade e bairro disponíveis

Status 5: Indefinido​

  • Descrição: Processo de geolocalização não retornou resultados precisos
  • Qualidade: Baixa precisão
  • Condição: Não foi possível determinar localização confiável

Status 6: Apenas CEP​

  • Descrição: Geolocalização a partir de um CEP
  • Qualidade: Precisão moderada
  • Condição: Apenas cidade e CEP disponíveis

Status 7: Endereço Próximo​

  • Descrição: Endereço próximo localizado (usado principalmente para IPTU)
  • Qualidade: Precisão aproximada
  • Condição: Endereço exato não encontrado, usado endereço próximo

Status 8: Centro da Cidade​

  • Descrição: Plotado no centro da cidade
  • Qualidade: Baixa precisão
  • Condição: Usado para propriedades rurais sem endereço específico

💰 Dados Financeiros​

Preços de Transação​

  • transaction_sale: Valor de venda do imóvel
  • transaction_rent: Valor de aluguel (pode ser null)

Preços por Metro Quadrado​

  • sqrmeter_price_area_sale: Preço por m² da área útil para venda
  • sqrmeter_price_totalarea_sale: Preço por m² da área total para venda

📏 Dados de Área​

  • area: Área útil do imóvel em metros quadrados
  • total_area: Área total do imóvel em metros quadrados

🏡 Características do Imóvel​

  • features_bedroom: Número de quartos
  • features_bathroom: Número de banheiros
  • features_garage: Número de vagas de garagem
  • features_suite: Número de suítes (disponível apenas em alguns registros)

📅 Dados Temporais​

  • age: Idade do anúncio em dias (não do imóvel)
  • created_at: Data de criação do anúncio (formato ISO 8601)
  • updated_at: Data da última atualização (formato ISO 8601)

🔗 Identificadores e Links​

  • realty_id: ID único do imóvel
  • link_key: Chave única do link do anúncio
  • link: URL do anúncio original
  • ad_count: Quantidade de anúncios ativos deste mesmo imóvel

📍 Dados de Localização​

  • location_point: Array com coordenadas [longitude, latitude]
  • city_name: Nome da cidade
  • state_name: Nome do estado
  • state_uf: Sigla do estado (ex: SP, RJ)
  • neighborhood_name: Nome do bairro
  • processed_address_formatted: Endereço completo formatado
  • processed_address_street: Nome da rua
  • processed_address_number: Número do endereço

📸 Mídia​

  • photos: Array com URLs das fotos do imóvel

🎯 Índices e Scores​

  • similarity_index: Índice de similaridade (pode ser null)
  • sub_category_id: ID da subcategoria do imóvel

📊 Qualidade dos Dados​

Utilize o geo_process_address_status para filtrar por qualidade de localização:

{
  "address_quality": [1, 2, 3],
  "lat": -23.5505,
  "lon": -46.6333
}

Recomendações:

  • Status 1-3: Alta confiabilidade para análises de localização
  • Status 4-6: Precisão moderada, adequada para análises regionais
  • Status 7-8: Use com cautela, principalmente para visão geral