Posso filtrar os anúncios?
Sim. GET /v1/properties aceita os filtros listados abaixo. Um parâmetro que não está definido é recusado com invalid_parameter, nunca ignorado silenciosamente.
- country (obrigatório): o código ISO 3166-1 alfa-2 do país, por exemplo TH
- listing_type: all (o padrão), sale ou rent
- property_type: um tipo de imóvel, por exemplo condominium
- province_id, city_id e area_id: um local, pelos identificadores que os anúncios trazem
- city e area: um local, pelo nome, sem diferenciar maiúsculas de minúsculas
- min_price e max_price: uma faixa de preço, na moeda do próprio anúncio
- limit: quantos anúncios uma página contém, até o máximo indicado na referência
- cursor: o next_cursor da página anterior
Use city ou city_id, e area ou area_id, não ambos. Um parâmetro escrito errado ou desconhecido é recusado com invalid_parameter (HTTP 400) em vez de ignorado, para que um erro de digitação não possa devolver silenciosamente uma página sem filtro.