GET /eco/sirets

A propos

Cette requête permet de rechercher des établissements par nom, numéro SIRET et autres critères.
Chaque établissement est identifié par un numéro SIRET unique.

Consultez la description du modèle pour plus d'informations.

Limitations

En JSON, la liste des établissements est paginée et limitée à 10 000 résultats.
Par défaut, chaque page contient 50 résultats, soit 200 pages de résultats maximum.
Il est possible de reduire ou augmenter ce nombre dans la limite de 100 résultats par page.

Pour accéder à une liste de resultats illimités, utilisez les datasets !

En GeoJSON, le nombre de points retournés est limité à 10 000.

Informations

URL https://api.solutions-territoire.fr/eco/sirets
Disponibilité 0.6.0
Authentification requise Authorization Code ou Client Credentials
Scope requis Accés aux données économiques
Formats disponibles JSON, GeoJSON
Code HTTP attendu 200

Paramètres

search String|Object optionnel Paramètres de recherche des établissements
page Integer optionnel Numéro de la page de résultat (en JSON seulement)
size Integer optionnel Nombre de résultats par page (en JSON seulement, 100 maximum)

Réponse JSON

total Integer Nombre total d'établissements (toutes pages confondues)
page Integer Numéro de page
etablissements Array Un tableau d'établissements

Réponse GeoJSON

type FeatureCollection
features Array Un tableau de points avec comme propriétés les références des établissements geo-localisés.

Exemples

Les exemples ci-dessous utilises la variable $ACCESS_TOKEN décrite dans la section Exemple : authentification en ligne de commande.

Exemple de requête listant les 50 premiers établissements :

cURL :

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/eco/sirets

HTTPie :

http -v GET https://api.solutions-territoire.fr/eco/sirets \
  Accept:"application/json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /eco/sirets HTTP/1.1
Accept: application/json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "total":          31679,
    "page":           1,
    "etablissements": [
        {
            "id":                   "84890575800027",
            "siret":                "84890575800027",
            "siren":                "848905758",
            "entreprise":           "Mon Territoire",
            "enseigne":             "",
            "denomination_usuelle": null,
            "adresse":              "31 BOULEVARD SARRAIL",
            "code_commune":         "34172",
            "libelle_commune":      "Montpellier",
            "effectif":             13,
            "effectif_details":     {
              "tranche_code":         "11",
              "tranche_label":        "10 à 19 personnes",
              "tranche_median":       14,
              "valeur_calculee":      null,
              "valeur_saisie":        13
            },
            "code_naf":             "63.11Z",
            "libelle_naf":          "Traitement de données, hébergement et activités connexes",
            "secteur_alternatif":   "Informatique",
            "url":                  "https://api.solutions-territoire.fr/v0/eco/sirets/84890575800027"
        },
        [...]
    ]
}

Exemple de requête de recherche d'établissements par SIREN et commune, 2e page de résultats :

cURL :

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"search": {"siren": "213401722", "code_commune": "34172" }, "page": 2}' \
  https://api.solutions-territoire.fr/eco/sirets

HTTPie :

http -v GET https://api.solutions-territoire.fr/eco/sirets \
  Accept:"application/json" \
  Authorization:"Bearer $ACCESS_TOKEN" \
  search:='{ "siren": "213401722", "code_commune": "34172" }' \
  page:=2

Résultat :

GET /eco/sirets HTTP/1.1
Accept: application/json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A
Content-Type: application/json

{
    "search": {
        "siren":        "213401722",
        "code_commune": "34172"
    },
    "page": 2
}

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "total":          153,
    "page":           2,
    "etablissements": [
        {
            "id":                   "21340172201704",
            "siret":                "21340172201704",
            "siren":                "213401722",
            "entreprise":           "COMMUNE DE MONTPELLIER",
            "enseigne":             "ECOLE ELEMENTAIRE JULES VERNE",
            "denomination_usuelle": null,
            "adresse":              "127 RUE YEHUDI MENUHIN",
            "code_commune":         "34172",
            "libelle_commune":      "Montpellier",
            "effectif":             "10 à 19 salariés",
            "effectif_details": {
              "tranche_code":     "11",
              "tranche_label":    "10 à 19 personnes",
              "tranche_median":   14,
              "valeur_calculee":  null,
              "valeur_saisie":    null
            },
            "code_naf":             "85.20Z",
            "libelle_naf":          "Enseignement primaire",
            "url":                  "https://api.solutions-territoire.fr/v0/eco/sirets/21340172201704"
        },
        [..]
    ]
}

Exemple de requête affichant les points des établissements dans une zone en GeoJSON

cURL :

curl -X GET \
  -H "Accept: application/geo+json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"search": {"zone_id": "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24" }}' \
  https://api.solutions-territoire.fr/eco/sirets

HTTPie :

http -v GET https://api.solutions-territoire.fr/eco/sirets \
  Accept:"application/geo+json" \
  Authorization:"Bearer $ACCESS_TOKEN" \
  search:='{ "zone_id": "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24" }'

Résultat :

GET /eco/sirets HTTP/1.1
Accept: application/geo+json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A
Content-Type: application/json

{
    "search": {
        "zone_id": "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24"
    }
}

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "type":     "FeatureCollection",
    "features": [
        {
            "type":     "Feature",
            "geometry": {
                "type":        "Point",
                "coordinates": [ 3.88048, 43.61078 ]
            },
            "properties": {
                "etablissements": [
                    {
                        "id":  "84890575800027"
                        "url": "https://api.solutions-territoire.fr/v0/eco/sirets/84890575800027"
                    }
                ]
            }
        }
    ]
}