Uma busca de imóveis no Zillow,
como linhas com coordenadas.

Duas coisas nesta exportação
mordem em silêncio.

As colunas são diretas. Dois dos comportamentos delas não são, e ambos são do tipo que produz uma resposta errada em vez de um erro.

A primeira é que home_type está sempre vazia. Ela fica na linha de cabeçalho e não traz nada em nenhuma linha que temos. O que faz disso um parágrafo e não uma nota de rodapé é que a informação não está faltando - ela está na coluna errada. status volta como House for sale, Townhouse for sale, Condo for sale, então o tipo do imóvel está bem ali, colado à situação do anúncio. Se você precisa do tipo como campo, extraia-o de status; não espere home_type encher.

A segunda é que esta exportação mistura dois tipos de linha, e url é o que os distingue. Uma linha /homedetails/ é um imóvel individual: zpid é um id numérico do Zillow, status é uma situação de anúncio, e preço, quartos, banheiros, área e zestimate vêm preenchidos. Uma linha /apartments/ é um condomínio de aluguel inteiro, e as três coisas mudam de uma vez - zpid traz um par latitude–longitude em vez de um id, status traz o nome do condomínio em vez de uma situação, e preço, quartos, banheiros, área e zestimate estão todos vazios. Conferimos se esses três sintomas caem exatamente nas mesmas linhas - caem. Separe por url antes de juntar por zpid ou filtrar por status, ou você vai misturar prédios numa tabela de casas sem perceber.

Fora essas duas, a formatação é previsível. price, zestimate e sqft são cadeias de dígitos puros - 340000, não US$ 340.000 -, então convertem direitinho mas não trazem moeda nem unidade. beds e baths têm um só dígito no que temos, sem meios banheiros, embora isso possa ser uma propriedade desta amostra e não uma garantia. latitude e longitude vêm preenchidas em todo lugar, e é isso que salva as linhas de condomínio: mesmo quando o id é inútil, a linha ainda vai para o mapa. Tudo é texto exceto position, que só existe no JSON.

query

A busca que você enviou, repetida em cada linha que ela produziu - um nome de lugar como Jacksonville, FL, ou a URL de busca do Zillow que você colou.

address

O endereço do imóvel, em uma linha. Numa linha /homedetails/ ele traz o CEP; numa linha /apartments/ é o endereço do condomínio e em geral não traz.

price

O preço anunciado, como cadeia de dígitos puros - 340000, sem símbolo de moeda e sem separador de milhar. Vazio em toda linha /apartments/, porque um condomínio inteiro não tem um preço único.

beds

Número de quartos, como texto. Um só dígito nas nossas execuções, sem meios valores. Vazio nas linhas /apartments/.

baths

Número de banheiros, mesma forma e mesma ressalva. Não vimos meio banheiro, mas isso pode ser desta amostra e não uma regra - não presuma que a coluna é sempre inteira.

sqft

A área, de novo uma cadeia de dígitos puros sem unidade anexada. Vazio nas linhas /apartments/.

home_type

Vazia em toda linha de toda exportação que temos. A coluna existe no cabeçalho e nunca enche - mas o tipo do imóvel não está realmente faltando, está dentro de status. Veja a nota abaixo.

status

Duas coisas diferentes moram nesta coluna. Numa linha /homedetails/ é uma situação de anúncio com o tipo colado - House for sale, Townhouse for sale, Condo for sale, Sold, Active. Numa linha /apartments/ é, em vez disso, o nome do condomínio de aluguel. Confira url antes de filtrar por isto.

zestimate

A estimativa de valor do próprio Zillow, no mesmo formato de dígitos puros de price. Às vezes ausente em linhas de imóvel e sempre ausente em linhas /apartments/, então trate-a como opcional.

latitude

A latitude do imóvel, como texto. Preenchida em toda linha que temos, inclusive nas de condomínio.

longitude

A longitude, idem. Junto com latitude é o que leva o arquivo direto para um mapa - e é a única chave geográfica que funciona nos dois tipos de linha.

zpid

Nem sempre é um id. Numa linha /homedetails/ este é o id numérico de imóvel do Zillow e serve como chave estável - embora não de largura fixa. Numa linha /apartments/ ele traz, em vez disso, um par latitude–longitude, como 30.195362--81.72241. Dimensione qualquer coluna para ele com folga, e não junte por ele às cegas.

url

O anúncio no Zillow - e a coluna que distingue os dois tipos de linha. /homedetails/ significa imóvel individual; /apartments/ significa condomínio de aluguel. Separe por isto primeiro e o resto do arquivo se comporta.

image

Uma foto do anúncio, no servidor de imagens do Zillow. Preenchida em toda linha que temos.

position

Posição começando em 1 dentro da consulta, na ordem em que o Zillow devolveu o anúncio. Só no JSON - as exportações CSV e XLSX param em catorze colunas.

Duas coisas a saber antes de construir em cima disto. Primeira: home_type nunca enche - mas o tipo não se perde, está dentro de status (House for sale, Condo for sale), então extraia dali. Segunda: o arquivo tem dois tipos de linha e url é o discriminador: linhas /homedetails/ são imóveis individuais com zpid numérico, uma situação de anúncio em status e os campos de preço preenchidos, enquanto linhas /apartments/ são condomínios de aluguel inteiros onde zpid é um par latitude–longitude, status é o nome do condomínio, e preço, quartos, banheiros, área e zestimate estão todos vazios. Esses três sintomas ocorrem exatamente nas mesmas linhas. Além disso: preços e áreas são cadeias de dígitos puros sem símbolos nem separadores, latitude e longitude vêm preenchidas em toda linha, então o arquivo sempre vai para o mapa, e position só existe no JSON - logo uma exportação CSV ou XLSX tem catorze colunas, não quinze.

Os imóveis aqui,
as pessoas ao lado.

Este devolve anúncios. Nossos outros três serviços do Zillow recebem, em vez disso, uma URL de perfil de corretor - e o quarto link é a mesma pergunta em outro mercado.

O que as pessoas perguntam
antes de se cadastrar.

As perguntas que mais ouvimos. Mais alguma coisa? Fale conosco - quem escreve as respostas são humanos, não bots.