Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Utilisation du caractère spécial « ~ » : recherche approximative

« ~ » permet de faire une recherche approximative. Elle repose sur la distance de Damerau-Levenshtein, avec une valeur par défaut de deux. La syntaxe est la suivante :

nomVariable:valeur~
nomVariable:valeur~1

Ainsi la recherche /siret?q=sigleUniteLegale:maison~, va renvoyer tous les établissements des unités légales dont le sigle ressemble à maison, à une ou deux lettres ou permutations près. Par exemple : mion, raison, tiason, maisonne
En ajoutant le paramètre 1 derrière le ~, on obtient seulement les chaînes de caractères qui ne comprennent qu’une seule suppression/ajout/permutation. Il n’est pas possible de mettre autre chose que 1 ou 2 comme paramètre (sachant que 2 est inutile car c’est la valeur par défaut).

Exemples

Recherche de tous les établissements dont l'unité légale a comme prenom1UniteLegale MICKAEL à deux caractères près, mais pas MICKAEL exactement : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=prenom1UniteLegale:MICKAEL~ AND -prenom1UniteLegale:MICKAEL
Recherche de tous les établissements dont l’unité légale a pour sigle PAUL à une erreur près : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=sigleUniteLegale:PAUL~1


Si la recherche se fait sur plusieurs mots, la distance de Levenshtein est calculée avec des insertions, permutation de mots et non de lettres. Dans ce cas, le paramètre après le ~ peut être supérieur à 2.

Exemple (sortie en csv, plus claire pour l'illustration, mais identique en résultat à la sortie en Json)

Recherche de tous les établissements dont l'unité légale a une dénomination sociale comprenant "BLEU LE" :

Résultat sans le ~ (recherche exacte) : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=denominationUniteLegale:"bleu le"&nombre=20&champs=denominationUniteLegale
PRINTEMPS BLEU LE CHOIX DE LA SANTE
Résultat avec ~2 (recherche approximative) : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=denominationUniteLegale:"bleu le"~2&nombre=100&champs=denominationUniteLegale
...
LE BLEU DU CIEL VOYAGES
L'ENERGIE RENOUVELABLE - BLEU COMME LE CIEL
LE BLEU DES ILES
SCI S LE BLEU
PRINTEMPS BLEU LE CHOIX DE LA SANTE
LE BLEU MARINE
...

Commentaires

Il est possible de rechercher des valeurs approximatives sur plusieurs mots en décomposant la recherche : la requête https://api.insee.fr/entreprises/sirene/V3.11/siret?q=denominationUniteLegale:yst~ AND denominationUniteLegale:anotwer~ AND denominationUniteLegale:copany~&champs=denominationUniteLegale&nombre=1000 donne "Yet another company" en écho

La recherche approximative est également utilisable sur la console. Pour en savoir plus