Habitação.NET - API do Website (1.0.0)

Download OpenAPI specification:Download

URL: http://www.habitacao.net License: N/A

Documentação da API do website Habitação.NET. Permite obter informação agregada sobre o preço da habitação em Portugal recolhida de anúncios preservados no Arquivo.pt.

Default

Preços de Venda de Imóveis

Lista o histórico de preços de venda para todos os distritos, municípios ou freguesias da região selecionada.

path Parameters

region	string A região (portugal, concelho ou distrito)
id	string O id da região no openstreetmap

Responses

Response samples

Content type

application/json

[{"Aveiro": 955,
"Açores": 1396,
"Beja": 1246,
"Braga": 876,
"Bragança": 792,
"Castelo Branco": 795,
"Coimbra": 1206,
"Faro": 1781,
"Guarda": 810,
"Leiria": 912,
"Lisboa": 1654,
"Madeira": 1443,
"Portalegre": 993,
"Porto": 1104,
"Portugal": 1305,
"Santarém": 1154,
"Setúbal": 1100,
"Viana do Castelo": 1252,
"Vila Real": 1707,
"Viseu": 782,
"time": "200909",
"Évora": 1159
},
{"Aveiro": 917,
"Açores": 910,
"Beja": 1236,
"Braga": 836,
"Bragança": 745,
"Castelo Branco": 1105,
"Coimbra": 1125,
"Faro": 1702,
"Guarda": 812,
"Leiria": 853,
"Lisboa": 1583,
"Madeira": 1611,
"Portalegre": 889,
"Porto": 1095,
"Portugal": 1259,
"Santarém": 1066,
"Setúbal": 1147,
"Viana do Castelo": 1186,
"Vila Real": 856,
"Viseu": 655,
"time": "200910",
"Évora": 1211
},
{"Aveiro": 1017,
"Açores": 1006,
"Beja": 1205,
"Braga": 823,
"Bragança": 784,
"Castelo Branco": 799,
"Coimbra": 1145,
"Faro": 1518,
"Guarda": 798,
"Leiria": 1032,
"Lisboa": 1540,
"Madeira": 1326,
"Portalegre": 823,
"Porto": 1087,
"Portugal": 1238,
"Santarém": 1022,
"Setúbal": 1171,
"Viana do Castelo": 1182,
"Vila Real": 1318,
"Viseu": 933,
"time": "200911",
"Évora": 1098
}
]

Preços de Arrendamento de Imóveis

Lista o histórico de preços de arrendamento para todos os distritos, municípios ou freguesias da região selecionada.

path Parameters

region	string A região (portugal, concelho ou distrito)
id	string O id da região no openstreetmap

Responses

Response samples

Content type

application/json

[{"Aveiro": 955,
"Açores": 1396,
"Beja": 1246,
"Braga": 876,
"Bragança": 792,
"Castelo Branco": 795,
"Coimbra": 1206,
"Faro": 1781,
"Guarda": 810,
"Leiria": 912,
"Lisboa": 1654,
"Madeira": 1443,
"Portalegre": 993,
"Porto": 1104,
"Portugal": 1305,
"Santarém": 1154,
"Setúbal": 1100,
"Viana do Castelo": 1252,
"Vila Real": 1707,
"Viseu": 782,
"time": "200909",
"Évora": 1159
},
{"Aveiro": 917,
"Açores": 910,
"Beja": 1236,
"Braga": 836,
"Bragança": 745,
"Castelo Branco": 1105,
"Coimbra": 1125,
"Faro": 1702,
"Guarda": 812,
"Leiria": 853,
"Lisboa": 1583,
"Madeira": 1611,
"Portalegre": 889,
"Porto": 1095,
"Portugal": 1259,
"Santarém": 1066,
"Setúbal": 1147,
"Viana do Castelo": 1186,
"Vila Real": 856,
"Viseu": 655,
"time": "200910",
"Évora": 1211
},
{"Aveiro": 1017,
"Açores": 1006,
"Beja": 1205,
"Braga": 823,
"Bragança": 784,
"Castelo Branco": 799,
"Coimbra": 1145,
"Faro": 1518,
"Guarda": 798,
"Leiria": 1032,
"Lisboa": 1540,
"Madeira": 1326,
"Portalegre": 823,
"Porto": 1087,
"Portugal": 1238,
"Santarém": 1022,
"Setúbal": 1171,
"Viana do Castelo": 1182,
"Vila Real": 1318,
"Viseu": 933,
"time": "200911",
"Évora": 1098
}
]

Áreas da Habitação na região

path Parameters

region required	string A região (portugal, concelho ou distrito)
id required	string o id da região no openstreetmap

Responses

Response samples

Content type

application/json

