Documentation API
Reference complete de l'API cadastrale
Base URL
https://api.parcelgps.comAuthentification
Toutes les requetes API necessitent une API key envoyee dans l'en-tete X-API-Key.
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S"Obtenez votre API key gratuite sur votre tableau de bord developpeur.
Codes d'erreur
| Status | Description |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized (invalid or missing API key) |
| 404 | Not Found |
| 429 | Rate Limit Exceeded |
| 500 | Internal Server Error |
Spain (ES)
Spanish Cadastre — Direccion General del Catastro
/catastro/:refcatObtenir les donnees d'une parcelle par reference cadastrale (14 ou 20 caracteres).
Parametres
| :refcat | string | Cadastral reference (e.g. 9872023VH5797S0001WX) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S0001WX"Exemple de reponse
{
"success": true,
"data": {
"refCatastral": "9872023VH5797S0001WX",
"pais": "ES",
"direccion": "CL GRAN VIA 1",
"codigoPostal": "28013",
"municipio": "MADRID",
"provincia": "MADRID",
"latitud": 40.4168,
"longitud": -3.7038,
"googleMapsUrl": "https://maps.google.com/?q=40.4168,-3.7038",
"uso": "Residencial",
"clase": "Urbana",
"superficieConstruida": 125,
"superficieParcela": 200,
"anioConstruccion": 1920,
"coefParticipacion": "12.50",
"poligono": [[-3.704, 40.416], [-3.703, 40.416], ...],
"availableFields": {
"uso": true, "clase": true, "anioConstruccion": true,
"superficieConstruida": true, "coefParticipacion": true,
"direccion": true, "busquedaDireccion": true
}
},
"searchesRemaining": 4
}/search/coordinatesGeocodage inverse : trouver la parcelle cadastrale a des coordonnees GPS.
Parametres
| latitude | number | Latitude (WGS84) |
| longitude | number | Longitude (WGS84) |
| country | string | Country code (default: ES) |
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude": 40.4168, "longitude": -3.7038, "country": "ES"}' \
"https://api.parcelgps.com/search/coordinates"Exemple de reponse
{
"success": true,
"data": {
"referenciaCatastral": "9872023VH5797S0001WX",
"refCat14": "9872023VH5797S",
"direccion": "CL GRAN VIA 1",
"municipio": "MADRID",
"tipoInmueble": "",
"coordenadas": { "latitud": 40.4168, "longitud": -3.7038 },
"googleMapsUrl": "https://maps.google.com/?q=40.4168,-3.7038"
},
"searchesRemaining": 3
}/search/address/parseRechercher une parcelle cadastrale par adresse postale.
Parametres
| direccion | string | Free-text address (Spain only) |
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"direccion": "Gran Via 1, Madrid"}' \
"https://api.parcelgps.com/search/address/parse"Exemple de reponse
{
"success": true,
"data": {
"referenciaCatastral": "9872023VH5797S0001WX",
"direccion": "CL GRAN VIA 1",
"municipio": "MADRID",
"provincia": "MADRID"
},
"searchesRemaining": 2
}Portugal (PT)
Portuguese Cadastre — Direcao-Geral do Territorio
/catastro/:refcat?country=PTObtenir les donnees d'une parcelle portugaise par reference cadastrale.
Parametres
| :refcat | string | Portuguese cadastral reference (NIP) |
| country | string | Must be "PT" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/U0512N0003200?country=PT"Exemple de reponse
{
"success": true,
"data": {
"refCatastral": "U0512N0003200",
"pais": "PT",
"latitud": 38.7223,
"longitud": -9.1393,
"googleMapsUrl": "https://maps.google.com/?q=38.7223,-9.1393",
"municipio": "LISBOA",
"superficieParcela": 450,
"poligono": [[-9.14, 38.72], ...]
},
"searchesRemaining": 4
}France (FR)
French Cadastre — Cadastre / Geoplateforme
/catastro/:refcat?country=FRObtenir les donnees d'une parcelle francaise par reference cadastrale.
Parametres
| :refcat | string | French cadastral reference (e.g. 750560000AB0001) |
| country | string | Must be "FR" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/750560000AB0001?country=FR"Exemple de reponse
{
"success": true,
"data": {
"refCatastral": "750560000AB0001",
"pais": "FR",
"latitud": 48.8566,
"longitud": 2.3522,
"googleMapsUrl": "https://maps.google.com/?q=48.8566,2.3522",
"municipio": "PARIS",
"provincia": "Paris",
"superficieParcela": 320,
"poligono": [[2.35, 48.85], ...]
},
"searchesRemaining": 4
}Italy (IT)
Italian Cadastre — Agenzia delle Entrate
/catastro/:refcat?country=ITObtenir les donnees d'une parcelle italienne par reference catastale.
Parametres
| :refcat | string | Italian cadastral reference |
| country | string | Must be "IT" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/A0420001?country=IT"Exemple de reponse
{
"success": true,
"data": {
"refCatastral": "A0420001",
"pais": "IT",
"latitud": 41.9028,
"longitud": 12.4964,
"googleMapsUrl": "https://maps.google.com/?q=41.9028,12.4964",
"municipio": "ROMA",
"superficieParcela": 180,
"poligono": [[12.49, 41.90], ...]
},
"searchesRemaining": 4
}Germany (DE)
German Cadastre — ALKIS (8 Bundesländer)
/catastro/:refcat?country=DEObtenir les donnees d'une parcelle allemande (NRW) par reference cadastrale.
Parametres
| :refcat | string | German cadastral reference (Flurstückskennzeichen) |
| country | string | Must be "DE" |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/05315000200001?country=DE"Exemple de reponse
{
"success": true,
"data": {
"refCatastral": "05315000200001",
"pais": "DE",
"latitud": 50.9375,
"longitud": 6.9603,
"googleMapsUrl": "https://maps.google.com/?q=50.9375,6.9603",
"municipio": "KÖLN",
"superficieParcela": 520,
"poligono": [[6.96, 50.93], ...]
},
"searchesRemaining": 4
}Polygon / Solar / Export
Endpoints supplementaires (plan Pro ou superieur requis).
/catastro/:refcat/polygonObtenir le polygone GeoJSON d'une parcelle.
Parametres
| :refcat | string | Cadastral reference |
| country | string | Country code (query param, default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S/polygon"Exemple de reponse
{
"success": true,
"data": {
"refCatastral": "9872023VH5797S",
"pais": "ES",
"latitud": 40.4168,
"longitud": -3.7038,
"poligono": [[-3.704, 40.416], [-3.703, 40.416], ...]
},
"searchesRemaining": 4
}/catastro/:refcat/solarObtenir les donnees de potentiel solaire (PVGIS) d'une parcelle europeenne.
Parametres
| :refcat | string | Cadastral reference |
| country | string | Country code (query param, default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/catastro/9872023VH5797S/solar"Exemple de reponse
{
"success": true,
"data": {
"kwh_year": 4200.0,
"kw_instalables": 3.5,
"ahorro_anual_eur": 680.0,
"amortizacion_anos": 8.5,
"co2_evitado_kg": 1890.0,
"irradiacion_media": 1650.5,
"nota_solar": 4,
"disponible": true,
"estado": "ok"
}
}/export/kml?refcat=:refcatExporter les donnees de parcelle au format KML (Google Earth).
Parametres
| refcat | string | Cadastral reference |
| country | string | Country code (default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/export/kml?refcat=9872023VH5797S" -o parcel.kmlExemple de reponse
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Placemark>
<name>9872023VH5797S</name>
...
</Placemark>
</Document>
</kml>/export/gpx?refcat=:refcatExporter les donnees de parcelle au format GPX (navigateurs GPS).
Parametres
| refcat | string | Cadastral reference |
| country | string | Country code (default: ES) |
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parcelgps.com/export/gpx?refcat=9872023VH5797S" -o parcel.gpxExemple de reponse
<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1">
<wpt lat="40.4168" lon="-3.7038">
<name>9872023VH5797S</name>
</wpt>
</gpx>