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 27 países europeus.

redeem 25 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 o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra	Parcial
Parcela por coordenadas (lat, lng)	Sim
Contorno e área o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra	Parcial
Da morada à parcela o cadastro predial digital é parcial e não cobre Lisboa, Porto nem Coimbra	Parcial
Edifício: uso, área construída, ano, fogos, pisos	Não
Solar, agricultura e pontuação (/solar, /agriculture, /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) A grelha ERA5-Land ainda está a carregar: até terminar, o bloco de clima responde status unavailable.	Em carregamento

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 (/v1/search/coordinates) ou de uma morada (/v1/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/v1/parcels/AAA000025300?country=PT"

{
  "success": true,
  "data": {
    "reference": "AAA000025300",
    "country": "PT",
    "municipality": "CADAVAL, Lamas e Cercal",
    "region": "CADAVAL, Lamas e Cercal",
    "latitude": 39.215402,
    "longitude": -9.08081,
    "googleMapsUrl": "https://www.google.com/maps?q=39.215402,-9.080810",
    "parcelArea": 3302,
    "polygon": [
      [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/v1/parcels/AAA000025300/terrain?country=PT&lat=39.215402&lng=-9.08081"

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/v1/parcels/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 €

IVA incluído

25 unidades por mês

10 pedidos/min

Unidades extra: 10 € por cada 1.000

Developer

19 €/mês

IVA incluído

5000 unidades por mês

60 pedidos/min

Unidades extra: 5 € por cada 1.000

Startup

49 €/mês

IVA incluído

15 000 unidades por mês

120 pedidos/min

Unidades extra: 4 € por cada 1.000

Growth

99 €/mês

IVA incluído

50 000 unidades por mês

300 pedidos/min

Unidades extra: 2,50 € por cada 1.000

Enterprise

desde300 €/mês

IVA incluído

Volume à medida

300/min ou mais, por contrato

Unidades extra: por contrato

SLA e suporte prioritário
Fatura anual
Os 27 países europeus

Contactar

Para empresas

Os planos públicos vão de 25 chamadas grátis a 50 000 chamadas por mês, com a mesma chave em Portugal e em 27 países. Se precisar de mais volume, de um SLA à medida ou de um país que ainda não cobrimos, escreva-nos.

checkSó contam as respostas com dados: não encontrado, 304 Not Modified e erros são grátis.
checkO plano grátis não pede cartão e não expira; os planos pagos são mensais.
checkCada resposta indica a fonte, a licença e a atribuição a mostrar.

Para que a usam as empresas em Portugal

Imobiliárias e portais

Contorno e área de cada imóvel a partir da referência ou de um ponto no mapa.

Administradores e gestores

Uma carteira de parcelas sempre atualizada; uma verificação sem alterações responde 304 e não custa nada.

Seguradoras e bancos

Subsidência do solo (/ground-motion), declive e áreas protegidas (/terrain) de cada parcela segura ou financiada.

Solar

Produção anual, poupança e retorno de uma instalação no telhado ou no solo com /solar.

Escreva-nos com o volume previsto e os países; respondemos por email: suporte@cadastrogps.pt

Criar uma chave de API gratuita arrow_forward

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 27 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?

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

O que traz uma resposta?

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

Posso pesquisar por morada em Portugal?

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