Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Utilisation des facettes pour les requêtes multicritères : le paramètre tri

Le paramètre tri permet de classer les facettes selon leur valeur (index) ou le nombre d'occurrences (count), en ordre croissant ou décroissant. Les facettes sont triées par défaut par nombre décroissant d'occurrences

Exemple sans paramètre tri

Comptage des établissements parisiens de personnes physiques, selon l'arrondissement et l'état administratif :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000%20AND%20codeCommuneEtablissement:75*&facette.champ=etatAdministratifEtablissement,codeCommuneEtablissement&nombre=0&facette.codeCommuneEtablissement.nombre=20
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 1233117,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "codeCommuneEtablissement",
            "comptages": [
                {
                    "valeur": "75118",
                    "nombre": 100072
                },
                {
                    "valeur": "75116",
                    "nombre": 98666
                },
                {
                    "valeur": "75111",
                    "nombre": 95087
                },
                {
                    "valeur": "75115",
                    "nombre": 94740
                },
                {
                    "valeur": "75117",
                    "nombre": 93853
                },
                {
                    "valeur": "75108",
                    "nombre": 85576
                },
                {
                    "valeur": "75120",
                    "nombre": 81103
                },
                {
                    "valeur": "75119",
                    "nombre": 73851
                },
                {
                    "valeur": "75112",
                    "nombre": 65918
                },
                {
                    "valeur": "75113",
                    "nombre": 63402
                },
                {
                    "valeur": "75110",
                    "nombre": 62546
                },
                {
                    "valeur": "75114",
                    "nombre": 60592
                },
                {
                    "valeur": "75109",
                    "nombre": 52942
                },
                {
                    "valeur": "75107",
                    "nombre": 36519
                },
                {
                    "valeur": "75105",
                    "nombre": 33807
                },
                {
                    "valeur": "75103",
                    "nombre": 30185
                },
                {
                    "valeur": "75106",
                    "nombre": 29753
                },
                {
                    "valeur": "75101",
                    "nombre": 26734
                },
                {
                    "valeur": "75102",
                    "nombre": 24910
                },
                {
                    "valeur": "75104",
                    "nombre": 22861
                }
            ]
        },
        {
            "nom": "etatAdministratifEtablissement",
            "comptages": [
                {
                    "valeur": "F",
                    "nombre": 821666
                },
                {
                    "valeur": "A",
                    "nombre": 411451
                }
            ]
        }
    ]
}

Exemple avec paramètre tri ascendant sur valeurs

Comptage des établissements parisiens de personnes physiques, selon l'arrondissement et l'état administratif :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000%20AND%20codeCommuneEtablissement:75*&facette.champ=etatAdministratifEtablissement,codeCommuneEtablissement&nombre=0&facette.codeCommuneEtablissement.nombre=20&facette.tri=index:asc
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 1233117,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "codeCommuneEtablissement",
            "comptages": [
                {
                    "valeur": "75101",
                    "nombre": 26734
                },
                {
                    "valeur": "75102",
                    "nombre": 24910
                },
                {
                    "valeur": "75103",
                    "nombre": 30185
                },
                {
                    "valeur": "75104",
                    "nombre": 22861
                },
                {
                    "valeur": "75105",
                    "nombre": 33807
                },
                {
                    "valeur": "75106",
                    "nombre": 29753
                },
                {
                    "valeur": "75107",
                    "nombre": 36519
                },
                {
                    "valeur": "75108",
                    "nombre": 85576
                },
                {
                    "valeur": "75109",
                    "nombre": 52942
                },
                {
                    "valeur": "75110",
                    "nombre": 62546
                },
                {
                    "valeur": "75111",
                    "nombre": 95087
                },
                {
                    "valeur": "75112",
                    "nombre": 65918
                },
                {
                    "valeur": "75113",
                    "nombre": 63402
                },
                {
                    "valeur": "75114",
                    "nombre": 60592
                },
                {
                    "valeur": "75115",
                    "nombre": 94740
                },
                {
                    "valeur": "75116",
                    "nombre": 98666
                },
                {
                    "valeur": "75117",
                    "nombre": 93853
                },
                {
                    "valeur": "75118",
                    "nombre": 100072
                },
                {
                    "valeur": "75119",
                    "nombre": 73851
                },
                {
                    "valeur": "75120",
                    "nombre": 81103
                }
            ]
        },
        {
            "nom": "etatAdministratifEtablissement",
            "comptages": [
                {
                    "valeur": "A",
                    "nombre": 411451
                },
                {
                    "valeur": "F",
                    "nombre": 821666
                }
            ]
        }
    ]
}

Exemple avec paramètre tri ascendant sur valeur pour l'arrondissement et descendant sur les occurrrences pour l'état administratif

Comptage des établissements parisiens de personnes physiques, selon l'arrondissement et l'état administratif :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000%20AND%20codeCommuneEtablissement:75*&facette.champ=etatAdministratifEtablissement,codeCommuneEtablissement&nombre=0&facette.codeCommuneEtablissement.nombre=20&facette.codeCommuneEtablissement.tri=index:asc&facette.etatAdministratifEtablissement.tri=count:desc
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 1233117,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "codeCommuneEtablissement",
            "comptages": [
                {
                    "valeur": "75101",
                    "nombre": 26734
                },
                {
                    "valeur": "75102",
                    "nombre": 24910
                },
                {
                    "valeur": "75103",
                    "nombre": 30185
                },
                {
                    "valeur": "75104",
                    "nombre": 22861
                },
                {
                    "valeur": "75105",
                    "nombre": 33807
                },
                {
                    "valeur": "75106",
                    "nombre": 29753
                },
                {
                    "valeur": "75107",
                    "nombre": 36519
                },
                {
                    "valeur": "75108",
                    "nombre": 85576
                },
                {
                    "valeur": "75109",
                    "nombre": 52942
                },
                {
                    "valeur": "75110",
                    "nombre": 62546
                },
                {
                    "valeur": "75111",
                    "nombre": 95087
                },
                {
                    "valeur": "75112",
                    "nombre": 65918
                },
                {
                    "valeur": "75113",
                    "nombre": 63402
                },
                {
                    "valeur": "75114",
                    "nombre": 60592
                },
                {
                    "valeur": "75115",
                    "nombre": 94740
                },
                {
                    "valeur": "75116",
                    "nombre": 98666
                },
                {
                    "valeur": "75117",
                    "nombre": 93853
                },
                {
                    "valeur": "75118",
                    "nombre": 100072
                },
                {
                    "valeur": "75119",
                    "nombre": 73851
                },
                {
                    "valeur": "75120",
                    "nombre": 81103
                }
            ]
        },
        {
            "nom": "etatAdministratifEtablissement",
            "comptages": [
                {
                    "valeur": "F",
                    "nombre": 821666
                },
                {
                    "valeur": "A",
                    "nombre": 411451
                }
            ]
        }
    ]
}

Commentaires


Les facettes sont indépendantes par défaut, mais il est possible de les imbriquer.
Le paramètre facette.tri n'est pas disponible sur la console.
Pour en savoir plus

Haut de page