Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Pagination des résultats : utilisation du paramètre curseur (format JSON uniquement)

Si vous désirez parcourir un grand nombre de résultats, notamment pour obtenir des résultats au-delà de la limite indiquée dans le tableau (1000), il est fortement recommandé d’utiliser des curseurs.

Utilisation :

À votre première requête, ajouter le paramètre curseur=*.
Le retour de la requête contiendra la variable CurseurSuivant qui donnera la valeur à attribuer au paramètre curseur pour obtenir la page suivante.
Quand la valeur de CurseurSuivant dans le résultat est la même que celle envoyée avec la requête (variable Curseur) il n’y a plus de résultat à récupérer.

Exemple

Recherche de tous les établissements actifs des associations et assimilés (catégorie juridique commençant par 92) du 1er arrondissement de Paris :
Décompte : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(etatAdministratifEtablissement:A) AND categorieJuridiqueUniteLegale:92* AND codeCommuneEtablissement:75101&nombre=0
"header": {
        "statut": 200,
        "message": "OK",
        "total": 2628,
        "debut": 0,
        "nombre": 0
...
1ère requête avec curseur : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(etatAdministratifEtablissement:A) AND categorieJuridiqueUniteLegale:92* AND codeCommuneEtablissement:75101&nombre=1000&curseur=*
"header": {
        "statut": 200,
        "message": "OK",
        "total": 2628,
        "debut": 0,
        "nombre": 1000,
        "curseur": "*",
        "curseurSuivant": "AoEuNDI4MjEyMzM2MDAwMjE="
    },
    "etablissements": [
        {
            "siren": "300227279",
            "nic": "00050",
            "siret": "30022727900050",
...
...
2ème requête avec curseur : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(etatAdministratifEtablissement:A) AND categorieJuridiqueUniteLegale:92* AND codeCommuneEtablissement:75101&nombre=1000&curseur=AoEuNDI4MjEyMzM2MDAwMjE=
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 2628,
        "debut": 0,
        "nombre": 1000,
        "curseur": "AoEuNDI4MjEyMzM2MDAwMjE=",
        "curseurSuivant": "AoEuNzg0MjA0NDU1MDAwMjU="
    },
    "etablissements": [
        {
            "siren": "428415889",
            "nic": "00016",
            "siret": "42841588900016",
...
...
3ème requête avec curseur : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(etatAdministratifEtablissement:A) AND categorieJuridiqueUniteLegale:92* AND codeCommuneEtablissement:75101&nombre=1000&curseur=AoEuNzg0MjA0NDU1MDAwMjU=
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 2628,
        "debut": 0,
        "nombre": 628,
        "curseur": "AoEuNzg0MjA0NDU1MDAwMjU=",
        "curseurSuivant": "AoEuOTEwODUyNTMyMDAwMTk="
    },
    "etablissements": [
        {
            "siren": "784205494",
            "nic": "00064",
            "siret": "78420549400064",
...
...
4ème requête avec curseur : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=periode(etatAdministratifEtablissement:A) AND categorieJuridiqueUniteLegale:92* AND codeCommuneEtablissement:75101&nombre=1000&curseur=AoEuOTEwODUyNTMyMDAwMTk=
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 2628,
        "debut": 0,
        "nombre": 0,
        "curseur": "AoEuOTEwODUyNTMyMDAwMTk=",
        "curseurSuivant": "AoEuOTEwODUyNTMyMDAwMTk="
    },
    "etablissements": []

Commentaires

La dernière requête renvoie 0 unités et curseur = curseurSuivant.
Ne pas utiliser le paramètre tri avec les curseurs.
Les paramètres de pagination sont également disponibles sur la console. Pour en savoir plus

Haut de page