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/siret?q=categorieJuridiqueUniteLegale:1000 AND codeCommuneEtablissement: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/siret?q=categorieJuridiqueUniteLegale:1000 AND codeCommuneEtablissement: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/siret?q=categorieJuridiqueUniteLegale:1000 AND codeCommuneEtablissement: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