Skip to main content
GET
/
search
Recherche par géocodage direct
curl --request GET \
  --url https://geo.fluximmo.io/search
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "label": "10 Rue Nationale 75013 Paris 13e Arrondissement",
        "id": "test-id",
        "postcode": "75013",
        "city": "Paris",
        "district": "Paris 13e Arrondissement",
        "street": "Rue Nationale",
        "housenumber": "10",
        "citycode": "75113",
        "x": 2.369063,
        "y": 48.822409,
        "score": 0.6515151515151515,
        "_score": 0.6515151515151515,
        "name": "10 Rue Nationale",
        "type": "housenumber",
        "_type": "address",
        "contexte": "75, Paris",
        "importance": "0.6"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          2.03648539635326,
          44.3492508045369
        ]
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt

Use this file to discover all available pages before exploring further.

​
À quoi ça sert

GET /search résout une chaîne d’adresse libre (rue, ville, lieu connu) en coordonnées GPS + métadonnées administratives : code postal, code INSEE de la commune, type de voie, score de confiance. Transparence : ce service expose la Base Adresse Nationale (BAN/BANO) publique française (api-adresse.data.gouv.fr), opérée et proxifiée par Fluximmo. C’est un service public ouvert ; en passant par Fluximmo vous bénéficiez d’une intégration unifiée à l’écosystème API (mêmes clés, mêmes quotas, monitoring), sans rate-limit côté gouvernement à gérer vous-même. Cas d’usage typiques :
  • Géocoder une adresse saisie par un utilisateur avant d’appeler une recherche Fluximmo (/v2/protected/properties/search avec filtre location lat/lon + radius).
  • Récupérer le inseeCode d’une commune pour filtrer par code INSEE (plus précis que le code postal qui peut couvrir plusieurs communes).
  • Normaliser des adresses entrées en clair dans un CRM avant export.

​
Exemples

​
E1 — Lieu connu : “Tour Eiffel”

curl "https://api.fluximmo.io/geocoding/search?q=Tour+Eiffel&limit=1"
Retourne typiquement { lat, lon, address, postalCode: "75007", inseeCode: "75107", ... }.

​
E2 — Adresse précise pour récupérer le code INSEE

curl "https://api.fluximmo.io/geocoding/search?q=1+rue+de+Rivoli+Paris&limit=1"
Le citycode retourné est le code INSEE exploitable directement dans les filtres location Fluximmo.

​
Liens utiles

Clé test gratuite — 1 semaine

Créez un compte sur my.fluximmo.io pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement, aucun appel commercial.

Query Parameters

​
q
string

chaîne décrivant la localisation à rechercher

Exemples de requêtes:

  • /search?q=73 Avenue de Paris Saint-Mandé
  • /search?q=cimetière Vincennes
  • /search?q=75056104AE0003

Note: L'absence de valeur est autorisée sur le type parcel pour réaliser une recherche structurée. Par exemple: /search?q=&index=parcel&departmentcode=75&municipalitycode=056&section=AV

​
autocomplete
enum<string>
default:1

indique si la recherche doit être effectuée en mode auto-complétion (comportement par défaut).

Available options:
1,
0
​
index
enum<string>
default:address

index(es) de recherche :

  • address pour la recherche par adresse
  • parcel pour la recherche par parcelle cadastrale
  • poi pour la recherche par lieu et unité administrative

Il est possible de spécifier plusieurs indexes séparés par une virgule.

Exemples:

  • /search?index=parcel
  • /search?index=poi,address
Available options:
address,
poi,
parcel
​
limit
integer
default:10

Nombre maximum de résultats retournés. La valeur ne peut pas dépasser 50. Dans le cas où returntruegeometry est activé, la valeur est automatiquement ramenée à 20.

​
lat
number

latitude d'un localisant pour favoriser les candidats les plus proches.

​
lon
number

longitude d'un localisant pour favoriser les candidats les plus proches.

​
returntruegeometry
boolean
default:false

indique si la vraie géométrie doit être retournée

​
postcode
string

Filtre pour les index address et poi. Il permet de filtrer les résultats par code postal. Code postal

Required string length: 5
​
citycode
string

Filtre pour les index address et poi. Il permet de filtrer les résultats par code INSEE. Code INSEE

Required string length: 2 - 5
​
type
enum<string>

Filtre pour l'index address. Il permet de filtrer par type de données adresse : numéro de maison, rue, commune, ...

Available options:
housenumber,
street,
locality,
municipality
​
city
string

Filtre pour les index address et poi. Il permet de filtrer par nom de commune.

​
category
string

Filtre pour l'index poi. Il permet de filtrer par catégorie de poi. Les valeurs possibles sont listées dans le getCapabilities du service de géocodage.

​
departmentcode
string

Filtre pour l'index parcel. Il permet de filtrer par code de département.

​
municipalitycode
string

Filtre pour l'index parcel. Il permet de filtrer par code de commune.

​
oldmunicipalitycode
string

Filtre pour l'index parcel. Il permet de filtrer par code d'ancienne commune.

​
districtcode
string

Filtre pour l'index parcel. Il permet de filtrer par code d'arrondissement.

​
section
string

Filtre pour l'index parcel. Il permet de filtrer par section.

​
number
string

Filtre pour l'index parcel. Il permet de filtrer par numéro.

​
sheet
string

Filtre pour l'index parcel. Il permet de filtrer par feuille.

Response

successful operation

​
type
string
Example:

"FeatureCollection"

​
features
object[]