Que dados posso obter?
Anúncios publicados com todos os detalhes do imóvel descritos na referência; o Insights agregado chega em breve no Advanced. Nenhum dado de anunciante, corretor de imóveis, proprietário ou solicitação é devolvido.
GET /v1/properties devolve uma página de anúncios publicados de um país coberto pela sua chave. Cada anúncio traz estes campos:
- id, country, listing_type e property_type
- province, province_id, city, city_id, area, area_id, address e post_code
- latitude, longitude e location_precision
- price, price_max e currency
- bedrooms, bathrooms e rooms
- living_area e living_area_sqm, lot_area e lot_area_sqm
- build_year, published_date e last_updated
- features, appliances, neighbourhood e tags
- developer, summary, description e location_text
- images (imagens)
As descrições são texto simples, sem dados de contato. Imóveis anunciados pelos próprios proprietários são devolvidos com localização aproximada e sem número na rua, e location_precision informa a precisão de cada localização. No momento, os anúncios vêm sem imagens: o campo images é uma lista vazia até que os links das imagens sejam adicionados.
Nenhum endpoint devolve dados de anunciante, corretor de imóveis, proprietário ou solicitação, em nenhum nível. Os nomes dos campos são idênticos em todos os idiomas, e a referência informa o tipo de cada um.