DeepCity API Publique

GET /v1/properties?parcel_id={parcel_id}&include={include}

import requests

# Recherche par parcelle avec tous les types de données
response = requests.get(
    "https://api.deepcity.fr/v1/properties",
    params={
        "parcel_id": "75101000AB0001",
        "include": ["transactions", "energy", "occupation", "proprio", "copro", "permis", "fonds_de_commerce", "urbanisme"]
    }
)

data = response.json()
print(f"Found {len(data['properties'])} properties")

# Vérifier le statut
if response.status_code == 200:
    properties = data['properties']
    if len(properties) > 0:
        property_data = properties[0]
        if property_data.get('cadastral'):
            print(f"Parcelle: {property_data['cadastral']['id']}")
        if property_data.get('buildings'):
            print(f"Bâtiments: {len(property_data['buildings'])}")
        if property_data.get('transactions'):
            print(f"Transactions: {len(property_data['transactions'])}")
elif response.status_code == 429:
    print("Rate limit dépassé, attendez un peu avant de réessayer")
else:
    print(f"Erreur: {data.get('message', 'Unknown error')}")

{
  "properties": [
    {
      "cadastral": {
        "id": "75101000AB0001",
        "area": 1234.56,
        "geometry": {
          "type": "Polygon",
          "coordinates": [[[2.3522, 48.8566], ...]]
        }
      },
      "buildings": [
        {
          "building": {
            "id": "BDNB123456",
            "parcelIds": ["75101000AB0001"],
            "constructionYear": 1985,
            "numberOfUnits": 12,
            "usage": "Résidentiel",
            "mainAddress": "123 Rue Example, 75001 Paris",
            // ... plus de 50 champs disponibles (voir schéma Building)
          },
          "addresses": [
            {
              "id": "75101_1234_00001",
              "label": "123 Rue Example, 75001 Paris",
              "coordinates": [2.3522, 48.8566],
              "postalCode": "75001",
              "city": "Paris"
              // ... autres champs disponibles
            }
          ]
        }
      ],
      "transactions": [
        {
          "mutationId": "123456",
          "mutationDate": "2023-01-15",
          "mutationType": "Vente",
          "value": 450000,
          "address": {...},
          "parcelId": "75101000AB0001",
          "localType": "Appartement",
          "totalSurface": 85.5,
          "totalRooms": 3,
          "coordinates": [2.3522, 48.8566],
          "year": 2023,
          "numberOfLots": 3,
          "lots": [...],
          "landInfo": {...}
          // ... autres champs disponibles
        }
      ],
      "energy": {
        "tertiary": [
          {
            "dpeNumber": "DPE123456",
            "dpeLabel": "C",
            "gesLabel": "B",
            "consumptionKwhPrimaryM2Year": 120,
            "constructionYear": 1990,
            // ... plus de 70 champs disponibles (voir schéma DPE Tertiaire)
          }
        ],
        "residential": [
          {
            "dpeNumber": "DPE789012",
            "dpeLabel": "D",
            "gesLabel": "C",
            "fiveUsesPrimaryConsumption": 15000,
            "constructionYear": 1985,
            // ... plus de 300 champs disponibles (voir schéma DPE Résidentiel)
          }
        ]
      },
      "occupation": [
        {
          "siren": "123456789",
          "name": "Example SARL",
          "activity": "Commerce de détail",
          "address": "123 Rue Example, 75001 Paris",
          // ... plus de 20 champs disponibles (voir schéma Occupation)
        }
      ],
      "owners": [
        {
          "buildingId": "BDNB123456",
          "ownerName": "SCI Example",
          "siren": "123456789",
          "numberOfLocals": 5,
          "isLandlord": true,
          "details": {
            // ... champs enrichis disponibles (voir schéma Owners)
          }
        }
      ],
      "copropriete": [
        {
          "immatriculation": "123456789",
          "name": "Copropriété Example",
          "address": "123 Rue Example, 75001 Paris",
          "numberOfHousingLots": 50,
          "numberOfParkingLots": 15,
          // ... plus de 30 champs disponibles (voir schéma Copropriété)
        }
      ],
      "permis": [
        {
          "id": "PERMIT123",
          "type": "logements",
          "permitNumber": "PC075123456",
          "status": "completed",
          "authorizationDate": "2020-01-15",
          // ... plus de 20 champs disponibles (voir schéma Permis)
        }
      ],
      "fondsDeCommerce": [
        {
          "id": "BODACC123",
          "publicationDate": "2023-05-15",
          "type": "Ventes et cessions",
          "merchant": "SARL Example Commerce",
          "price": 150000,
          // ... plus de 20 champs disponibles (voir schéma Fonds de commerce)
        }
      ],
      "urbanisme": {
        "zones": [...],
        "documents": [...],
        "prescriptions": [...],
        "informations": [...],
        "assiettes": [...],
        "generateurs": [...]
        // ... voir schéma Urbanisme pour détails complets
      }
    }
  ]
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests",
  "error": "Too Many Requests",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "path": "/v1/properties",
  "method": "GET"
}

import requests
import time
from typing import Optional

def get_property_safe(parcel_id: str, max_retries: int = 3) -> Optional[dict]:
    """
    Récupère les données d'une propriété avec gestion du rate limiting.
    """
    for attempt in range(max_retries):
        try:
            response = requests.get(
                "https://api.deepcity.fr/v1/properties",
                params={"parcel_id": parcel_id},
                timeout=30
            )

            if response.status_code == 200:
                return response.json()
            elif response.status_code == 429:
                # Rate limit dépassé
                wait_time = (2 ** attempt) * 60  # Backoff exponentiel: 60s, 120s, 240s
                print(f"Rate limit atteint (tentative {attempt + 1}/{max_retries})")
                print(f"Attente de {wait_time} secondes...")
                time.sleep(wait_time)
            else:
                response.raise_for_status()

        except requests.exceptions.RequestException as e:
            print(f"Erreur réseau: {e}")
            if attempt < max_retries - 1:
                time.sleep(5)  # Attendre 5s avant de réessayer

    print("Nombre maximum de tentatives atteint")
    return None

# Utilisation
data = get_property_safe("75101000AB0001")
if data:
    print(f"Données récupérées: {len(data['properties'])} propriété(s)")

# Récupérer toutes les données d'une parcelle
response = requests.get(
    "https://api.deepcity.fr/v1/properties",
    params={"parcel_id": "75101000AB0001"}
)

# Récupérer uniquement les transactions immobilières
response = requests.get(
    "https://api.deepcity.fr/v1/properties",
    params={
        "parcel_id": "75101000AB0001",
        "include": ["transactions"]
    }
)

import requests
import time

parcel_ids = ["75101000AB0001", "75101000AB0002", "75101000AB0003"]

for parcel_id in parcel_ids:
    response = requests.get(
        "https://api.deepcity.fr/v1/properties",
        params={"parcel_id": parcel_id}
    )

    if response.status_code == 200:
        data = response.json()
        print(f"{parcel_id}: {len(data['properties'])} propriété(s)")
    elif response.status_code == 429:
        print("Rate limit atteint, attente de 60s...")
        time.sleep(60)  # Attendre 1 minute
    else:
        print(f"Erreur pour {parcel_id}: {response.status_code}")

    # Espacer les requêtes pour éviter le rate limiting
    time.sleep(0.6)  # 0.6s entre chaque requête = max 100/min