{"areas": {"0": "50.93",
"1": "67.28",
"2": "89.23",
"3": "115.32",
"4": "138.36",
"5": "152.78",
"6": "160.16",
"7": "166.18",
"8": "188.05",
"T": "108.86"
}
}

Mapas

Obtem o mapa de Portugal, do distrito ou do municipio selecionado.

path Parameters

region required	string A região do mapa (portugal, concelho ou distrito)
id	string o id da região no openstreetmap

Responses

Response samples

Content type

application/json

{"map": {"arcs": [[[4138,
15397
],
[58,
-24
]
]
],
"objects": {"mapa": {"geometries": [{"arcs": [[0,
1,
2,
3
]
],
"properties": {"id": 3920249,
"name": "Aveiro"
},
"type": "Polygon"
},
{"arcs": [[4,
5,
6,
7,
8
]
],
"properties": {"id": 5134927,
"name": "Beja"
},
"type": "Polygon"
},
{"arcs": [[226
]
],
"properties": {"id": 1629146,
"name": "Açores",
"type": "island"
},
"type": "Polygon"
}
],
"type": "GeometryCollection"
}
},
"transform": {"scale": [0.000461953857903073,
0.0003426824283370984
],
"translate": [-10.17536799866491,
35.78972751833839
]
},
"type": "Topology"
},
"projection": {"name": "geoMercator",
"scale": 2099.272121773431,
"translate": [398.7086018774538,
1705.9774278059497
]
}
}

Notícias

Lista as notícias preservadas para o período desejado

path Parameters

date

required

number

Período das notícias no formato YYYYMM (ano + mês)

query Parameters

page	number Número da página de resultados
location	string Filtrar resultados com base na região geográfica

Responses

Response samples

Content type

application/json

{"hits": [{"document": {"archive_date": "20230101111725",
"category": "Políticas de Habitação",
"date": "202212",
"domain": "www.dn.pt",
"id": "14382",
"summary": "O diploma que alarga o leque de jovens que podem aceder ao Porta 65 e simplifica o Programa Arrendamento Acessível já foram publicadas, com as novas regras a permitirem a utilização dos dois programas em simultâneo.\nEntre as mudanças ao Porta 65, um programa que apoia financeiramente jovens que querem arrendar casa, está a atualização dos tetos máximos de renda elegíveis, medida que permitirá alargar o leque de beneficiários.\nNo caso do Arrendamento Acessível -- que atribui isenção total de IRS aos proprietários que coloquem os seus imóveis neste programa -- as novas regras vêm permitir que, além do arrendamento permanente, poderão também integrar este programa os arrendamentos temporários.\nSegundo o diploma, são consideradas residências temporárias as dirigidas a \"estudantes e formandos, bem como para formadores, técnicos especializados e pessoal docente e não docente de todos os níveis de educação ou formação escolar e profissional\".\nJá os contratos de arrendamento para residência permanente no âmbito do Programa de Apoio ao Arrendamento \"têm prazo mínimo de cinco anos, renovável por período estipulado entre as partes\".",
"title": "Publicadas novas regras que alargam leque de jovens que podem aceder ao Porta 65",
"url": "https://www.dn.pt/sociedade/publicadas-novas-regras-que-alargam-leque-de-jovens-que-podem-aceder-ao-pota-65-15579904.html"
}
},
{"document": {"archive_date": "20230101114329",
"category": "Políticas de Habitação",
"date": "202212",
"domain": "24.sapo.pt",
"id": "14381",
"summary": "Entre as mudanças ao Porta 65, um programa que apoia financeiramente jovens que querem arrendar casa, está a atualização dos tetos máximos de renda elegíveis, medida que permitirá alargar o leque de beneficiários.\nNo caso do Arrendamento Acessível – que atribui isenção total de IRS aos proprietários que coloquem os seus imóveis neste programa – as novas regras vêm permitir que, além do arrendamento permanente, poderão também integrar este programa os arrendamentos temporários.\nSegundo o diploma, são consideradas residências temporárias as dirigidas a “estudantes e formandos, bem como para formadores, técnicos especializados e pessoal docente e não docente de todos os níveis de educação ou formação escolar e profissional”.\n“Os contratos de arrendamento com finalidade de residência temporária apenas podem ser celebrados com arrendatários cujo domicílio fiscal seja distinto do concelho do locado, nos termos estabelecidos por portaria do membro do Governo responsável pela área da habitação”, determina o diploma.\nJá os contratos de arrendamento para residência permanente no âmbito do Programa de Apoio ao Arrendamento “têm prazo mínimo de cinco anos, renovável por período estipulado entre as partes”.",
"title": "Habitação: Publicadas novas regras do Porta 65 e do Arrendamento Acessível",
"url": "https://24.sapo.pt/economia/artigos/habitacao-publicadas-novas-regras-do-porta-65-e-do-arrendamento-acessivel"
}
}
],
"out_of": 14910,
"page": 1
}