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

Facettes imbriquées

Les facettes imbriquées permettent d’effectuer des comptages à l’intérieur des facettes déjà créées.

La syntaxe est la suivante :

a) indiquer l'ensemble des champs demandés
facette.champ=liste des variables séparées par des virgules, sans espace
b) indiquer la façon dont les champs sont imbriqués
facette.nomFacette.facette=nomFacette2
facette.nomFacette2.facette=nomFacette3
...
Par défaut, toutes les facettes sont d’abord calculées sur l’ensemble du champ. Pour changer ce comportement et qu’une facette ne soit calculée qu’en tant que sous-facette, il faut la paramétrer. Tous les types de facettes (champ, requête et intervalle) peuvent être imbriquées les uns dans les autres. La profondeur des facettes a été limitée à 5.

Exemples avec une profondeur de 2 : comparaison des deux imbrications possibles

Sens 1 : dénombrement des établissements suivant leur état administratif et celui de l'unité légale à laquelle ils se rattachent :
https://api.insee.fr/entreprises/sirene/V3.11/siret?facette.champ=etatAdministratifUniteLegale,etatAdministratifEtablissement&facette.etatAdministratifUniteLegale.facette=etatAdministratifEtablissement&nombre=0
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 35321739,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "etatAdministratifUniteLegale",
            "comptages": [
                {
                    "valeur": "A",
                    "nombre": 22584122,
                    "facettes": [
                        {
                            "nom": "etatAdministratifEtablissement",
                            "comptages": [
                                {
                                    "valeur": "A",
                                    "nombre": 14354644
                                },
                                {
                                    "valeur": "F",
                                    "nombre": 8229478
                                }
                            ]
                        }
                    ]
                },
                {
                    "valeur": "C",
                    "nombre": 12737617,
                    "facettes": [
                        {
                            "nom": "etatAdministratifEtablissement",
                            "comptages": [
                                {
                                    "valeur": "F",
                                    "nombre": 12737596
                                },
                                {
                                    "valeur": "A",
                                    "nombre": 21
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "nom": "etatAdministratifEtablissement",
            "comptages": [
                {
                    "valeur": "F",
                    "nombre": 20967074
                },
                {
                    "valeur": "A",
                    "nombre": 14354665
                }
            ]
        }
    ]
}
Sens 2 : dénombrement des établissements suivant l'état administratif de l'unité légale à laquelle ils se rattachent et le leur :
https://api.insee.fr/entreprises/sirene/V3.11/siret?facette.champ=etatAdministratifUniteLegale,etatAdministratifEtablissement&facette.etatAdministratifEtablissement.facette=etatAdministratifUniteLegale&nombre=0
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 35321739,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "etatAdministratifUniteLegale",
            "comptages": [
                {
                    "valeur": "A",
                    "nombre": 22584122
                },
                {
                    "valeur": "C",
                    "nombre": 12737617
                }
            ]
        },
        {
            "nom": "etatAdministratifEtablissement",
            "comptages": [
                {
                    "valeur": "F",
                    "nombre": 20967074,
                    "facettes": [
                        {
                            "nom": "etatAdministratifUniteLegale",
                            "comptages": [
                                {
                                    "valeur": "C",
                                    "nombre": 12737596
                                },
                                {
                                    "valeur": "A",
                                    "nombre": 8229478
                                }
                            ]
                        }
                    ]
                },
                {
                    "valeur": "A",
                    "nombre": 14354665,
                    "facettes": [
                        {
                            "nom": "etatAdministratifUniteLegale",
                            "comptages": [
                                {
                                    "valeur": "A",
                                    "nombre": 14354644
                                },
                                {
                                    "valeur": "C",
                                    "nombre": 21
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Exemple avec une profondeur de 3

Dénombrement des établissements selon l'etat administratif de l'unité légale à laquelle ils se rattachent, l'appartenance de celle-ci au champ de l'économie sociale et solidaire et à celui des employeurs :
https://api.insee.fr/entreprises/sirene/V3.11/siret?facette.champ=economieSocialeSolidaireUniteLegale,etatAdministratifUniteLegale,caractereEmployeurUniteLegale&facette.etatAdministratifUniteLegale.facette=economieSocialeSolidaireUniteLegale&facette.economieSocialeSolidaireUniteLegale.facette=caractereEmployeurUniteLegale&nombre=0
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 35321739,
        "debut": 0,
        "nombre": 0
    },
    "etablissements": [],
    "facettes": [
        {
            "nom": "economieSocialeSolidaireUniteLegale",
            "comptages": [
                {
                    "valeur": "N",
                    "nombre": 5131034,
                    "facettes": [
                        {
                            "nom": "caractereEmployeurUniteLegale",
                            "comptages": [
                                {
                                    "valeur": "N",
                                    "nombre": 2681274
                                },
                                {
                                    "valeur": "O",
                                    "nombre": 2449758
                                }
                            ]
                        }
                    ]
                },
                {
                    "valeur": "O",
                    "nombre": 1575843,
                    "facettes": [
                        {
                            "nom": "caractereEmployeurUniteLegale",
                            "comptages": [
                                {
                                    "valeur": "N",
                                    "nombre": 1084601
                                },
                                {
                                    "valeur": "O",
                                    "nombre": 491242
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "nom": "etatAdministratifUniteLegale",
            "comptages": [
                {
                    "valeur": "A",
                    "nombre": 22584122,
                    "facettes": [
                        {
                            "nom": "economieSocialeSolidaireUniteLegale",
                            "comptages": [
                                {
                                    "valeur": "N",
                                    "nombre": 4892827,
                                    "facettes": [
                                        {
                                            "nom": "caractereEmployeurUniteLegale",
                                            "comptages": [
                                                {
                                                    "valeur": "N",
                                                    "nombre": 2522426
                                                },
                                                {
                                                    "valeur": "O",
                                                    "nombre": 2370399
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "valeur": "O",
                                    "nombre": 1543081,
                                    "facettes": [
                                        {
                                            "nom": "caractereEmployeurUniteLegale",
                                            "comptages": [
                                                {
                                                    "valeur": "N",
                                                    "nombre": 1068051
                                                },
                                                {
                                                    "valeur": "O",
                                                    "nombre": 475030
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                },
                {
                    "valeur": "C",
                    "nombre": 12737617,
                    "facettes": [
                        {
                            "nom": "economieSocialeSolidaireUniteLegale",
                            "comptages": [
                                {
                                    "valeur": "N",
                                    "nombre": 238207,
                                    "facettes": [
                                        {
                                            "nom": "caractereEmployeurUniteLegale",
                                            "comptages": [
                                                {
                                                    "valeur": "N",
                                                    "nombre": 158848
                                                },
                                                {
                                                    "valeur": "O",
                                                    "nombre": 79359
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "valeur": "O",
                                    "nombre": 32762,
                                    "facettes": [
                                        {
                                            "nom": "caractereEmployeurUniteLegale",
                                            "comptages": [
                                                {
                                                    "valeur": "N",
                                                    "nombre": 16550
                                                },
                                                {
                                                    "valeur": "O",
                                                    "nombre": 16212
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "nom": "caractereEmployeurUniteLegale",
            "comptages": [
                {
                    "valeur": "N",
                    "nombre": 28623795
                },
                {
                    "valeur": "O",
                    "nombre": 6697782
                }
            ]
        }
    ]
}

Autres exemples

Facettes imbriquées et facettes sur requêtes, facettes imbriquées et facettes sur intervalles... Disponibles sur cette page.

Commentaires

Pour un utilisateur n'ayant pas le droit d'accès aux données en diffusion partielle, un contrôle est fait sur chaque variable présente dans la recherche par facette (paramètre facette.champ). Les unités légales ou les établissements pour lesquels au moins l'une de ces variables est en diffusion partielle, ne seront pas comptabilisés dans les résultats de la recherche.
Rappel : les facettes ne sont pas disponibles en csv. Les facettes imbriquées ne sont pas disponibles sur la console.
Pour en savoir plus

Haut de page