Retour aux ressources
Production

API Recherche

Recherche intelligente de copropriétés par nom ou adresse

Endpoint

GET /api/search/slug?q={query}&type=search&limit={n}

Paramètres

ParamètreTypeRequisDescription
qstring
Oui
Requête de recherche (nom, adresse, ville...)
typestring
Oui
Toujours "search"
limitnumber
Non
Nombre de résultats (défaut: 10, max: 50)

Champs de réponse

Chaque résultat contient les informations suivantes

ChampTypeExemple
immatriculationstring"AF2594737"
nomstring"SAINT CHARLES"
adressestring"25 r saint-charles 67300 Schiltigheim"
code_postalstring"67300"
communestring"Schiltigheim"
nombre_lotsnumber9
urlstring"/copropriete/saint-charles-AF2594737"
matchTypestring"nom_exact" | "partial"

Exemples de requêtes

Recherche par nom :

GET /api/search/slug?q=saint%20charles&type=search&limit=10

Recherche par adresse + ville :

GET /api/search/slug?q=3%20avenue%20churchill%20evreux&type=search&limit=5

Recherche par adresse + code postal :

GET /api/search/slug?q=25%20rue%20samson%2027200&type=search&limit=5

Exemple de réponse JSON

{
  "results": [
    {
      "immatriculation": "AF2594737",
      "nom": "SAINT CHARLES",
      "adresse": "25 r saint-charles 67300 Schiltigheim",
      "code_postal": "67300",
      "commune": "Schiltigheim",
      "nombre_lots": 9,
      "url": "/copropriete/saint-charles-AF2594737",
      "matchType": "nom_exact",
      "relevanceScore": 250
    }
  ],
  "totalFound": 42,
  "search_method": "fulltext_priority"
}

Tester l'API

Essayez l'API en temps réel

Caractéristiques

  • Recherche intelligente par nom ou adresse
  • Support des accents (évreux = Évreux)
  • Détection automatique du type de requête
  • 619,402 copropriétés indexées
  • Données Q3 2025 à jour
  • Latence < 500ms
Ouvrir dans le navigateur