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 total

Le paramètre total permet d'afficher la somme des comptages de valeurs, sans les valeurs manquantes (même si facette.manquant=true).

Exemple sans paramètre total

Comptage des établissements de personnes physiques, selon le sexe :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000&facette.champ=sexeUniteLegale&nombre=0
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 18834468,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "sexeUniteLegale",
            "comptages": [
                {
                    "valeur": "M",
                    "nombre": 11730202
                },
                {
                    "valeur": "F",
                    "nombre": 7077976
                }
            ]
        }
    ]
}

Exemple avec paramètre total

Comptage des établissements de personnes physiques, selon le sexe :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000&facette.champ=sexeUniteLegale&nombre=0&facette.total=true
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 18834468,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "sexeUniteLegale",
            "total": 18808178,
            "comptages": [
                {
                    "valeur": "M",
                    "nombre": 11730202
                },
                {
                    "valeur": "F",
                    "nombre": 7077976
                }
            ]
        }
    ]
}

Exemple avec paramètre total et paramètre manquant

Comptage des établissements de personnes physiques, selon le sexe :
https://api.insee.fr/entreprises/sirene/V3.11/siret?q=categorieJuridiqueUniteLegale:1000&facette.champ=sexeUniteLegale&nombre=0&facette.total=true&facette.manquant=true
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 18834468,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "sexeUniteLegale",
            "manquants": 26290,
            "total": 18808178,
            "comptages": [
                {
                    "valeur": "M",
                    "nombre": 11730202
                },
                {
                    "valeur": "F",
                    "nombre": 7077976
                }
            ]
        }
    ]
}

Commentaires

Le paramètre facette.total n'est pas disponible sur la console. Pour en savoir plus