Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Requêtes multicritères : la variable score

Le score est une variable calculée par Solr, qui matérialise l’importance selon Solr du document renvoyé compte tenu de la requête. Pour API Sirene, un document est soit une unité légale avec toutes ses périodes soit un établissement avec toutes ses périodes. Solr calcule ce score de la manière suivante (principalement) :

• La fréquence à laquelle apparaît un terme dans un document. À partir d’une requête, plus le terme demandé apparaît dans un document, plus son score est élevé.
• La fréquence inverse de document : plus le terme est rare dans l’ensemble des documents, plus le document le contenant aura un score élevé.
• « Facteur de coordination » : s’il y a plusieurs termes dans une requête, plus il y a de termes qui apparaissent plus le score est élevé.
• Longueur de champ : plus le champ est petit, plus le score sera élevé si on y trouve un terme.
Il est possible d’afficher le score attribué grâce au paramètre champs.

La syntaxe est la suivante : champs : score, {liste des variables désirées dans la sortie}

Exemple

Recherche de l'unité légale dont la dénomination est la plus proche de Airbus :
https://api.insee.fr/entreprises/sirene/V3/siren?q=periode(denominationUniteLegale:airbus)&champs=score,siren,denominationUniteLegale&nombre=5&date=2099-12-31
{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 136,
        "debut": 0,
        "nombre": 5
    },
    "unitesLegales": [
        {
            "score": 16.602072,
            "siren": "303242887",
            "periodesUniteLegale": [
                {
                    "dateFin": null,
                    "dateDebut": "1985-12-25",
                    "denominationUniteLegale": "AIRBUS"
                }
            ]
        },
        {
            "score": 16.195581,
            "siren": "383474814",
            "periodesUniteLegale": [
                {
                    "dateFin": null,
                    "dateDebut": "2017-12-31",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2017-12-30",
                    "dateDebut": "2017-07-01",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2017-06-30",
                    "dateDebut": "2010-12-31",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2010-12-30",
                    "dateDebut": "2010-04-23",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2010-04-22",
                    "dateDebut": "2009-12-07",
                    "denominationUniteLegale": "AIRBUS SAS"
                },
                {
                    "dateFin": "2009-12-06",
                    "dateDebut": "2008-12-31",
                    "denominationUniteLegale": "AIRBUS SAS"
                },
                {
                    "dateFin": "2008-12-30",
                    "dateDebut": "2008-01-01",
                    "denominationUniteLegale": "AIRBUS SAS"
                },
                {
                    "dateFin": "2007-12-31",
                    "dateDebut": "2006-03-01",
                    "denominationUniteLegale": "AIRBUS SAS"
                },
                {
                    "dateFin": "2006-02-28",
                    "dateDebut": "2003-12-25",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2003-12-24",
                    "dateDebut": "2002-12-25",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2002-12-24",
                    "dateDebut": "2001-12-25",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2001-12-24",
                    "dateDebut": "2001-01-01",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2000-12-31",
                    "dateDebut": "2000-01-01",
                    "denominationUniteLegale": "EADS AIRBUS"
                },
                {
                    "dateFin": "1999-12-31",
                    "dateDebut": "1999-12-25",
                    "denominationUniteLegale": "AIRBUS INTEGRATED COMPANY"
                },
                {
                    "dateFin": "1999-12-24",
                    "dateDebut": "1991-10-18",
                    "denominationUniteLegale": "AIRBUS INTEGRATED COMPANY"
                }
            ]
        },
        {
            "score": 16.186237,
            "siren": "302609607",
            "periodesUniteLegale": [
                {
                    "dateFin": null,
                    "dateDebut": "2004-12-25",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2004-12-24",
                    "dateDebut": "2004-04-26",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2004-04-25",
                    "dateDebut": "2004-01-01",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2003-12-31",
                    "dateDebut": "2003-12-31",
                    "denominationUniteLegale": "AIRBUS SNC"
                },
                {
                    "dateFin": "2003-12-30",
                    "dateDebut": "2001-12-25",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2001-12-24",
                    "dateDebut": "2000-12-25",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "2000-12-24",
                    "dateDebut": "1980-01-01",
                    "denominationUniteLegale": "AIRBUS"
                },
                {
                    "dateFin": "1979-12-31",
                    "dateDebut": "1900-01-01",
                    "denominationUniteLegale": "AIRBUS"
                }
            ]
        },
        {
            "score": 14.099013,
            "siren": "331139980",
            "periodesUniteLegale": [
                {
                    "dateFin": null,
                    "dateDebut": "2007-11-20",
                    "denominationUniteLegale": "AIRBUS PRODUCTION"
                },
                {
                    "dateFin": "2007-11-19",
                    "dateDebut": "1998-12-25",
                    "denominationUniteLegale": "AIRBUS PRODUCTION"
                },
                {
                    "dateFin": "1998-12-24",
                    "dateDebut": "1991-12-25",
                    "denominationUniteLegale": "AIRBUS PRODUCTION"
                },
                {
                    "dateFin": "1991-12-24",
                    "dateDebut": "1984-10-01",
                    "denominationUniteLegale": "AIRBUS PRODUCTION"
                }
            ]
        },
        {
            "score": 14.099013,
            "siren": "381734805",
            "periodesUniteLegale": [
                {
                    "dateFin": null,
                    "dateDebut": "2007-06-29",
                    "denominationUniteLegale": "AIRBUS PARTICIPATIONS"
                },
                {
                    "dateFin": "2007-06-28",
                    "dateDebut": "2002-01-01",
                    "denominationUniteLegale": "AIRBUS PARTICIPATIONS"
                },
                {
                    "dateFin": "2001-12-31",
                    "dateDebut": "1991-12-25",
                    "denominationUniteLegale": "AI PARTICIPATIONS"
                },
                {
                    "dateFin": "1991-12-24",
                    "dateDebut": "1991-04-25",
                    "denominationUniteLegale": "AI PARTICIPATIONS"
                }
            ]
        }
    ]
}

Commentaires

La variable score n'est pas affichée en csv.
La variable score est disponible sur la console. Pour en savoir plus

Haut de page