terminal API do cadastro

API do cadastro predial: parcelas em Portugal em REST

Consulte qualquer parcela em Portugal pela referência cadastral, por coordenadas ou pela morada e receba o ponto GPS, o contorno e a área em JSON. Os dados vêm da Direção-Geral do Território (DGT), cadastro predial. Chama uma única API REST com uma chave, e a mesma chave responde em 29 países europeus.

redeem 250 chamadas por mês grátis, sem cartão e sem data de validade.

Criar uma chave de API gratuita arrow_forward Ler a documentação

O que a API devolve em Portugal

Parcela por referência cadastral	Parcial	o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra
Parcela por coordenadas (lat, lng)	Sim
Contorno e área	Parcial	o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra
Da morada à parcela	Parcial	o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra
Edifício: uso, área construída, ano, fogos, pisos	Não
Solar, agricultura e pontuação (/solar, /agro, /score)	Sim
Relevo, Natura 2000 e áreas protegidas (/terrain)	Sim
Movimento do solo Copernicus EGMS, 2020-2024 (/ground-motion)	Sim
Normais climáticas ERA5-Land (dentro de /terrain)	Em carregamento	A grelha ERA5-Land ainda está a carregar: até terminar, o bloco de clima responde status unavailable.

Como se identifica uma parcela em Portugal

A API aceita o identificador da parcela cadastral da DGT (por exemplo AAA000025300). Também pode partir de um ponto (/api/search/coordinates) ou de uma morada (/api/search/address/candidates?country=PT).

Exemplo com uma resposta real

Consulta por referência (AAA000025300). Resposta medida em produção a 1 de outubro de 2026 e encurtada: o contorno tem 42 vértices e mostramos dois.

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/AAA000025300?country=PT"

{
  "success": true,
  "data": {
    "refCatastral": "AAA000025300",
    "pais": "PT",
    "municipio": "CADAVAL, Lamas e Cercal",
    "provincia": "CADAVAL, Lamas e Cercal",
    "latitud": 39.215402,
    "longitud": -9.08081,
    "googleMapsUrl": "https://www.google.com/maps?q=39.215402,-9.080810",
    "superficieParcela": 3302,
    "poligono": [
      [39.21452, -9.079979],
      [39.214494, -9.080091]
    ]
  }
}

Relevo, áreas protegidas e movimento do solo da mesma parcela

Passe a referência e o ponto da parcela a /terrain (relevo Copernicus DEM GLO-30, Natura 2000 e áreas protegidas nacionais) e a /ground-motion (velocidade vertical e este-oeste do EGMS). Cada resposta traz a fonte, a licença e a atribuição a mostrar.

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/AAA000025300/terrain?country=PT&lat=39.215402&lng=-9.08081"

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/AAA000025300/ground-motion?country=PT&lat=39.215402&lng=-9.08081"

Preços

Os mesmos planos em todos os países. Só contam as respostas com dados: não encontrado, 304 e erros são grátis.

Free

0 €

250 chamadas por mês

10 pedidos/min

Developer

19 €/mês

5000 chamadas por mês

60 pedidos/min

Startup

49 €/mês

15 000 chamadas por mês

120 pedidos/min

Growth

99 €/mês

50 000 chamadas por mês

300 pedidos/min

Perguntas frequentes

Existe uma API oficial do cadastro em Portugal?

Os dados oficiais são publicados pela Direção-Geral do Território (DGT), cadastro predial, em serviços próprios, com formatos, sistemas de referência e limites próprios. A Cadastro GPS lê esses serviços e dá-lhe uma única API REST/JSON com chave, coordenadas WGS84 prontas para um mapa e a mesma resposta em 29 países.

Como se identifica uma parcela em Portugal?

Com o identificador da parcela cadastral da DGT (por exemplo AAA000025300). Se não o tiver, pesquise por coordenadas ou por morada: a API devolve a referência com o contorno.

Quanto custa?

250 chamadas por mês são grátis, para sempre e sem cartão. Planos pagos: Developer 19 € por mês (5000 chamadas), Startup 49 € por mês (15 000 chamadas), Growth 99 € por mês (50 000 chamadas). As pesquisas sem resultado não contam.

O que traz uma resposta?

A referência, o país, o ponto GPS (latitud, longitud), o contorno (poligono) e a área em m² (superficieParcela), mais o concelho e a freguesia. availableFields diz que campos opcionais cada resposta traz de facto.

Posso pesquisar por morada em Portugal?

Em parte. /api/search/address/candidates?country=PT geocodifica com OpenStreetMap; o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra.