NAV
shell

Introduction

Bienvenue sur societeinfo.com. Première plate-forme d'agrégation de données d'entreprises.

Vous avez accès avec notre API aux informations légales, financières, ainsi que toutes les données de contact détectées sur le web par nos algos (mails, sites web, réseaux sociaux...).

Notre data légale est rafraichie quotidiennement depuis les répertoires SIRENE, INPI et BODACC.

Utilisation

Authentification

Pour accéder au service vous devez obtenir une clé d'API. Enregistrez vous. Une fois enregistré, récupérez ou générez vos clés dans votre dashboard personnel.

Vous pouvez ajouter le header X-API-KEY à vos requêtes (recommandé)

GET https://something X-API-KEY:YOUR_APIKEY

Ou plus simplement ajouter le paramètre key à vos requêtes

GET https://something?key=YOUR_APIKEY

Crédits

curl "https://societeinfo.com/app/rest/api/v2/apikeyinfo.json?key=DEMO"

La commande retourne le JSON suivant :

{
    "success": true,
    "result": {
        "companyName": "SMART DATA",
        "productName": "Business",
        "consumedCredits": 12457,
        "maxCredits": 50000,
        "extraCredits": 50000,
        "consumedExtraCredits": 0,
        "totalAvailableCredits": 87543
    }
}

Chaque requête réussie consomme un ou plusieurs crédits. Le service suivant indique votre solde de crédits

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/apikeyinfo.json?key=YOUR_APIKEY

Query Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API.

Format

Les réponses peuvent être générées au format JSON ou au format XML

Dans toutes vos requêtes API, spécifiez dans l'url le format attendu : json ou xml

Company API

Get Company

curl "https://societeinfo.com/app/rest/api/v2/company.json/702012931?key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "result":{
      "id":"58796f69b3a2806717d13c40",
      "organization":{
         "status":"Active",
         "risk":{
            "risk_level":0,
            "risk_level_description":"Pas de risque identifié",
            "collective_procedure_in_progress":false,
            "collective_procedures":[
            ],
            "legal_source_organization_statuses":[
               {
                  "source_name":"Bodacc",
                  "organization_status":"Active"
               }
            ]
         },
         "creation_date":"1970-01-01",
         "capital":"100000",
         "registration_number":"702012931",
         "full_registration_number":"70201293100011",
         "vat_number":"FR25702012931",
         "greffe_name":"Paris",
         "name":"SOC EXPLOITATION SPECTACLES BATACLAN",
         "business_name": "CLASSIC ART MANAGEMENT",
         "activity":{
            "ape_code":"9001Z",
            "ape_code_level1":"RU",
            "ape_code_level2":"RZ",
            "ape_code_level3":"90",
            "ape_code_level4":"R90Z",
            "ape_code_level5":"9001Z",
            "ape_name":"Arts du spectacle vivant",
            "corporate_object": "LOCATION DE SALLES - ENTREPRENEUR DE SPECTACLES"
         },
         "legal":{
            "name": "SASU Société par actions simplifiée à associé unique",
            "code_level1": "5",
            "code_level2": "57",
            "code_level3": "5720",
            "person_type": "LegalEntity",
            "type": "Siege"
         },
         "convention_collective": {
            "code": "3090", 
            "name": "Convention collective nationale des entreprises du secteur privé du spectacle vivant"
         },
         "address":{
            "street":"50 BOULEVARD VOLTAIRE",
            "postal_code":"75011",
            "city":"PARIS",
            "country_code":"FR",
            "country":"FRANCE",
            "lng":2.3795,
            "lat":48.8574
         },
         "insee_category": {
            "code": "TPE",
            "name": "Très petite entreprise",
         },
         "beneficiaires_effectifs": [
         {
            "firstName": "PHILIP",
            "lastName": "ANSCHUTZ",
            "birth_date": "1939-12",
            "pourcentage_parts": 43.6,
            "details_parts_indirectes": {
              "details_en_personne_morale": {
                  "pourcentage_pleine_propriete": 43.6
                }
            },
            "details_votes_indirects": {
               "details_en_personne_morale": {
                  "pourcentage_pleine_propriete": 43.6
                }
              }
            }
         ],
         "last_legal_update_date":"2022-08-29",
         "establishments_count":9
      },
      "contacts":{
        "main_corporate_officier":{
           "lastName":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
           "name":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
           "role":"Président",
           "role_start_date":"2021-11-19",
           "role_end_date":"",
           "company":true,
           "registration_number":"326433117"
        },
        "corporate_officiers":[
           {
              "lastName":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
              "name":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
              "role":"Président",
              "role_start_date":"2021-11-19",
              "role_end_date":"",
              "company":true,
              "registration_number":"326433117"
           },
           {
              "lastName": "DELOITTE & ASSOCIES",
              "name": "DELOITTE & ASSOCIES",
              "role": "Commissaire aux comptes titulaire",
              "role_start_date": "2023-11-21",
              "role_end_date": "",
              "company": true,
              "registration_number": "572028041"
           }
        ],
         "email":"contact@bataclan.fr",
         "emails":[
            {
               "value":"contact@bataclan.fr",
               "type":"generic",
                "email_test_result": "Risky",
                "email_test_reason": "Accept All",
                "email_test_date": "2023-09-16",
                "email_webmail": false
            }
         ]
      },
      "web_infos":{
         "logo_url":"https://pbs.twimg.com/profile_images/1173587700257046528/r069sLPZ_400x400.jpg",
         "website_url":"http://www.bataclan.fr/",
         "websites":[
            {
               "domain":"bataclan.fr",
               "url":"http://www.bataclan.fr/",
               "description": "Site officiel du Bataclan : Salle de concerts et de spectacles parisienne affranchie des genres, âges et époques! Là où passion, impertinence et énergie s'agitent librement depuis 1865. sition. ",
               "webmaster_email": "gestion.ndd@lagardere-le.com",
               "webmaster_phone":"01 40 69 17 91",
               "techno_types":[
                  "facebook-pixel",
                  "popper",
                  "wordpress",
                  "apache-http-server",
                  "smash-balloon-instagram-feed",
                  "bootstrap",
                  "owl-carousel",
                  "amazon-web-services",
                  "contact-form-7",
                  "jquery",
                  "core-js",
                  "yoast-seo",
                  "google-analytics",
                  "amazon-ses",
                  "scrollmagic",
                  "recaptcha",
                  "mysql",
                  "google-tag-manager",
                  "azure",
                  "docusign",
                  "microsoft-365",
                  "gsap",
                  "tiktok-pixel",
                  "jquery-migrate",
                  "twitter-emoji-twemoji",
                  "fancybox",
                  "videojs",
                  "php",
                  "open-graph"
               ],
               "metadata":{
                  "owner_registration_number":"702012931",
                  "website_crawl_date":"2020-08-23",
                  "domain_creation_date":"2000-04-19"
               }
            }
         ],
        "linkedin":{
            "url": "https://www.linkedin.com/company/le-bataclan/",
            "id": "le-bataclan",
            "tech_id": "25915726",
            "name": "LE BATACLAN",
            "description": "Bataclan has always been atypical amongst Parisian venues. It has been the first “café-concert” free of its artistic choices since its beginnings. For 150 years, the venue reflects the Parisian culture and way of life. Rock, French music, rap, electro and world music… the Bataclan still a crucial step for many artists careers. ",
            "follower_count": 4587,
            "employees_range": "2-10",
            "employees_count": 31,
            "crawl_date": "2023-10-15"
        },
         "twitter":{
            "url":"https://twitter.com/@bataclan_"
         },
         "facebook":{
            "url":"https://www.facebook.com/bataclanFR/"
         },
         "wikipedia":{   
         }
         "youtube": {
         },
         "instagram": {
            "url": "https://www.instagram.com/bataclanofficiel/"
         }
      },
      "financials":{
        "last_sales": 1752459,
        "last_profit": 49868,
        "last_staff": 6,
        "years":[
           {
              "year":"2023",
              "staff":6,
              "staff_metadata":{
                 "estimated":true
              }
           },
           {
              "year":"2022",
              "sales": 1752459,
              "profit": 49868,
              "staff":23,
              "closing_date": "2022-08-31",
              "sales_metadata":{
                 "estimated":false
              },
              "profit_metadata":{
                 "estimated":false
              },
              "staff_metadata":{
                 "estimated":true
              }
           },
           {
              "year":"2021",
              "sales":1005656,
              "profit":-446592,
              "staff":6,
              "closing_date":"2021-12-31",
              "sales_metadata":{
                 "estimated":false
              },
              "profit_metadata":{
                 "estimated":false
              },
              "staff_metadata":{
                 "estimated":false
              }
           },
           {
              "year":"2020",
              "sales":460718,
              "profit":-694735,
              "staff":6,
              "closing_date":"2020-12-31",
              "sales_metadata":{
                 "estimated":false
              },
              "profit_metadata":{
                 "estimated":false
              },
              "staff_metadata":{
                 "estimated":false
              }
           },
           ...
        ],
        "last_staff_sources":[
           {
              "source":"RncsBILANS",
              "value":6,
              "date":"2021-01-01",
              "estimated":false
           },
           {
              "source":"Infogreffe",
              "value":6,
              "date":"2020-01-01",
              "estimated":false
           },
           {
              "source":"Sirene",
              "range_value":"6-9",
              "date":"2017-01-01",
              "estimated":true
           },
           {
              "source":"Linkedin",
              "field":"employees_range",
              "range_value": "2-10",
              "date": "2023-10-15",
              "estimated": false
           },
           {
              "source":"Linkedin",
              "field": "employees_count",
              "value": 31,
              "date": "2023-10-15",
              "estimated": false
           }
         ]
      },
      "mark_infos":{ 
      },
      "last_bodacc":{
          "type": "Bodacc",
          "bodacc_type": "Modifications et mutations diverses",
          "parution_date": "2023-11-26",
          "number": "2069",
          "rcs_name": "702012931 RCS Paris",
          "legal_name": "SOCIETE D'EXPLOITATION DES SPECTACLES BATACLAN",
          "legal_status": "Société par actions simplifiée (à associé unique)",
          "capital": "100000.00 EUR",
          "administration": "nomination du Commissaire aux comptes : DELOITTE & ASSOCIES",
          "address": "50 boulevard Voltaire 75011 Paris",
          "description": "modification survenue sur l'administration"
      },
      "actes":[
        {
           "date":"2022-07-22",
           "type":"Décision(s) de l'associé unique",
           "description":"Changement relatif à la date de clôture de l'exercice social"
        },
        {
           "date":"2022-07-22",
           "type":"Décision(s) de l'associé unique",
           "description":"Modification(s) statutaire(s)"
        },
        {
           "date":"2022-07-22",
           "type":"Statuts mis à jour"
        },
         ...
      ]
   }
}

Exemple de risk

{
...
  "risk": {
    "risk_level": 4,
    "risk_level_description": "Société clôturée",
    "collective_procedure_in_progress": true,
    "collective_procedures": [
      {
        "collective_procedure_type": "Procédure de sauvegarde",
        "collective_procedure_startdate": "2019-10-02",
        "collective_procedure_enddate": "2019-11-12",
        "collective_procedure_status": "Closed"
      },
      {
        "collective_procedure_type": "Redressement Judiciaire",
        "collective_procedure_startdate": "2019-11-13",
        "collective_procedure_enddate": "2019-12-11",
        "collective_procedure_status": "Closed"
      },
      {
        "collective_procedure_type": "Liquidation Judiciaire",
        "collective_procedure_startdate": "2019-12-12",
        "collective_procedure_enddate": "",
        "collective_procedure_status": "Open"
      }
    ],
    "legal_source_organization_statuses": [
      {
        "source_name": "Bodacc",
        "organization_status": "Dead",
        "organization_status_date": "2019-12-12"
      }
    ]
  },
...
}

Ce service retourne les informations détaillées d'une entreprise (données légales, chiffres clés, dirigeants, mails génériques, sites web, réseaux sociaux, marques...) à partir d'un code SIREN ou d'un code SIRET

Une sandbox avec un exemple en jquery est disponible sur github ici

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/company.json/<registration_number>?key=YOUR_APIKEY

GET https://societeinfo.com/app/rest/api/v2/company.json/<id>?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API.
registration_number Non Numéro SIREN ou SIRET de l'entreprise
id Oui Identifiant societeinfo de l'entreprise
withEstablishments false Oui Inclue les établissements du siège. Les valeurs possibles sont true ou false
withGoogleMyBusiness false Oui Inclue les informations de Google My Business dans le champ web_infos. Les valeurs possibles sont true ou false
withContactApiCount false Oui Comptabilise les contacts disponibles sur l'API contact. Les valeurs possibles sont true ou false
withKeywords false Oui Inclue les mots clés de la société. Les valeurs possibles sont true ou false

Réponse

Champs Description Valeurs possibles
organization.status Statut Active, Sleeping, Dead
organization.name Dénomination
organization.commercial_name Nom commercial
organization.business_name Nom enseigne
organization.acronym_name Sigle
organization.legal.type Type établissement Siege, SecondaryEstablishment
organization.legal.person_type Personnalité légale LegalEntity, Individual
organization.registration_number N° SIREN
organization.full_registration_number N° SIRET
organization.vat_number N° TVA UE
organization.legal.name Forme juridique
organization.legal.code_level1 Forme juridique code Niv.1 Forme juridique code Niv.1
organization.legal.code_level2 Forme juridique code Niv.2 Forme juridique code Niv.2
organization.legal.code_level3 Forme juridique code Niv.3 Forme juridique code Niv.3
organization.convention_collective.code Code de la convention collective Code de la convention collective
organization.convention_collective.name Nom de la convention collective Nom de la convention collective
organization.address.street Adresse
organization.address.postal_code Code postal
organization.address.city Ville
organization.insee_category.code Code de la catégorie INSEE TPE, PE, ME, ETI, GE, NON_DEFINIE
organization.insee_category.name libellé de la catégorie INSEE
organization.beneficiaires_effectifs Liste des bénéficiaires effectifs
organization.beneficiaires_effectifs.firstName Prénom
organization.beneficiaires_effectifs.firstName Nom
organization.beneficiaires_effectifs.birth_date Date de naissance
organization.beneficiaires_effectifs.pourcentage_parts Pourcentage de parts
organization.beneficiaires_effectifs.details_parts_indirectes Détails des parts indirectes
organization.beneficiaires_effectifs.details_votes_indirects Détails des votes indirectes
organization.capital Capital social (en €)
organization.address.postal_address_additional_name Complément nom (adressage)
organization.creation_date Date de création
organization.closing_date Date de radiation
organization.last_legal_update_date Dernière mise à jour légale
organization.greffe_name Greffe
organization.establishments_count Nombre d'établissements secondaires
organization.establishments Etablissements secondaires (param withEstablishments) Modèle
organization.contacts.main_corporate_officier Dirigeant principal
organization.contacts.main_corporate_officier.firstName Prénom
organization.contacts.main_corporate_officier.lastName Nom
organization.contacts.main_corporate_officier.name Prénom Nom ou Dénomination
organization.contacts.main_corporate_officier.birth_date Date de naissance
organization.contacts.main_corporate_officier.role Mandat
organization.contacts.main_corporate_officier.role_start_date Date de début de mandat
organization.contacts.main_corporate_officier.company Personne morale ou Personne physique true, false
organization.contacts.corporate_officiers Liste des mandataires
organization.activity.corporate_object Objet social
organization.activity.ape_code Code APE Code NAF Niv.5
organization.activity.ape_code_level1 Code NAF Niv.1 Code NAF Niv.1
organization.activity.ape_code_level2 Code NAF Niv.2 Code NAF Niv.2
organization.activity.ape_code_level3 Code NAF Niv.3 Code NAF Niv.3
organization.activity.ape_code_level4 Code NAF Niv.4 Code NAF Niv.4
organization.activity.ape_code_level5 Code NAF Niv.5 Code NAF Niv.5
organization.web_infos.website_url Url du site web principal
organization.web_infos.websites Site webs
organization.web_infos.websites.domain Domaine du site web
organization.web_infos.websites.url Url du site web
organization.web_infos.websites.description Description du site web
organization.web_infos.websites.techno_types Technologies présentes sur le site web principal Référentiel des technologies web
organization.web_infos.websites.metadata SIREN de l'entreprise principale / Dates de crawling
organization.web_infos.linkedin.url Url Linkedin
organization.web_infos.linkedin.id ID Linkedin
organization.web_infos.linkedin.tech_id ID tech Linkedin
organization.web_infos.linkedin.name Nom Linkedin
organization.web_infos.linkedin.description Descirption Linkedin
organization.web_infos.linkedin.follower_count Followers Linkedin
organization.web_infos.linkedin.employees_range Tranche déclarée d'employés
organization.web_infos.linkedin.employees_count Nombre d'employés attachés au compte linkedin
organization.web_infos.linkedin.crawl_date Date de crawling
organization.web_infos.twitter.url Url Twitter
organization.web_infos.facebook.url Url Facebook
organization.web_infos.wikipedia.url Url Wikipedia
organization.web_infos.keywords Mots et poids des termes clés de la société
financials.last_sales Dernier chiffre d'affaire
financials.last_profit Dernier résultat net
financials.last_staff Dernier effectif
financials.years.[financial type] Chiffre de l'année X
financials.years.[financial type]_metadata.estimated Chiffre estimé ? true, false
financials.last_staff_sources.source source d'effectif
financials.last_staff_sources.range_value/value valeur de la source d'effectif
financials.last_staff_sources.date date de la source d'effectif
financials.last_staff_sources.estimated Chiffre estimé ? true, false
contacts.phones Téléphones
contacts.email Email générique principal
contacts.emails Emails génériques
contacts.corporate_officiers Mandataires légaux
contacts.contact_api_count Nombre de contacts disponibles dans l'API contact

sales_metadata

Modèle de risque

Champs Description Valeurs possibles
organization.risk.risk_level Niveau de risque du siège 0-4 (voir tableau ci dessous)
organization.risk.risk_level_description Description
organization.risk.collective_procedure_in_progress Procédure collective en cours true, false
organization.risk.legal_source_organization_statuses.source_name Fournisseur de data RCS, INSEE, Bodacc
organization.risk.legal_source_organization_statuses.organization_status Statut Active, Sleeping, Dead
organization.risk.legal_source_organization_statuses.organization_status_date Statut Date de fermeture
organization.risk.collective_procedures.collective_procedure_type Type de procédure collectives
organization.risk.collective_procedures.collective_procedure_startdate Date d'ouverture
organization.risk.collective_procedures.collective_procedure_startmessage Libellé jugement
organization.risk.collective_procedures.collective_procedure_enddate Date de clôture
organization.risk.collective_procedures.collective_procedure_endmessage Libellé jugement
organization.risk.collective_procedures.collective_procedure_status Etat Open, Closed

Calcul de risque

Valeur Description
0 Société active ET pas de procédures collectives ou aucune procédure collective (sauf liquidation) clôturée depuis plus de 5 ans
1 Société active ET une procédure collective clôturée (sauf liquidation) depuis moins de 5 ans
2 Société active ET Au moins une procédure collective en cours (quelque soit son type)
3 Un indicateur de radiation OU (Société active ET procédure collective de liquidation clôturée)
4 Société clôturée OU (un indicateur de radiation ET une procédure collective de liquidation terminée)

Enrich Company

curl "https://societeinfo.com/app/rest/api/v2/company.json?name=smart%20data&postal_code=92200&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "match_info":{
      "score":0.59,
      "sources":"Nom Adresse"
   },
   "result":{
      "id":"593b6fa6b3a2feb79d4f9f39",
      "organization":{
         "status":"Active",
         "risk":{
            "risk_level":0,
            "risk_level_description":"Pas de risque identifié",
            "collective_procedure_in_progress":false,
            "collective_procedures":[

            ],
            "legal_source_organization_statuses":[
               {
                  "source_name":"Bodacc",
                  "organization_status":"Active"
               }
            ]
         },
         "creation_date":"2017-06-05",
         "capital":"5102",
         "registration_number":"830134383",
         "full_registration_number":"83013438300017",
         "vat_number":"FR38830134383",
         "greffe_name":"Nanterre",
         "name":"SMART DATA",
         "activity":{
            "ape_code":"6201Z",
            "ape_code_level1":"JZ",
            "ape_code_level2":"JC",
            "ape_code_level3":"62",
            "ape_code_level4":"J62Z",
            "ape_code_level5":"6201Z",
            "ape_name":"Programmation informatique",
            "corporate_object":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet"
         },
         "legal":{
            "name":"Société par actions simplifiée",
            "code_level1":"5",
            "code_level2":"57",
            "code_level3":"5710",
            "person_type":"LegalEntity",
            "type":"Siege"
         },
         "address":{
            "street":"176 AVENUE CHARLES DE GAULLE",
            "postal_code":"92200",
            "city":"NEUILLY-SUR-SEINE",
            "country_code":"FR",
            "country":"FRANCE",
            "lng":2.2697,
            "lat":48.8846
         },
         "insee_category":{
            "code":"PE",
            "name":"Petite entreprise"
         },
         "last_legal_update_date":"2022-09-25",
         "establishments_count":0
      },
      "contacts":{
         "main_corporate_officier":{
            "lastName":"ACINVEST",
            "name":"ACINVEST",
            "role":"Président",
            "role_start_date":"2021-03-17",
            "role_end_date":"",
            "company":true,
            "registration_number":"834282527"
         },
         "corporate_officiers":[
            {
               "lastName":"ACINVEST",
               "name":"ACINVEST",
               "role":"Président",
               "role_start_date":"2021-03-17",
               "role_end_date":"",
               "company":true,
               "registration_number":"834282527"
            },
            {
               "lastName":"HEGOA",
               "name":"HEGOA",
               "role":"Directeur général",
               "role_start_date":"2021-03-17",
               "role_end_date":"",
               "company":true,
               "registration_number":"803477181"
            }
         ],
         "email":"contact@societeinfo.com",
         "emails":[
            {
               "value":"contact@societeinfo.com",
               "type":"generic",
               "email_test_result":"Risky",
               "email_test_reason":"Deliverable",
               "email_test_date":"2022-02-17",
               "email_webmail":false
            }
         ]
      },
      "web_infos":{
         "logo_url":"https://media.licdn.com/dms/image/C4E0BAQGQVw8sQSJ0BA/company-logo_200_200/0/1670859487862?e=1682553600&v=beta&t=-ryaZ7hrI7wLtk1kkFGi-b-8O1pt4L_78NRre0-fAys",
         "website_url":"http://www.societeinfo.com/",
         "websites":[
            {
               "domain":"societeinfo.com",
               "url":"http://www.societeinfo.com/",
               "description":"Toutes les données légales, web et les contacts emails BtoB des entreprises françaises. Data B2B, fichiers emails, LEADGEN, Prospection BtoB, Enrichissement de données, Annuaire entreprises, Génération de leads",
               "webmaster_phone":"01 70 37 76 66",
               "techno_types":[
                  "youtube",
                  "google-font-api",
                  "facebook-pixel",
                  "nginx",
                  "weglot",
                  "microsoft-365",
                  "lottiefiles",
                  "jquery",
                  "core-js",
                  "webpack",
                  "webflow",
                  "recaptcha",
                  "hsts",
                  "open-graph",
                  "axeptio",
                  "hubspot",
                  "module-federation",
                  "google-tag-manager",
                  "google-hosted-libraries"
               ],
               "metadata":{
                  "owner_registration_number":"830134383",
                  "website_crawl_date":"2022-12-14",
                  "domain_creation_date":"2015-10-12"
               }
            }
         ],
         "linkedin":{
            "url":"https://www.linkedin.com/company/societeinfo-com/",
            "id":"societeinfo-com",
            "tech_id":"10250344",
            "name":"Societeinfo.com",
            "description":"Fruit de l’Open Data et des dernières technologies Big Data, Societeinfo vous offre :\n-\tPlus de 12 millions de profils de sociétés & 20 millions de contacts\n-\tDes millions de contacts mails, tel et réseaux sociaux\n-\tUn moteur de recherche sémantique révolutionnaire vous permettant d’hypercibler vos marchés\n\nAvec societeinfo.com, vous pourrez notamment :\n-\tGénérer des listes de prospection ou des fichiers d’emailing ciblés \n-\tEnrichir efficacement votre fichier client \n-\tIdentifier rapidement un marché ou un segment de marché à partir de mots ou expressions clés\n\nSoucieux de mettre à disposition nos données à la portée de tous nous avons développé à la fois une interface web et une puissante API vous permettant d’accéder facilement et à moindre coût à toute la donnée BtoB !\n\nTestez et dopez votre prospection commerciale directement sur https://societeinfo.com/\n\nL’équipe Societeinfo.com",
            "follower_count":762,
            "employees_range":"2-10",
            "employees_count":14,
            "crawl_date":"2023-01-26"
         },
         "twitter":{
            "url":"https://twitter.com/@SocieteInfo"
         },
         "facebook":{

         },
         "wikipedia":{

         },
         "youtube":{

         },
         "instagram":{

         }
      },
      "financials":{
         "last_sales":970000,
         "last_profit":10657,
         "last_staff":14,
         "years":[
            {
               "year":"2023",
               "staff":14,
               "staff_metadata":{
                  "estimated":true
               }
            },
            {
               "year":"2022",
               "sales":970000,
               "staff":11,
               "sales_metadata":{
                  "estimated":true
               },
               "staff_metadata":{
                  "estimated":true
               }
            },
            {
               "year":"2021",
               "sales":710000,
               "staff":8,
               "sales_metadata":{
                  "estimated":true
               },
               "staff_metadata":{
                  "estimated":true
               }
            },
            {
               "year":"2020",
               "sales":70000,
               "sales_metadata":{
                  "estimated":true
               }
            },
            {
               "year":"2019",
               "sales":70000,
               "sales_metadata":{
                  "estimated":true
               }
            },
            {
               "year":"2017",
               "sales":26696,
               "profit":10657,
               "closing_date":"2017-12-31",
               "sales_metadata":{
                  "estimated":false
               },
               "profit_metadata":{
                  "estimated":false
               }
            }
         ],
         "last_staff_sources":[
            {
               "source":"Linkedin",
               "field":"employees_range",
               "range_value":"2-10",
               "date":"2023-01-26",
               "estimated":false
            },
            {
               "source":"Linkedin",
               "field":"employees_count",
               "value":14,
               "date":"2023-01-26",
               "estimated":false
            }
         ]
      },
      "mark_infos":{

      },
      "actes":[
         {
            "date":"2022-08-20",
            "type":"Décision(s) du président",
            "description":"Augmentation du capital social "
         },
         {
            "date":"2022-08-20",
            "type":"Statuts mis à jour"
         },
         {
            "date":"2021-03-17",
            "type":"Décision(s) des associés",
            "description":"Changement relatif à la date de clôture de l'exercice social"
         },
         {
            "date":"2021-03-17",
            "type":"Décision(s) des associés",
            "description":"Changement de président"
         },
         {
            "date":"2021-03-17",
            "type":"Décision(s) des associés",
            "description":"Changement de directeur général"
         },
         {
            "date":"2021-03-17",
            "type":"Statuts mis à jour"
         },
         ...
      ]
   }
}

Ce service vous permet d'enrichir vos données si vous ne disposez pas du numéro SIREN de l'entreprise. Il retourne les données complètes de l'entreprise.

Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/company.json?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API
name Oui Nom de l'entreprise
street Oui Rue et voie OU voie
postal_code Oui Code postal
city Oui Ville
domain_name Oui Nom de domaine OU url du site web
email Oui adresse email
first_name Oui Prénom d'un mandataire/employé
last_name Oui Nom d'un mandataire/employé
full_name Oui Prénom Nom / Nom prénom d'un mandataire/employé
linkedin_url Oui URL Linkedin entreprise (official/admin/sales navigator) ou profil
registration_number Oui SIREN/SIRET l'entreprise
min_match_score 0 Oui Ne retourne un résultat que si le score de matching match_info.score est supérieur au score minimum spécifié. Double entre 0.0 et 1.0

Combinaisons supportées

Combinaisons Supportée Pertinence
name, street, postal_code, city OUI Killer
name, street OUI Killer
name, postal_code, city OUI Good
name, city OUI Good
name, postal_code OUI Good
street OUI Weak
name OUI Depends :)
domain_name ET/OU email OUI Good
domain_name ET/OU email, name OUI Killer
domain_name, name OUI Killer
Linkedin corporate / profil OUI Good
Linkedin + une autre combinaison OUI Killer
first_name, last_name, full_name + autre combinaison OUI Killer

Réponse

Le format de réponse de la société est similaire au service Get Company

Le champs match_info.score indique la pertinence du matching. En dessous de 0.3 le résultat devient aléatoire.

Autocomplete Company

curl "https://societeinfo.com/app/rest/api/v2/companies.json/autocomplete?query=smart%20da&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "total":760,
   "currentPage":1,
   "totalPages":153,
   "searchMode":"autocomplete",
   "sorts":[
      "score"
   ],
   "result":[
      {
         "id":"593b6fa6b3a2feb79d4f9f39",
         "name":"SMART DATA",
         "formatted_address":"92200 Neuilly-sur-Seine",
         "lng":2.2593109,
         "lat":48.8854852
      },
      {
         "id":"5a6ab622b3a2abb87f16dfe7",
         "name":"SMART DATA",
         "formatted_address":"92000 Nanterre",
         "lng":2.2050135,
         "lat":48.8887668
      },
      {
         "id":"5879768ab3a2806717f1b100",
         "name":"SMART DIS",
         "formatted_address":"75017 Paris",
         "lng":2.3078388,
         "lat":48.8833078
      },
      ...
   ]
}

Ce service est recommandé pour l'intégration de formulaires de recherche d'entreprise avec autocompletion. Il permet la recherche par caractère sur les noms et villes des entreprises. Le service supporte aussi les codes SIREN/SIRET

Les données d'entreprise renvoyées sont synthétiques (nom, adresse formattée, géolocation). Pour obtenir les informations détaillées, passez le paramètre ID dans le service Get Company

Une sandbox avec un exemple en jquery est disponible sur github ici

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/companies.json/autocomplete?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API.
limit 5 Oui Nombre de résultats par page. Limité à 25.
query Oui Caractères spécifiés pour la recherche

Advanced URL Parameters

Des paramètres avancés peuvent être spécifiés pour limiter les résultats de recherche à certaines activités ou formes juridiques

Paramètre Defaut Optionnel Description
active true Oui Inclue dans les résultats les entreprises inactives. Les valeurs possibles sont true ou false
withEstablishments false Oui Inclue les établissements. Les valeurs possibles sont true ou false
nafLevel Oui Filtre les entreprises avec la codification NAF définie. Exemple : nafLevel=61&nafLevel=6201Z
nafLevelsExclude Oui Ajoutez ce paramètre pour exclure les codes NAF définis. Les valeurs possibles sont true ou false
juridicalFormLevel Oui Filtre les entreprises avec la codification des formes juridiques définie. Exemple : juridicalFormLevel=1&juridicalFormLevel=57
juridicalFormlevelsExclude Oui Ajoutez ce paramètre pour exclure les formes juridiques définies. Les valeurs possibles sont true ou false
placeId Oui Interrogez le service Place Autocomplete, puis spécifiez les identifiants de places retournés. Filtre les entreprises par région/département/code postal/ville/rue. Exemple : placeId=ID1&placeId=ID2
convention_collective_code Oui Filtre les entreprises selon une liste d'identifiants de conventions collectives. Exemple : convention_collective_code=0016,3216
with_convention_collective Oui Filtre les entreprises disposant d'une convention collective. Les valeurs possibles sont true ou false

Autocomplete Company V3

curl "https://societeinfo.com/app/rest/api/v3/companies.json/autocomplete?query=smart%20data&key=DEMO"
{
   "success":true,
   "total":10000,
   "currentPage":1,
   "totalPages":2000,
   "searchMode":"autocomplete",
   "sorts":[
      "score"
   ],
   "result":[
      {
         "id":"593b6fa6b3a2feb79d4f9f39",
         "name":"SMART DATA",
         "formatted_address":"92200 NEUILLY-SUR-SEINE"
      },
      {
         "id":"63474e01c25eb200e588b342",
         "name":"DATA-SMART",
         "formatted_address":"75007 PARIS"
      },
      {
         "id":"5a6ab622b3a2abb87f16dfe7",
         "name":"SMART DATA",
         "formatted_address":"95870 BEZONS"
      },
      ...
   ]
}

[BETA]

Cette version de l'autocomplete est utilisée sur notre application web

La V3 de l'autocomplete ne fonctionne pas sur le principe du N-GRAM, des termes complets doivent être saisis.

Le traitement des termes de la query est plus avancé sur cette version : dénomination, mandataires, bénéficiaires effectifs, localisation...

Cette version ne nécessite pas de paramètres avancés.

HTTP Request

GET https://societeinfo.com/app/rest/api/v3/companies.json/autocomplete?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API.
limit 5 Oui Nombre de résultats par page. Limité à 25.
query Oui Caractères spécifiés pour la recherche

Search Companies

curl "https://societeinfo.com/app/rest/api/v2/companies.json?query=big%20data&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "total":9090,
   "totalContacts":227261,
   "currentPage":1,
   "totalPages":910,
   "searchMode":"keyword",
   "sorts":[
      "score"
   ],
   "result":[
      {
         "id":"59325baab3a258592ea0f216",
         "registration_number":"830015210",
         "full_registration_number":"83001521000016",
         "legal_type":"Siege",
         "name":"LANSROD BIG DATA",
         "activity":"Conseil en systèmes et logiciels informatiques",
         "formatted_address":"75008 Paris",
         "lng":2.3183,
         "lat":48.8763
      },
      {
         "id":"58796e94b3a2806717cd9ce8",
         "registration_number":"537750077",
         "full_registration_number":"53775007700027",
         "legal_type":"Siege",
         "name":"BIG DATA SERVICES",
         "activity":"Conseil en systèmes et logiciels informatiques",
         "formatted_address":"92200 Neuilly-sur-Seine",
         "lng":2.2695658,
         "lat":48.884683
      }
     ...
   ]
}

Ce service permet une recherche multi-critères sur l'ensemble des sociétés. Ajustez le paramètre searchMode pour piloter le moteur de recherche

Les données d'entreprise renvoyées sont dans un format synthétique (nom, activité, adresse formattée, géolocation). Pour obtenir les informations détaillées, utilisez ensuite le service de recherche par SIREN/SIRET.

Pour ajouter des critères avancés sur les sociétés possédant des contacts, consultez la section Search Contacts

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description Valeurs possibles
key Non Votre clé d'API.
page 1 Oui Numéro de la page de résultats
limit 10 Oui Nombre de résultats par page. Limité à 25.
query Oui Termes spécifiés pour la recherche
searchMode keyword Oui Spécifie quel type de recherche est appliqué à la query. (voir la liste ci-dessous)
placeId Oui Interrogez le service Place Autocomplete, puis spécifiez les identifiants de places retournés. Filtre les entreprises par région/département/code postal/ville/rue. Exemple : placeId=ID1&placeId=ID2
where Oui Filtre les entreprises avec le code postal/la ville définie
active true Oui Inclue dans les résultats les entreprises inactives. Les valeurs possibles sont true ou false
withEstablishments false Oui Inclue les établissements. Les valeurs possibles sont true ou false
nafLevel Oui Filtre les entreprises avec la codification NAF définie. Exemple : nafLevel=61&nafLevel=6201Z
nafLevelsExclude Oui Ajoutez ce paramètre pour exclure les codes NAF définis. Les valeurs possibles sont true ou false
juridicalFormLevel Oui Filtre les entreprises avec la codification des formes juridiques définie. Exemple : juridicalFormLevel=1&juridicalFormLevel=57
juridicalFormlevelsExclude Oui Ajoutez ce paramètre pour exclure les formes juridiques définies. Les valeurs possibles sont true ou false
convention_collective_code Oui Filtre les entreprises selon une liste d'identifiants de conventions collectives. Exemple : convention_collective_code=0016,3216
with_convention_collective Oui Filtre les entreprises disposant d'une convention collective. Les valeurs possibles sont true ou false
minsales Oui Filtre les entreprises avec un chiffre d'affaire supérieur.
maxsales Oui Filtre les entreprises avec un chiffre d'affaire inférieur.
minprofits Oui Filtre les entreprises avec un bénéfice supérieur.
maxprofits Oui Filtre les entreprises avec un bénéfice inférieur.
minstaff Oui Filtre les entreprises avec un effectif supérieur.
maxstaff Oui Filtre les entreprises avec un effectif inférieur.
mincreationdate Oui Filtre les entreprises avec une date de création supérieur. (format YYYYMMDD)
maxcreationdate Oui Filtre les entreprises avec une date de création inférieur. (format YYYYMMDD)
minceobirthdate Oui Filtre les entreprises dont la date de naissance du ceo est supérieur. (format YYYYMMDD)
maxceobirthdate Oui Filtre les entreprises dont la date de naissance du ceo est inférieur. (format YYYYMMDD)
withsite Oui avec un site web identifié. Les valeurs possibles sont true ou false
withphone Oui avec un téléphone identifié. Les valeurs possibles sont true ou false
withLinkedin Oui avec un compte linkedin corporate identifié. Les valeurs possibles sont true ou false
withemail Oui avec un email générique identifié. Les valeurs possibles sont true ou false
email_test_status all Oui Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe
withFacebook Oui avec un compte facebook identifié. Les valeurs possibles sont true ou false
withtwitter Oui avec un compte twitter identifié. Les valeurs possibles sont true ou false
min_linkedin_followers Oui Filtre les entreprises avec un nombre de follower linkedin supérieur.
max_linkedin_followers Oui Filtre les entreprises avec un nombre de follower linkedin inférieur.
withHighlight false Oui Ajoutez ce paramètre pour ajouter à la réponse la source des mots clés. Les valeurs possibles sont true ou false
analytics Oui Filtre les entreprises selon des valeurs analytiques (voir la liste ci-dessous) comme par exemple l'éxcédent brut d'exploitation, EBE (format de filtre d'une mesure: NomMesure @ ValeurMin (optionel) @ ValeurMax (optionel)) EBE@2000000@4000000,EBE_CA@0.08
events Oui Filtre les entreprises selon les évènements stratégiques (voir la liste ci-dessous dans le catalogue des évènements d'entreprises) ( format de filtre d'un évènement : EvtNiv1 @ EvtNiv2 (optionel) @ SourceÉmeteurEvt (optionel) @ nbMoisAnciennetéMax (optionel) @ nbMoisAnciennetéMin (optionel) @ minDate (optionel) @ maxDate (optionel)). Il est possible d'ajouter plusieurs évènements dans le filtre en utilisant le séparateur ",". Cela entraînera une fusion dans le résultat (et non une intersection). EVT_39@TYPE_EVT_397@@12,EVT_2@TYPE_EVT_441@Le Progrès de Lyon@@@20220515@20230514
web_technos Oui Filtre les entreprises selon les identifiants des technos utilisées. Exemple : web_technos=magento&web_technos=hubspot Cette exemple filtrera toutes les sociétés utilisant Magento ou Hubspot.
sort score Oui Spécifie le tri des résultat. Valeurs possibles dans le tableau suivant (voir la liste ci-dessous)

Search Mode

Le paramètre SearchMode permet de spécifier les types de données sur lequels la query est appliquée

Nom Description
keyword Applique la query sur les contenus texte associé à l'entreprise (sources légales, code APE, sites web, réseaux sociaux...). Applique la personQuery sur l'ensemble des données de contact. Supporte les opérateurs booléens AND, OR, NOT (défaut)
legalname Applique la query sur les termes de la raison sociale.
name Applique la query sur les noms (dénomination, nom commercial, sigle) et marques.
autocomplete Applique la query sur les caractères de la raison sociale. Cette option revient à utiliser le service dédié d'AutoComplete (personQuery non appliqué).
auto Exécute une query 'legalname', puis une query 'keyword' si le score de la query 'legalname' est insuffisant.

Sort

Nom Description
score Pertinence
salesDesc Chiffre d'affaire décroissant
salesAsc Chiffre d'affaire croissant
salesGrowthDesc Variation chiffre d'affaire décroissant
salesGrowthAsc Variation chiffre d'affaire croissant
profitDesc Bénéfice décroissant
profitAsc Bénéfice croissant
profitGrowthDesc Variation bénéfice décroissant
profitGrowthAsc Variation bénéfice croissant
staffDesc Effectifs décroissants
staffAsc Effectifs croissants
staffGrowthDesc Variation effectifs décroissant
staffGrowthAsc Variation effectifs croissant
riskLevelDesc Risque décroissant
riskLevelAsc Risque croissant
creationDateDesc Date de création décroissante
creationDateAsc Date de création croissante
twitterFollowerDesc Followers twitter décroissant
alexaRankAsc Rank Alexa croissant
totalMarksDesc Nombre de marques décroissant

Catalogue des ratios financiers societeinfo inclus dans la recherche

Nom Description
CA_NET_TOTAL Chiffre d'affaire Total
CA_NET_FR CA France
CA_NET_EXPORT CA Export;Dont CA réalisé à l'export
TOTAL_ACHATS Achats
TOTAL_SALAIRES_CHARGES_EXT Salaires et Charges externes
REX Résultat d'exploitation
IS Impôts sur les bénéfices
RESULTAT_NET Résultat net
TOTAL_TRESO Trésorerie
CAPITAUX_PROPRES Capitaux propres
TOTAL_PASSIF Total Passif
MARGE_BRUTE Marge brute
EBE Excédent brut d'exploitation
RCAI Résultat courant avant impôt
EBE_CA Poids de l'EBE sur le CA
LRE Ratio de liquidité réduite
BFR_JCA BFR en jour de CA
BFRE_JCA BFRE en jour de CA
DETTES_EBE Nombre d'années d'EBE équivalent à la dette
DSO Délai de règlement client moyen en jour de CA
DPO Délai de règlement fournisseur moyen en jour d'achat
GEARING Taux d'endettement net (Gearing)
CAF_CA Ratio CAF sur CA
SAL_CA Ratio Salaires sur CA
INTENS_K Instensité capitalisitique
CAP_REMB Capacité de remboursement
VAR_BFRE_CA Variation du poids du BFRE sur CA
CAGR Taux de croissance annuel moyen

Catalogue des évènements d'entreprises societeinfo inclus dans la recherche

EvtNiv1 Description EvtNiv1 EvtNiv2 Description EvtNiv2
EVT_15 Fusion, acquisition, prise de participation TYPE_EVT_406 Fusion et acquisition d’entreprise
EVT_15 Fusion, acquisition, prise de participation TYPE_EVT_407 Intention d’achat, rumeur d’opération
EVT_15 Fusion, acquisition, prise de participation TYPE_EVT_408 Prise de participation minoritaire
EVT_1 Actualité financière TYPE_EVT_279 Avis de notations financières d’agences
EVT_1 Actualité financière TYPE_EVT_280 Introduction en bourse
EVT_1 Actualité financière TYPE_EVT_281 Levées de fonds, augmentation de capital
EVT_1 Actualité financière TYPE_EVT_281 Levées de fonds, augmentation de capital
EVT_1 Actualité financière TYPE_EVT_282 Publications de résultats
EVT_37 Recrutement TYPE_EVT_444 Recrutement
EVT_37 Recrutement TYPE_EVT_445 Augmentation stratégique des effectifs
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_418 Direction des achats et services généraux
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_419 Direction administrative et financière
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_420 Direction commerciale et marketing
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_421 Direction Exploitation
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_422 Direction export
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_423 Direction générale
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_424 Direction immobilière
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_425 Direction Innovation
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_426 Direction juridique
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_427 Direction Logistique
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_428 Direction des ressources humaines
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_429 Direction des systèmes d'information
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_430 Direction Technique
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_431 Direction Zone
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_432 Direction développement durable
EVT_25 Nomination dans l'équipe de direction TYPE_EVT_433 Direction Etudes / Recherche / Développement
EVT_10 Développement TYPE_EVT_400 Croissance du chiffre d'affaires
EVT_10 Développement TYPE_EVT_401 Création de filiales, établissements, franchises (export)
EVT_10 Développement TYPE_EVT_402 Création de filiales, établissements, franchises (domestique)
EVT_10 Développement TYPE_EVT_403 Stratégie de la marque, identité visuelle
EVT_10 Développement TYPE_EVT_404 Nouveau concept de distribution
EVT_10 Développement TYPE_EVT_405 Innovation, nouveaux marchés, contrats
EVT_19 Investissement productif TYPE_EVT_409 Bâti
EVT_19 Investissement productif TYPE_EVT_410 Machines
EVT_19 Investissement productif TYPE_EVT_411 Non précisé
EVT_19 Investissement productif TYPE_EVT_412 Regroupement de sites/Rationalisation
EVT_27 Organisation, rationalisation, externalisation TYPE_EVT_434 Externalisation de fonctions supports / logistique / informatique
EVT_27 Organisation, rationalisation, externalisation TYPE_EVT_435 Optimisation des fonctions supports, moyens centraux
EVT_27 Organisation, rationalisation, externalisation TYPE_EVT_436 Réduction des charges, des coûts
EVT_39 Sinistres TYPE_EVT_397 Incendie
EVT_39 Sinistres TYPE_EVT_398 Inondation, Tempête
EVT_39 Sinistres TYPE_EVT_399 Effraction, vandalisme
EVT_2 Actualités sociales, difficultés TYPE_EVT_440 Délocalisation et démantèlement d’unité
EVT_2 Actualités sociales, difficultés TYPE_EVT_441 Grève, Tension sociale
EVT_2 Actualités sociales, difficultés TYPE_EVT_442 Pertes de marché
EVT_2 Actualités sociales, difficultés TYPE_EVT_443 Restructuration et licenciement
EVT_2 Actualités sociales, difficultés TYPE_EVT_454 Décès du dirigeant
EVT_2 Actualités sociales, difficultés TYPE_EVT_455 Dépôt de plaintes
curl "https://societeinfo.com/app/rest/api/v2/companies.json?query=big%20data&contact_domain_code=IT&contact_role_query=data%20scientist&email_type=personal&withHighlight=true&key=DEMO"

La commande retourne le JSON suivant :

{
  "success": true,
  "total": 378,
  "totalContacts": 1227,
  "currentPage": 1,
  "totalPages": 38,
  "searchMode": "keyword",
  "sorts": [git 
    "score"
  ],
  "result": [
    {
      "id": "5fc19b830932a5204d6575c0",
      "registration_number": "790172043",
      "full_registration_number": "79017204300065",
      "legal_type": "Siege",
      "name": "CRAYON FRANCE",
      "activity": "Le conseil en gestion d'actifs logiciels, le négoce de logiciels, la formation",
      "formatted_address": "92310 SÈVRES",
      "lng": 2.2176,
      "lat": 48.8229,
      "highlights": [
        {
          "data_category": "Contact",
          "data_source": "Linkedin",
          "texts": [
            "<em><b>Data</b></em> <em><b>scientist</b></em>",
            "<em><b>i80</b></em>"
          ]
        },
        {
          "data_category": "Company",
          "data_source": "Linkedin",
          "data_field": "Title",
          "texts": [
            "We provide guidance on the best solutions for our clients’ business needs and budget with software, cloud, AI and <em><b>big</b></em> <em><b>data</b></em>"
          ]
        }
      ]
    },
  ...
  ]
}

Réponse

Champs Description Valeurs possibles
total Nombre de sociétés
totalContacts Nombre de contacts dans les sociétés identifiées
currentPage page courante
totalPages Nombre total de pages
searchMode Mode de recherche Voir bloc 'Search Mode'
sorts Mode de tri Voir bloc 'Sort'
result.id Identifiant technique
result.registration_number SIREN
result.full_registration_number SIRET
result.legal_type Type établissement Siege, SecondaryEstablishment
result.name Dénomination
result.activity Objet social
result.formatted_address Code postal et Ville
result.lng longitude
result.lat latitude
result.highlights.data_category Catégorie de donnée Company, Contact
result.highlights.data_source Source de donnée Legal, Website, Twitter, Linkedin
result.highlights.data_field Type de donnée Name, Title, Content
result.highlights.texts Extraits de texte avec mots clés




Search Companies By Officiers

curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_first_name=antoine&contact_last_name=onnen&contact_birth_date=19770307&key=DEMO"

La commande retourne le JSON suivant :

{
  "success":true,
  "total":2,
  "totalContacts":2,
  "currentPage":1,
  "totalPages":1,
  "searchMode":"all",
  "sorts":[
    "score"
  ],
  "result":[
    {
      "id":"593b6fa6b3a2feb79d4f9f39",
      "registration_number":"830134383",
      "full_registration_number":"83013438300017",
      "legal_type":"Siege",
      "name":"SMART DATA",
      "activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
      "formatted_address":"92200 NEUILLY-SUR-SEINE",
      "lng":2.2593109,
      "lat":48.8854852
    },
    {
      "id":"5879740fb3a2806717e65fc1",
      "registration_number":"803477181",
      "full_registration_number":"80347718100017",
      "legal_type":"Siege",
      "name":"HEGOA",
      "activity":"Développement informatique, conseil en systèmes et logiciels informatiques. ",
      "formatted_address":"75018 PARIS",
      "lng":2.3439171,
      "lat":48.896718
    }
  ]
}
curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_registration_number=538520487&key=DEMO"

La commande retourne le JSON suivant :

{
  "success":true,
  "total":2,
  "totalContacts":2,
  "currentPage":1,
  "totalPages":1,
  "searchMode":"all",
  "sorts":[
    "score"
  ],
  "result":[
    {
      "id": "5879590ab3a28067176b87b9",
      "registration_number": "332522341",
      "full_registration_number": "33252234100095",
      "legal_type": "Siege",
      "name": "BOUCHERIES ANDRE",
      "activity": "Commerce de détails de produits alimentaires. ",
      "formatted_address": "69140 Rillieux-la-Pape",
      "lng": 4.9,
      "lat": 45.8167
    },
    ...
  ]
}

Recherche toutes les entreprises dans lesquelles une personne physique/morale est mandataire

GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY

Paramètres pour une personne physique

Paramètre Defaut Optionnel Description
contact_first_name Oui Prénom du mandataire
contact_last_name Oui Nom du mandataire
contact_birth_date Oui Date de naissance du mandataire (format YYYYMMDD)


Paramètres pour une personne morale (entreprise)

Paramètre Defaut Optionnel Description
contact_registration_number Non SIREN mandataire


Paramètres optionnels

Paramètre Defaut Optionnel Description
contact_level_code Oui Filtre le/les niveau(x) de responsabilité des contacts. Exemple : contact_level_code=DIRECTEUR&contact_level_code=RESPONSABLE (voir liste ci-dessous)
contact_domain_code Oui Filtre le/les domaine(s) d'activité des contacts. Exemple : contact_domain_code=MARKETING&contact_domain_code=COMMUNICATION (voir liste ci-dessous)
contact_role_query Oui Filtre les rôle des mandataires. Exemple : gérant OR président OR directeur




Contact API

Enrich contact

curl "https://societeinfo.com/app/rest/api/v2/contact.json?domain_name=societeinfo.com&first_name=antoine&last_name=onnen&key=DEMO"
curl "https://societeinfo.com/app/rest/api/v2/contact.json?email=antoine@societeinfo.com&key=DEMO"

La commande retourne le JSON suivant :


{
   "success":true,
   "contact":{
      "id":"830134383621532388",
      "civility":"Mr",
      "firstName":"Antoine",
      "lastName":"ONNEN",
      "birth_date":"1977-03-07",
      "domain_code":"DG",
      "domain_label":"Direction Générale",
      "level_code":"DIRIGEANT",
      "level_label":"Dirigeant",
      "role":"Co-Founder/CTO",
      "email":"antoine.onnen@societeinfo.com",
      "email_score":0.9,
      "email_test_result":"Safe to Send",
      "email_test_reason":"Deliverable",
      "email_test_date":"2022-11-17",
      "email_webmail":false,
      "linkedin_url":"https://www.linkedin.com/in/antoine-onnen-4376242/",
      "extraction_date":"2018-04-01",
      "hashcode":"1267633835",
      "contact_score":0.95
   },
   "company":{
      "id":"593b6fa6b3a2feb79d4f9f39",
      "registration_number":"830134383",
      "full_registration_number":"83013438300017",
      "legal_type":"Siege",
      "name":"SMART DATA",
      "activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
      "formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 NEUILLY-SUR-SEINE",
      "ape_code":"6201Z",
      "ape_name":"Programmation informatique",
      "address":{
         "street":"176 AVENUE CHARLES DE GAULLE",
         "postal_code":"92200",
         "city":"NEUILLY-SUR-SEINE",
         "country_code":"FR",
         "country":"FRANCE",
         "lng":2.2697,
         "lat":48.8846
      },
      "juridical_form_code":"5710",
      "juridical_form_name":"Société par actions simplifiée",
      "website_url":"http://www.societeinfo.com/",
      "linkedin_url":"https://www.linkedin.com/company/societeinfo-com/",
      "generic_email":"contact@societeinfo.com",
      "last_sales":970000,
      "last_profit":10657,
      "last_staff":14,
      "insee_category":{
         "code":"PE",
         "name":"Petite entreprise"
      }
   }
}

Ce service vous permet d'enrichir un contact

Spécifiez uniquement les datas donc vous disposez (prenom, nom, nom société, domaine, linkedin...). Et nos algos de matching feront le reste !

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/contact.json?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API
first_name Oui Prénom
last_name Oui Nom
full_name Oui Prénom Nom / Nom prénom
name Oui Nom de l'entreprise
street Oui Rue et voie OU voie de l'entreprise
postal_code Oui Code postal de l'entreprise
city Oui Ville de l'entreprise
domain_name Oui Nom de domaine OU url du site web
registration_number Oui SIREN/SIRET
email Oui adresse email
linkedin_url Oui URL Linkedin profil
company_linkedin_url Oui URL Linkedin entreprise (official/admin/sales navigator)
registration_number Oui SIREN/SIRET l'entreprise
withEmail Oui Filtre les contacts avec email
withLinkedin Oui Filtre les contacts avec linkedin
contact_score Oui Score minimum du contact

Combinaisons supportées

Un ou plusieurs paramètres de contact (prenom, nom, email) et au moins un paramètre entreprise (nom, adresse, linkedin corporate).

Si le paramètre linkedin_url est spécifié, les paramètres entreprises sont optionnels

Réponse

Champs Description Valeurs possibles
contact.id Identifiant du contact
contact.civility Civilité Mr, Mrs
contact.firstName Prénom
contact.lastName Nom
contact.domain_code Code du domaine d'activité Valeurs possibles
contact.domain_label Libellé du domaine d'activité Valeurs possibles
contact.level_code Code du niveau de responsabilité Valeurs possibles
contact.level_label Libellé du niveau de responsabilité Valeurs possibles
contact.role Mandat ET/OU Rôle linkedin
contact.email Email
contact.email_score Score pertinence email Double entre 0.0 et 1.0
contact.email_test_result Résultat test email Safe to Send, Risky, Invalid, Unknown
contact.email_test_reason Raison test email Deliverable, Bounce, Accept All, Unreachable
contact.email_test_date Date test email
contact.email_webmail Webmail ou non (gmail.com, yahoo.fr...) true, false
contact.linkedin_url Url profil linkedin
contact.extraction_date Date extraction linkedin
contact.hashcode Hash sur la donnée de contact
contacts.contact_score Score du contact VERY_GOOD [0,85-1], GOOD=[0.7,0,85], AVERAGE=[0.5,0.7], RISKY=[0,0.5]
company.id Identifiant societeinfo de la société
company.registration_number SIREN
company.full_registration_number SIRET
company.legal_name Forme juridique
company.legal_type Type établissement Siege, SecondaryEstablishment
company.name Dénomination sociale
company.activity Objet social
company.formatted_address Adresse formatée
company.ape_code Code APE Code NAF Niv.5
company.ape_label Libellé code APE
company.address.street Adresse
company.address.postal_code Code postal
company.address.city Ville
company.juridical_form_code Forme juridique code Niv.3
company.juridical_form_name Forme juridique
company.website_url Site web principal
company.linkedin_url Url Linkedin corporate
company.generic_email Email générique principal
company.generic_phone Téléphone standard principal
company.last_sales Dernier chiffre d'affaire
company.last_profit Dernier résultat net
company.last_staff Dernier nombre d'employés
company.insee_category.code Code de la catégorie INSEE TPE, PE, ME, ETI, GE, NON_DEFINIE
company.insee_category.name libellé de la catégorie INSEE




Get Contacts By Company

curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "company":{
      "id":"593b6fa6b3a2feb79d4f9f39",
      "registration_number":"830134383",
      "full_registration_number":"83013438300017",
      "legal_type":"Siege",
      "name":"SMART DATA",
      "activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
      "formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 NEUILLY-SUR-SEINE",
      "ape_code":"6201Z",
      "ape_name":"Programmation informatique",
      "address":{
         "street":"176 AVENUE CHARLES DE GAULLE",
         "postal_code":"92200",
         "city":"NEUILLY-SUR-SEINE",
         "country_code":"FR",
         "country":"FRANCE",
         "lng":2.2697,
         "lat":48.8846
      },
      "juridical_form_code":"5710",
      "juridical_form_name":"Société par actions simplifiée",
      "website_url":"http://www.societeinfo.com/",
      "linkedin_url":"https://www.linkedin.com/company/societeinfo-com/",
      "generic_email":"contact@societeinfo.com",
      "last_sales":970000,
      "last_profit":10657,
      "last_staff":14,
      "insee_category":{
         "code":"PE",
         "name":"Petite entreprise"
      }
   },
   "email_domains":[
      {
         "domain":"societeinfo.com",
         "pattern":"{first}.{last}"
      },
      {
         "domain":"societeinfo.com",
         "pattern":"{first}"
      }
   ],
   "contacts":[
      {
         "id":"830134383621532388",
         "civility":"Mr",
         "firstName":"Antoine",
         "lastName":"ONNEN",
         "birth_date":"1977-03-07",
         "domain_code":"DG",
         "domain_label":"Direction Générale",
         "level_code":"DIRIGEANT",
         "level_label":"Dirigeant",
         "role":"Co-Founder/CTO",
         "email":"antoine.onnen@societeinfo.com",
         "email_score":0.9,
         "email_test_result":"Safe to Send",
         "email_test_reason":"Deliverable",
         "email_test_date":"2022-11-17",
         "email_webmail":false,
         "linkedin_url":"https://www.linkedin.com/in/antoine-onnen-4376242/",
         "extraction_date":"2018-04-01",
         "hashcode":"1267633835",
         "contact_score":0.95
      },
      {
         "id":"8301343831281918940",
         "civility":"Mr",
         "firstName":"Alexandre",
         "lastName":"CONRAUD",
         "birth_date":"1987-04-23",
         "domain_code":"DG",
         "domain_label":"Direction Générale",
         "level_code":"DIRIGEANT",
         "level_label":"Dirigeant",
         "role":"Co-fondateur",
         "email":"alexandre.conraud@societeinfo.com",
         "email_score":0.9,
         "email_test_result":"Safe to Send",
         "email_test_reason":"Deliverable",
         "email_test_date":"2022-11-17",
         "email_webmail":false,
         "linkedin_url":"https://www.linkedin.com/in/alexandre-conraud/",
         "extraction_date":"2022-07-22",
         "hashcode":"534384522",
         "contact_score":0.69
      },
      ...
   ],
   "contacts_count":12,
   "emails":[

   ]
}

Ce service permet de récupérer les contacts d'une entreprise comportant un email ou un linkedin. Les contacts sont un mix des mandataires légaux, des profils des employés sur les réseaux sociaux et des emails corporate détectés sur le web.

Si uniquement des mandataires légaux sans linkedin ou email sont détectés, aucun résultat n'est renvoyé. En effet l'ensemble des mandataires sans linkedin/email est inclu pour 1 crédit dans le service Get Company

Identifiez l'entreprise avec le numéro SIREN

GET https://societeinfo.com/app/rest/api/v2/contacts.json/<registration_number>?key=YOUR_APIKEY

Paramètre Defaut Optionnel Description
key Non Votre clé d'API
registration_number Non Numéro SIREN de l'entreprise

URL Parameters

Les paramètres suivants vous permettent de limiter le nombre de contacts retournés par le service

Paramètre Defaut Optionnel Description
withemail Oui Filtre les contacts avec email. Valeur possible : true
email_test_status all Oui Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe
withlinkedin Oui Filtre les contacts avec linkedin. Valeur possible : true
withlegal Oui Filtre les contacts mandataires légaux. Valeur possible : true
contact_level_code Oui Filtre le/les niveau(x) de responsabilité des contacts. Exemple : contact_level_code=DIRECTEUR&contact_level_code=RESPONSABLE (voir liste ci-dessous)
contact_domain_code Oui Filtre le/les domaine(s) d'activité des contacts. Exemple : contact_domain_code=MARKETING&contact_domain_code=COMMUNICATION (voir liste ci-dessous)
contact_role_query Oui Ajout d'une requête sémantique sur les postes des contacts
contact_max Oui Nombre de contacts max dans la réponse

contact_level_code

Voir les valeurs possibles

contact_domain_code

Par exemple "python" renverra tous les postes intégrant le mot "python"

Voir les valeurs possibles

contact_role_query

Optionnel, Identifiez des mots clés dans spécifiques dans les postes

Par exemple "python" renverra tous les postes intégrant le mot "python"

Pour étendre les résultats, utilisez l'expression sémantique suivante : "python OR javascript"

Réponse

Champs Description Valeurs possibles
email_domains.domain Domain mail corporate
email_domains.pattern Pattern mail corporate
contacts.id Identifiant du contact
contacts.civility Civilité Mr, Mrs
contacts.firstName Prénom
contacts.lastName Nom
contacts.role Mandat ET/OU Rôle linkedin
contacts.email Email
contacts.email_score Score pertinence email Double entre 0.0 et 1.0
contacts.email_test_result Résultat test email Safe to Send, Risky, Invalid, Unknown
contacts.email_test_reason Raison test email Deliverable, Bounce, Accept All, Unreachable
contacts.email_test_date Date test email
contacts.email_webmail Webmail ou non (gmail.com, yahoo.fr...) true, false
contacts.linkedin_url Url profil linkedin
contacts.extraction_date Date extraction linkedin
contacts.hashcode Hash sur la donnée de contact
contacts.contact_score Score du contact VERY_GOOD [0,85-1], GOOD=[0.7,0,85], AVERAGE=[0.5,0.7], RISKY=[0,0.5]
emails.value Email détecté
emails.type Type email generic, personal
emails.sources Sources email
company.registration_number SIREN
company.full_registration_number SIRET
company.legal_name Forme juridique
company.legal_type Type établissement Siege, SecondaryEstablishment
company.name Dénomination sociale
company.activity Objet social
company.formatted_address Adresse formatée
company.ape_code Code APE
company.ape_label Libellé code APE
company.address.street Adresse
company.address.postal_code Code postal
company.address.city Ville
company.juridical_form_code Code forme juridique Forme juridique code Niv.3
company.juridical_form_name Libellé forme juridique
company.website_url Site web principal
company.linkedin_url Url Linkedin corporate
company.generic_email Email générique principal
company.generic_phone Téléphone standard principal
company.last_sales Dernier chiffre d'affaire
company.last_profit Dernier résultat net
company.last_staff Dernier nombre d'employés
company.insee_category.code Code de la catégorie INSEE TPE, PE, ME, ETI, GE, NON_DEFINIE
company.insee_category.name libellé de la catégorie INSEE




curl "https://societeinfo.com/app/rest/api/v2/contacts.json?domain_name=societeinfo.com&contact_domain_code=MARKETING&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "company":{
      "id":"593b6fa6b3a2feb79d4f9f39",
      "registration_number":"830134383",
      "full_registration_number":"83013438300017",
      "legal_type":"Siege",
      "name":"SMART DATA",
      "activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
      "formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 NEUILLY-SUR-SEINE",
      "ape_code":"6201Z",
      "ape_name":"Programmation informatique",
      "address":{
         "street":"176 AVENUE CHARLES DE GAULLE",
         "postal_code":"92200",
         "city":"NEUILLY-SUR-SEINE",
         "country_code":"FR",
         "country":"FRANCE",
         "lng":2.2697,
         "lat":48.8846
      },
      "juridical_form_code":"5710",
      "juridical_form_name":"Société par actions simplifiée",
      "website_url":"http://www.societeinfo.com/",
      "linkedin_url":"https://www.linkedin.com/company/societeinfo-com/",
      "generic_email":"contact@societeinfo.com",
      "last_sales":970000,
      "last_profit":10657,
      "last_staff":14,
      "insee_category":{
         "code":"PE",
         "name":"Petite entreprise"
      }
   },
   "email_domains":[
      {
         "domain":"societeinfo.com",
         "pattern":"{first}.{last}"
      },
      {
         "domain":"societeinfo.com",
         "pattern":"{first}"
      }
   ],
   "contacts":[
      {
         "id":"8301343831742052641",
         "civility":"Mrs",
         "firstName":"Afef",
         "lastName":"AYED",
         "domain_code":"MARKETING",
         "domain_label":"Marketing",
         "level_code":"RESPONSABLE",
         "level_label":"Responsable",
         "role":"Head of growth marketing",
         "email":"afef.ayed@societeinfo.com",
         "email_score":0.94,
         "email_test_result":"Safe to Send",
         "email_test_reason":"Deliverable",
         "email_test_date":"2023-01-19",
         "email_webmail":false,
         "linkedin_url":"https://www.linkedin.com/in/afef-ayed/",
         "extraction_date":"2022-12-30",
         "hashcode":"1689321661",
         "contact_score":0.98
      }
   ],
   "contacts_count":1,
   "emails":[  
   ]
}

Identifiez l'entreprise sans le numéro SIREN

Ces paramètres vous permetttent de chercher les contacts d'une entreprise sans disposer du numéro SIREN.

Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !

GET https://societeinfo.com/app/rest/api/v2/contacts.json?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API
name Oui Nom de l'entreprise
street Oui Rue et voie OU voie
postal_code Oui Code postal
city Oui Ville
domain_name Oui Nom de domaine OU url du site web
email Oui adresse email
linkedin_url Oui URL Linkedin
min_match_score 0 Oui Ne retourne un résultat que si le score de matching match_info.score est supérieur au score minimum spécifié. Double entre 0.0 et 1.0

Combinaisons supportées

Combinaisons Supportée Pertinence
name, street, postal_code, city OUI Killer
name, street OUI Killer
name, postal_code, city OUI Good
name, city OUI Good
name, postal_code OUI Good
street OUI Weak
name OUI Depends :)
domain_name ET/OU email OUI Good
domain_name ET/OU email, name OUI Killer
domain_name, name OUI Killer
Linkedin corporate OUI Good
Linkedin + une autre combinaison OUI Killer













curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?show_all_anonymized=true&key=DEMO"

La commande retourne le JSON suivant :


{
   "success":true,
   "contacts":[
      {
         "id":"830134383621532388",
         "civility":"Xx",
         "firstName":"Xxxxx",
         "lastName":"XXXXXXXX",
         "birth_date":"YYYY-MM-dd",
         "domain_code":"DG",
         "domain_label":"Direction Générale",
         "level_code":"DIRIGEANT",
         "level_label":"Dirigeant",
         "role":"Co-Founder/CTO",
         "email":"xx@xx.xx",
         "email_score":0.9,
         "email_test_result":"Safe to Send",
         "email_test_reason":"Deliverable",
         "email_test_date":"2022-11-17",
         "email_webmail":false,
         "linkedin_url":"https://fr.linkedin.com/in/x",
         "extraction_date":"2018-04-01",
         "anonymized":true,
         "hashcode":"1267633835",
         "contact_score":0.95
      },
      {
         "id":"8301343831281918940",
         "civility":"Xx",
         "firstName":"Xxxxx",
         "lastName":"XXXXXXXX",
         "birth_date":"YYYY-MM-dd",
         "domain_code":"DG",
         "domain_label":"Direction Générale",
         "level_code":"DIRIGEANT",
         "level_label":"Dirigeant",
         "role":"Co-fondateur",
         "email":"xx@xx.xx",
         "email_score":0.9,
         "email_test_result":"Safe to Send",
         "email_test_reason":"Deliverable",
         "email_test_date":"2022-11-17",
         "email_webmail":false,
         "linkedin_url":"https://fr.linkedin.com/in/x",
         "extraction_date":"2022-07-22",
         "anonymized":true,
         "hashcode":"534384522",
         "contact_score":0.69
      },
      ...
   ],
   "contacts_count":12
}
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?contact_ids=830134383621532388&key=DEMO"

La commande retourne le JSON suivant :


{
   "success":true,
   "contacts":[
      {
         "id":"830134383621532388",
         "civility":"Mr",
         "firstName":"Antoine",
         "lastName":"ONNEN",
         "birth_date":"1977-03-07",
         "domain_code":"DG",
         "domain_label":"Direction Générale",
         "level_code":"DIRIGEANT",
         "level_label":"Dirigeant",
         "role":"Co-Founder/CTO",
         "email":"antoine.onnen@societeinfo.com",
         "email_score":0.9,
         "email_test_result":"Safe to Send",
         "email_test_reason":"Deliverable",
         "email_test_date":"2022-11-17",
         "email_webmail":false,
         "linkedin_url":"https://www.linkedin.com/in/antoine-onnen-4376242/",
         "extraction_date":"2018-04-01",
         "hashcode":"1267633835",
         "contact_score":0.95
      }
   ],
   "contacts_count":1
}

Visualisez les contacts anonymisés et sélectionnez les rôles que vous souhaitez

Pour retourner l'ensemble des contacts d'une société sous forme anonymisée, spécifiez le paramètre 'show_all_anonymized' (voir exemple). En spécifiant ce paramètre, tous les contacts sont alors retournés gratuitement avec les champs non vides obfusqués à l'exception du champs 'role'

Visualisez, sélectionnez les rôles que vous souhaitez, puis interrogez le service avec le paramètre 'contact_ids' pour obtenir les contacts complets (voir exemple)

Rafraichissez vos données de contact

Si vous souhaitez vérifier la fraicheur de vos données de contacts, comparez vos données avec le champs 'hashcode'





Paramètre Defaut Optionnel Description
key Non Votre clé d'API
show_all_anonymized false Oui Active l'anonymisation des contacts
contact_ids Oui Liste des identifiants de contact à retourner séparés par une virgule









Search Contacts

curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_domain_code=IT&contact_role_query=data%20scientist&email_type=personal&key=DEMO"

La commande retourne le JSON suivant :

{
  "success":true,
  "total":1610,
  "totalContacts":3564,
  "currentPage":1,
  "totalPages":162,
  "searchMode":"keyword",
  "sorts":[
    "score"
  ],
  "result":[
    {
      "id":"587964c5b3a2806717a2dd45",
      "registration_number":"469500961",
      "full_registration_number":"46950096100831",
      "legal_type":"Siege",
      "name":"ArcelorMittal Distribution Solutions France",
      "activity":"la branche du fonds de commerce ayant pour activité l'achat, la préparation, la transformation, le conditionnement, le transport et la vente de plaque d'acier",
      "formatted_address":"51370 Saint-Brice-Courcelles",
      "lng":3.9833,
      "lat":49.2667
    },
    {
      "id":"58796634b3a2806717a93453",
      "registration_number":"484893110",
      "full_registration_number":"48489311000052",
      "legal_type":"Siege",
      "name":"INFOLOGIK",
      "activity":"Conseil en systèmes et logiciels informatiques",
      "formatted_address":"56100 Lorient",
      "lng":-3.3667,
      "lat":47.75
    },
    {
      "id":"587966a6b3a2806717ab2781",
      "registration_number":"489139436",
      "full_registration_number":"48913943601383",
      "legal_type":"Siege",
      "name":"BCA EXPERTISE SAS",
      "activity":"Évaluation des risques et dommages",
      "formatted_address":"92600 Asnières-sur-Seine",
      "lng":2.2833,
      "lat":48.9167
    },
    ...
  ]
}

Ce service permet de rechercher les sociétés contenant des contacts.

Les données d'entreprise renvoyées sont dans un format synthétique (SIREN, nom, activité, adresse formattée, géolocation). Requêtez ensuite par SIREN le service Get Contacts By Company pour obtenir les contacts de chaque société

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY

Company URL Parameters

Les critères société (forme juridique, chiffre d'affaire...) sont définis dans le service Search Companies

Contact URL Parameters

Paramètre Defaut Optionnel Description
contact_level_code Oui Filtre le/les niveau(x) de responsabilité des contacts. Exemple : contact_level_code=DIRECTEUR&contact_level_code=RESPONSABLE (voir liste ci-dessous)
contact_domain_code Oui Filtre le/les domaine(s) d'activité des contacts. Exemple : contact_domain_code=MARKETING&contact_domain_code=COMMUNICATION (voir liste ci-dessous)
contact_role_query Oui Ajout d'une requête sémantique sur les postes des contacts
email_type Oui Filtre les sociétés avec le/les types d'emails souhaités. Voir tableau email_type ci-dessous. Exemple : email_type=personal&email_type=withoutwebmail
email_test_status all Oui Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe
contact_source Oui Filtre l'origine des contacts. Les valeurs possibles sont legal,linkedin. Exemple contact_source=legal&contact_source=linkedin

Contact level

Le paramètre contact_level_code permet de spécifier les niveaux de responsabilité des contacts

Code Libellé
MANDATAIRE Mandataire
DIRIGEANT Dirigeant
GERANT Gérant
DIRECTEUR Directeur
RESPONSABLE Responsable
ASSIST Assistant
COLLAB Collaborateur
AUTRE Autre

Contact domain

Le paramètre contact_domain_code permet de spécifier le domaine d'activité des contacts

Code Libellé Disponible dans l'IHM
DG Direction Générale Oui
ADMIN_FINANCE Administration et Finance Oui
ACHAT Achats Oui
RH Ressources Humaines Oui
IT Informatique Oui
MARKETING Marketing Oui
COMMUNICATION Communication Oui
CONFORMITE Conformité Oui
COMMERCE Commerce Oui
JURIDIQUE Juridique Oui
R_D Recherche et Développement Oui
SAV Relation et support client Oui
PROD_LOGISTIQUE Production et Logistique Oui
AGRI Agricole Non
ARMEE Armée et Défense Non
ART Art et Design Non
AUTOMOBILE Automobile Non
BANQ_ASSUR Banque Assurance Non
BEAUTE Soin Beauté Cosmétique Non
BTP Construction Non
CAISSIER Personnel de caisse Non
CHR Café Hotellerie Restauration Non
FORMATION_ENSEIGN Formation et Enseignement Non
FUNERAIRE Services funéraires Non
LOISIR Loisir Non
MAGASIN Magasin Non
PHARMA Pharmacie Non
PRESSING Pressing Non
PUBLIC_SOCIAL Adminstration publiques et sociales Non
SECURITE Sécurité Non
SANTE Santé et Médical Non
TEXTILE Textile Non

Email Type

Le paramètre email_type permet de spécifier les types d'emails de la société

Nom Description
generic Avec emails génériques
personal Avec emails directs
withwebmail Avec webmails
withoutwebmail Sans webmails




Financial API

Get Financial

curl "https://societeinfo.com/app/rest/api/v2/financial/statements.json/342376332?statement=ANALYTICS&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "groups":[
      {
         "metadata":{
            "label":"Ratios financiers",
            "statement":"ANALYTICS",
            "currency_code":"EUR",
            "rows":[
               {
                  "code":"EBE",
                  "label":"Excédent brut d'exploitation",
                  "total":true
               },
               {
                  "code":"BFR",
                  "label":"Besoin en fonds de roulement",
                  "total":true
               },
               {
                  "code":"BFRE",
                  "label":"Besoin en fonds de roulement d'exploitation",
                  "total":true
               },
               {
                  "code":"BFRHE",
                  "label":"Besoin en fonds de roulement hors exploitation",
                  "total":true
               },
               {
                  "code":"FDR",
                  "label":"Fonds de roulement",
                  "total":true
               },
               {
                  "code":"CAF",
                  "label":"Capacité d'autofinancement",
                  "total":true
               },

               {
                  "code":"EBE_CA",
                  "label":"Poids de l'EBE sur le CA",
                  "total":true
               },
               {
                  "code":"LRE",
                  "label":"Ratio de liquidité réduite",
                  "total":true
               },
               {
                  "code":"BFR_CA",
                  "label":"BFR / CA",
                  "total":true
               },
               {
                  "code":"BFRE_CA",
                  "label":"BFRE / CA",
                  "total":true
               },
               {
                  "code":"BFR_JCA",
                  "label":"BFR en jour de CA",
                  "total":true
               },
               {
                  "code":"BFRE_JCA",
                  "label":"BFRE en jour de CA",
                  "total":true
               },
               {
                  "code":"DSO",
                  "label":"Délai de règlement client moyen en jour de CA",
                  "total":true
               },
               {
                  "code":"DPO",
                  "label":"Délai de règlement fournisseur moyen en jour d'achat",
                  "total":true
               },
               ...
            ]
         },
         "dates":[
            {
               "closing_date":"2020-12-31",
               "valid":true,
               "rows":[
                  {
                     "code":"EBE",
                     "value":-31765000
                  },
                  {
                     "code":"BFR",
                     "value":304799000
                  },
                  {
                     "code":"BFRE",
                     "value":18617000
                  },
                  {
                     "code":"BFRHE",
                     "value":286182000
                  },
                  {
                     "code":"FDR",
                     "value":11439160000
                  },
                  {
                     "code":"CAF",
                     "value":76321000
                  },
                  {
                     "code":"EBE_CA",
                     "value":-0.2267632781267847
                  },
                  {
                     "code":"LRE",
                     "value":20.476153517792696
                  },
                  {
                     "code":"BFR_CA",
                     "value":2.175892347230154
                  },
                  {
                     "code":"BFRE_CA",
                     "value":0.13290262707024558
                  },
                  {
                     "code":"BFR_JCA",
                     "value":783.3212450028554
                  },
                  {
                     "code":"BFRE_JCA",
                     "value":47.84494574528841
                  },
                  {
                     "code":"DSO",
                     "value":10316520000
                  },
                  {
                     "code":"DPO",
                     "value":48.96926281364973
                  },
                  ...
               ]
            }
            ...
         ]
      }
   ]
}

Ce service permet de récupérer les données des liasses fiscales déposées au greffe par les entreprises françaises ainsi que des mesures analytiques. L’API renvoie les états financiers de tous les exercices disponibles.

Nous validons les données de l’INPI car celles-ci sont constituées à partir d’un processus d’océrisation qui peut générer des erreurs. Un champs "status" indique la validité des comptes.

Seuls les sociétés déposant leurs comptes au greffe et n’ayant pas opté pour l’option de confidentialité sont disponibles.

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/financial/statements.json/<registration_number>?key=YOUR_APIKEY

URL Parameters

Paramètre Défaut Optionnel Description
key Non Votre clé d'API
registration_number Non Numéro SIREN de l'entreprise
statement BILAN, PNL Oui Filtre la catégorie financière retourné (voir ci-dessous)
detailLevel Synthetic Oui Limite le nombre de mesures pour un statement donné. Valeurs possibles : Synthetic,Full

statement

Nom Description
ANALYTICS Renvoie les mesures analytiques calculées par societeinfo se basant sur les données des liasses fiscales (le paramètre "detailLevel" n'a pas d'utilité ici). Le catalogue des ratios financiers societeinfo est décrit plus bas.
BILAN Limite au bilan comptable
PNL Limite au compte de résultat

Voici la liste complète des indicateurs retournés

Réponse

Champs Description Valeurs possibles
groups.metadata Définition des champs de chaque statement
groups.dates.closing_date Date de clôture
groups.dates.duration_in_month Durée de l’exercice
groups.dates.valid Validation interne des comptes true, false
groups.dates.status Code erreur lié de la validation OK, KO, CONFIDENTIEL
groups.dates.rows Valeur des champs

Les comptes publiés par les entreprises françaises peuvent avoir différents formats :

Consolidés : Comptes consolidés de la société correspondant au SIREN demandé.
Complets : Comptes sociaux détaillés.
Simplifiés : Comptes sociaux simplifiés.
Banque : Comptes simplifiés de banque.
Assurance : Comptes simplifiés d’assurance.

Surveillance API

Ce service permet de configurer une surveillance de SIREN. Le principe est simple, vous chargez une liste de SIREN que vous souhaitez surveiller, ensuite vous recevrez tous les jours par mail et/ou webhook les changements de données sur vos SIREN.

Les services de configuration de la surveillance sont décrits sur la page Swagger suivante
https://societeinfo.com/app/swagger/sentinel/index.html



La configuration d'une surveillance se fait en 5 étapes

Vous pouvez réaliser les étapes 2, 3 et 4 dans l'ordre que vous souhaitez, et vous pourrez toujours revenir sur la configuration même après activation.


Vous avez la possibilité de générer gratuitement un évènement de test pour valider votre intégration !
Test de la sentinelle


Création d'une sentinelle

curl -X 'POST' \
  'https://societeinfo.com/app/rest/api/v2/sentinels?sentinel_name=ma_sentinelle' \
  -H 'accept: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d ''

La commande retourne le JSON suivant :

{
  "success": true,
  "status": 200,
  "object": {
    "name": "ma_sentinelle",
    "mode": "EVERY_DAY",
    "enable": false,
    "cost": "Current period [2022-12-06 ; 2023-01-06[ has cost 0 credit.",
    "sentinelSources": {
      "sources": [
        {
          "type": "SIREN_STORES",
          "stores": [
            "ma_sentinelle"
          ]
        }
      ]
    },
    "monitoredProperties": {
      "properties": [
        {
          "propertyPath": "ALL",
          "propertyPathCaption": "All"
        }
      ]
    },
    "sentinelConnectors": {
      "connectors": [
        {
          "type": "GAP_STORE"
        }
      ]
    }
  }
}

Créez votre instance sentinelle de surveillance !

Lien swagger

Configuration des SIREN

Le plus simple c'est de mettre l'ensemble des SIREN que vous voulez surveiller dans un fichier texte, avec ou sans en-tête de colonne. Le système arrivera à reconnaitre automatiquement la bonne colonne.

Pour charger votre liste de SIREN Lien swagger

Si vous voulez envoyer des SIREN dans votre liste sans passer par un fichier Lien swagger

Vous n'aurez qu'à séparer vos SIREN par une virgule. Attention ne mettez pas plus de 500 SIREN dans une même requête ou votre liste risque d'être tronquée.

Configuration des properties

curl "https://societeinfo.com/app/rest/api/v2/sentinels/config/properties"

La commande retourne le JSON suivant :


{
  "success": true,
  "status": 200,
  "object": [
    ...
    {
      "propertyPath": "LEGAL/LEGAL_ETAT",
      "propertyPathCaption": "Legal/Etat de l'entreprise"
    },
    ...
    {
      "propertyPath": "RISK/RISK_SCORE",
      "propertyPathCaption": "Risque/Risque de défaut de paiement"
    },
    ...
    {
      "propertyPath": "FINANCIAL/FINANCIAL_STAFF",
      "propertyPathCaption": "Financial/Effectifs déclarés par l'entreprise"
    },
    ...
    {
      "propertyPath": "PUBLICATIONS/BODACCA/PRESSE_BODACCA_VENTE",
      "propertyPathCaption": "Publications/BodaccA/Les ventes d'établissements"
    },
    ...
    {
      "propertyPath": "PUBLICATIONS/ARTICLES_PRESSE/FUSION_ACQUISITION",
      "propertyPathCaption": "Publications/Articles de presse/Fusion, acquisition, prise de participation"
    },
    {
      "propertyPath": "PUBLICATIONS/ARTICLES_PRESSE/RECRUTEMENT",
      "propertyPathCaption": "Publications/Articles de presse/Recrutement"
    },
    ...
    {
      "propertyPath": "PUBLICATIONS/ACTES_STATUTS/NOMINATIONS_DEMISSIONS",
      "propertyPathCaption": "Publications/Actes et statuts/Nominations / Démissions"
    },
    {
      "propertyPath": "PUBLICATIONS/ACTES_STATUTS/FUSION",
      "propertyPathCaption": "Publications/Actes et statuts/Fusion"
    },
    {
      "propertyPath": "PUBLICATIONS/ACTES_STATUTS/LIQUIDATIONS",
      "propertyPathCaption": "Publications/Actes et statuts/Liquidations judiciaires"
    }
    ...
  ]
}


Configurez les informations que vous voulez surveiller sur les entreprises

Par défaut la propriété 'ALL' est activée, cela signifie que toutes les propriétés sont surveillées :)


Mais si vous voulez recevoir des notifications de changement de données sur des catégories de données particulières, par exemple que : les changements d'adresse des sièges des entreprises et les changement de chiffre d'affaires, alors vous devrez copier-coller cette chaine de caractères :

LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_SIEGE,FINANCIAL/FINANCIAL_SALES


Il existe plus de 70 niveaux de granularité Lien swagger

Configuration des connecteurs

Format JSON des messages webhook

{
   "context":{
      "from":"2022-12-12",
      "to":"2022-12-13",
      "registrationNumber":"482880788"
   },
   "gapList":[
      {
         "property":{
            "propertyPath":"LEGAL/LEGAL_NOM_DENO",
            "propertyPathCaption":"Legal/Dénomination de l'entreprise"
         },
         "gap":{
            "type":"STRING",
            "from":"OLD_9 ATRAM LASER",
            "to":"ATRAM LASER"
         }
      },
      {
         "property":{
            "propertyPath":"LEGAL/LEGAL_CAPITAL",
            "propertyPathCaption":"Legal/Capital social de l'entreprise"
         },
         "gap":{
            "type":"STRING",
            "from":"1 EUR",
            "to":"8000 EUR"
         }
      }
   ],
   "companyInfo":{
      "id":"587965d5b3a2806717a77f66",
      "organization":{
         "status":"Active",
         "risk":{
            "risk_level":0,
            "risk_level_description":"Pas de risque identifié",
            "collective_procedure_in_progress":false,
            "collective_procedures":[],
            "legal_source_organization_statuses":[
               {
                  "source_name":"Bodacc",
                  "organization_status":"Active"
               }
            ]
         },
         "creation_date":"2005-07-01",
         "capital":"8000",
         "registration_number":"482880788",
         "full_registration_number":"48288078800013",
         "vat_number":"FR47482880788",
         "greffe_name":"Arras",
         "name":"ATRAM LASER",
         ...
         "last_legal_update_date":"2022-12-13",
         "establishments_count":0
      },
      "contacts":{
         "main_corporate_officier":{
            "civility":"Mrs",
            "firstName":"Marie",
            "lastName":"WULLEPUT",
            "name":"Marie WULLEPUT",
            "birth_date":"1954-10-14",
            "role":"Gérant",
            "role_start_date":"2016-12-26",
            "role_end_date":"",
            "company":false
         },
         ...
      },
      "web_infos":{
         ...
      },
      "financials":{
         ...
      },
      "actes":[
         ...
      ]
   }
}

La sentinelle notifie les évènements de surveillance sur plusieurs types de connecteurs configurables.

Email

Vous pouvez ajouter/supprimer un/des emails destinataires des notifications avec le service suivant Lien swagger

Webhook

Vous pouvez également configurer un/des webhooks via le service suivant Lien swagger

Un message est envoyé pour chaque entreprise impactée, le message contient l'ensemble des propriétés affectées par votre configuration


Le message webhook est au format JSON suivant

Champs Description Valeurs possibles
context.from Date de référence AAAA-MM-JJ
context.to Date de la modification AAAA-MM-JJ
context.registrationNumber Numéro SIREN de l'entreprise
gapList Liste des évènements
gapList[].property.propertyPath Code de l'évènement Liste des propriétés
gapList[].property.propertyPathCaption Nom de l'évènement Liste des propriétés
gapList[].gap.type Type de la donnée STRING, DOUBLE, INTEGER, LONG, DATE, DATETIME, BOOLEAN, OBJECT
gapList[].gap.from Précédente valeur
gapList[].gap.to Nouvelle valeur
companyInfo Informations sur la société Service GetCompany


GapStore

Par défaut tous les évènements générés sont persistés dans un gapStore associé à la sentinelle.

Vous pouvez interroger votre gapStore et récupérer l'historique des évènements avec le service suivant Lien swagger


Activation de la sentinelle

curl -X 'PATCH' \
  'https://societeinfo.com/app/rest/api/v2/sentinels/ma_Sentinelle/enable' \
  -H 'accept: application/json' \
  -H 'X-API-KEY: jov4vncnp9fbhmdvpfvb89if975gquah6f5cvm0qkb0aoub6ngc'

La commande retourne le JSON suivant :

{
  "success": true,
  "status": 200,
  "object": [
    {
      "name": "ma_sentinelle",
      "mode": "EVERY_DAY",
      "enable": true,
      "sentinelSources": {
        "sources": [
          {
            "type": "SIREN_STORES",
            "stores": [
              "ma_sentinelle",
              "mes_clients",
              "mes_prospects"
            ]
          }
        ]
      },
      "monitoredProperties": {
        "properties": [
          {
            "propertyPath": "LEGAL",
            "propertyPathCaption": "Legal"
          },
          {
            "propertyPath": "PUBLICATIONS",
            "propertyPathCaption": "Publications"
          },
          {
            "propertyPath": "FINANCIAL",
            "propertyPathCaption": "Financial"
          },
          {
            "propertyPath": "RISK",
            "propertyPathCaption": "Risque"
          }
        ]
      },
      "sentinelConnectors": {
        "connectors": [
          {
            "type": "GAP_STORE"
          },
          {
            "type": "MAIL",
            "emails": [
               "example@societeinfo.com"
            ]
          },
          {
            "type": "WEB_HOOK",
            "urls": ["https://mon.webhook.com"]
          }
        ]
      }
    },
    ...
  ]
}

Tant que vous n'avez pas activé votre sentinelle, aucune notification ne vous sera envoyée, et aucun décompte de crédit ne sera réalisé.


Pour activer la sentinelle Lien swagger

Si vous êtes arrivé jusqu'ici sans problème c'est que votre sentinelle est configurée, et que vous allez recevoir des notifications de changement de données dés demain.

Si vous souhaitez mettre en pause votre sentinelle Lien swagger

Pour la réactiver Lien swagger


Pour toutes les étapes précédentes listées, vous avez des endpoints pour modifier ou supprimer des propriétés de votre sentinelle.

Vous pouvez consulter l'état de votre configuration de votre sentinelle Lien swagger

Vérifiez que :

Test de la sentinelle

curl -X 'GET' \
  'https://societeinfo.com/app/rest/api/v2/sentinels/ma_sentinelle/test' \
  -H "accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

La commande envoie l'objet suivant sur le webhook configuré

{
  "feature": "SURVEILLANCE",
  "sentinel": "sentinel_daily_murat_dev",
  "context": {
    "from": "2024-05-16",
    "to": "2024-05-17",
    "registrationNumber": "901769935"
  },
  "gapList": [
    {
      "property": {
        "propertyPath": "LEGAL/LEGAL_NOM_DENO",
        "propertyPathCaption": "Legal/Dénomination de l'entreprise"
      },
      "gap": {
        "type": "STRING",
        "dataType": "string",
        "from": "OLD_5 CUP OF TEA",
        "to": "CUP OF TEA"
      }
    },
    {
      "property": {
        "propertyPath": "LEGAL/LEGAL_CAPITAL",
        "propertyPathCaption": "Legal/Capital social de l'entreprise"
      },
      "gap": {
        "type": "STRING",
        "dataType": "string",
        "from": "2770 EUR",
        "to": "3597 EUR"
      }
    }
  ],
  "companyInfo": {
    "id": "610338257cf1117fc6fea3e9",
    "organization": {
      "status": "Active",
      "registration_number": "901769935",
      "full_registration_number": "90176993500015",
      "vat_number": "FR90901769935",
      "greffe_name": "Lyon",
      "name": "CUP OF TEA",
      "acronym_name": "CUPOFT",
      
    },
    "contacts": {
      "main_corporate_officier": {
        "lastName": "EGLANTINE 3.0",
        "name": "EGLANTINE 3.0",
        "role": "Président",
        "role_start_date": "2021-07-27",
        "role_end_date": "",
        "company": true,
        "registration_number": "821043205"
      },
      "corporate_officiers": [
        {
          "lastName": "EGLANTINE 3.0",
          "name": "EGLANTINE 3.0",
          "role": "Président",
          "role_start_date": "2021-07-27",
          "role_end_date": "",
          "company": true,
          "registration_number": "821043205"
        }
      ],
      "email":
    },
    "web_infos": {
      
    },
    "financials": {
      
    },
    "actes": [
      {
        "date": "2021-07-27",
        "type": "Statuts constitutifs",
        "description": " Constitution d'une société commerciale par création"
      }
    ]
  }
}

Pour tester que les connecteurs de votre sentinelle sont bien configurés Lien swagger


Vous recevrez une notification "type" sur chacun des connecteurs (= sur l'ensemble des emails + webhooks qui ont été configurés). La notification ne comportera que des changements sur un SIREN pris aléatoirement dans la base Societeinfo.

Le type des valeurs gapList[].gap.from et gapList[].gap.to dependent du type de la propriété. Ce type est renseigné dans le champ gapList[].gap.dataType. Ci-dessous un tableau listant les propriétés existante dans la surveillance suivant d'un second tableau affichant un exemple pour chacun des dataTypes.

Liste des propriétés de la surveillance

identifiant de la propriété gapType
LEGAL/LEGAL_NOM_DENO string
LEGAL/LEGAL_NOM_COMMERCIAL string
LEGAL/LEGAL_NOM_ENSEIGNE string
LEGAL/LEGAL_ETAT string
LEGAL/LEGAL_FORJU string
LEGAL/LEGAL_NAF string
LEGAL/LEGAL_ETAB_ETAT establishment_state
LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_SIEGE establishment
LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_ETAB_SEC establishment
LEGAL/LEGAL_CAPITAL share_capital
LEGAL/LEGAL_OBJET_SOCIAL string
RISK/RISK_SCORE company_risk
FINANCIAL/FINANCIAL_SALES company_stats
FINANCIAL/FINANCIAL_STAFF company_stats
PUBLICATIONS/ARTICLES_PRESSE/FUSION_ACQUISITION press_article
PUBLICATIONS/ARTICLES_PRESSE/ACTUALITE_FINANCIERES press_article
PUBLICATIONS/ARTICLES_PRESSE/RECRUTEMENT press_article
PUBLICATIONS/ARTICLES_PRESSE/NOMINATIONS press_article
PUBLICATIONS/ARTICLES_PRESSE/DEVELOPPEMENT press_article
PUBLICATIONS/ARTICLES_PRESSE/INVESTISSEMENT_PROD press_article
PUBLICATIONS/ARTICLES_PRESSE/ORGANISATION_RATIONALISATION press_article
PUBLICATIONS/ARTICLES_PRESSE/SINISTRES press_article
PUBLICATIONS/ARTICLES_PRESSE/ACTUALITE_SOCIALES press_article
PUBLICATIONS/ARTICLES_PRESSE/SALONS_FORUMS press_article
PUBLICATIONS/ARTICLES_PRESSE/OPERATION_RENOVATION press_article
PUBLICATIONS/ARTICLES_PRESSE/MOUVEMENTS press_article
PUBLICATIONS/ARTICLES_PRESSE/PROCEDURES_COLLECTIVES press_article
PUBLICATIONS/ARTICLES_PRESSE/RECHERCHE_LOCAUX press_article
PUBLICATIONS/BODACCA/PRESSE_BODACCA_CREATION bodacc_event
PUBLICATIONS/BODACCA/PRESSE_BODACCA_VENTE bodacc_event
PUBLICATIONS/BODACCB/PRESSE_BODACCB_MODIF_GEN bodacc_event
PUBLICATIONS/BODACCB/PRESSE_BODACCB_RADIATION bodacc_event
PUBLICATIONS/BODACCB/PRESSE_BODACCB_IMMAT bodacc_event
PUBLICATIONS/BODACCC/PRESSE_BODACCC_PUBLI_FI bodacc_event
PUBLICATIONS/BODACCA/PRESSE_BODACCA_JUGEMENT bodacc_event
PUBLICATIONS/ACTES_STATUTS/JUGEMENTS acte
PUBLICATIONS/ACTES_STATUTS/LIQUIDATIONS acte
PUBLICATIONS/ACTES_STATUTS/CAPITAL_AUGMENTATION acte
PUBLICATIONS/ACTES_STATUTS/CAPITAL_CONTINUATION acte
PUBLICATIONS/ACTES_STATUTS/CAPITAL_RECONSTITUTION_ACTIF acte
PUBLICATIONS/ACTES_STATUTS/CAPITAL_REDUCTION acte
PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_CLOTURE acte
PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_FORJU acte
PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_OBJET_SOCIAL acte
PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_NOM acte
PUBLICATIONS/ACTES_STATUTS/AVIS_NANTISSEMENT acte
PUBLICATIONS/ACTES_STATUTS/APPORTS_ACTIFS acte
PUBLICATIONS/ACTES_STATUTS/DECES acte
PUBLICATIONS/ACTES_STATUTS/DISSOLUTIONS acte
PUBLICATIONS/ACTES_STATUTS/MISES_SOMMEIL acte
PUBLICATIONS/ACTES_STATUTS/ACTES acte
PUBLICATIONS/ACTES_STATUTS/CESSIONS_PARTS acte
PUBLICATIONS/ACTES_STATUTS/DECISIONS acte
PUBLICATIONS/ACTES_STATUTS/DECLARATION_BE acte
PUBLICATIONS/ACTES_STATUTS/FUSION acte
PUBLICATIONS/ACTES_STATUTS/SCISSIONS acte
PUBLICATIONS/ACTES_STATUTS/NOMINATIONS_DEMISSIONS acte
PUBLICATIONS/ACTES_STATUTS/RAPPORTS acte
PUBLICATIONS/ACTES_STATUTS/RAPPORTS_COMMISSAIRES acte
PUBLICATIONS/ACTES_STATUTS/TRANSFERTS_SIEGE acte
PUBLICATIONS/ACTES_STATUTS/UPDATE_STATUTS acte
PUBLICATIONS/ACTES_STATUTS/PV_AG acte
PUBLICATIONS/ACTES_STATUTS/DECLARATION_CONFORMITE acte
PUBLICATIONS/ACTES_STATUTS/AFFECTATIONS_PATRIMOINE acte
PUBLICATIONS/ACTES_STATUTS/ATTESTATIONS_FONDS acte
PUBLICATIONS/ACTES_STATUTS/DIVERS acte

Liste des types d'objets de la surveillance

gapType exemple
string
{
"gap": {
"type": "STRING",
"dataType": "string",
"from": "Active",
"to": "Dead"
}
}
establishment_state
{
"gap": {
"type": "OBJECT",
"dataType": "establishment_state",
"from": {
"fullRegistrationNumber": "41142532500049",
"postalAddress": {
"street": "351 RUE SALVADOR ALLENDE",
"postalCode": "59120",
"city": "Loos",
"country": "FRANCE"
},
"status": "Active"
},
"to": {
"fullRegistrationNumber": "41142532500049",
"postalAddress": {
"street": "351 RUE SALVADOR ALLENDE",
"postalCode": "59120",
"city": "Loos",
"country": "FRANCE"
},
"status": "Dead"
}
}
}
establishment
{
"gap": {
"type": "OBJECT",
"dataType": "establishment",
"from": {
"fullRegistrationNumber": "48127561800033",
"postalAddress": {
"street": "8 RUE CUBAIN",
"postalCode": "49000",
"city": "ANGERS",
"country": "FRANCE"
}
},
"to": {
"fullRegistrationNumber": "48127561800033",
"postalAddress": {
"street": "34 RUE DU RALE DES GENETS",
"postalCode": "49080",
"city": "BOUCHEMAINE",
"country": "FRANCE"
}
}
}
}
share_capital
{
"gap": {
"type": "OBJECT",
"dataType": "share_capital",
"from": {
"value": 66195,
"currency": "EUR"
},
"to": {
"value": 66412,
"currency": "EUR"
}
}
}
company_risk
{
"gap": {
"type": "OBJECT",
"dataType": "company_risk",
"from": {
"riskLevel": 0,
"riskLevelDescription": "Pas de risque identifié"
},
"to": {
"riskLevel": 4,
"riskLevelDescription": "Société clôturée"
}
}
}
company_stats
{
"gap": {
"type": "OBJECT",
"dataType": "company_stats",
"to": {
"value": 2701500,
"year": "2022",
"closingDate": "2022-12-31"
}
}
}
press_article
{
"gap": {
"type": "OBJECT",
"dataType": "press_article",
"to": {
"articlePublicationDate": "2024-05-03",
"newsId": "45382940",
"articleSource": "lejournaldesentreprises.com",
"theme": "Recrutement",
"subThemeLabel": "Augmentation stratégique des effectifs",
"newsSummary": "Open recrute à Rennes afin d'accompagner son...",
"mainRegistrationNumber": "381031285",
"mainFullRegistrationNumber": "38103128500376",
"articleTitle": "Treize entreprises recrutent lors du Safari des...",
"newsUrl": "https://www.lejournaldesentreprises.com/breve/..."
}
}
}
bodacc_event
{
"gap": {
"type": "OBJECT",
"dataType": "bodacc_event",
"to": {
"type": "RCSAVente",
"label": "Autre achat, apport, attribution (immatriculation...",
"date": "2024-05-16"
}
}
}
acte
{
"gap": {
"type": "OBJECT",
"dataType": "acte",
"to": {
"depositeDate": 2024-01-08,
"type": "Procès-verbal d'assemblée générale ordinaire",
"description": "Modification des commissaires aux comptes"
}
}
}

Siren Store

curl -X 'GET' \
  'https://societeinfo.com/app/rest/api/v2/stores/sirenstores/ma_sentinelle' \
  -H "accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

La commande retourne le JSON suivant :

{
  "success": true,
  "status": 200,
  "object": {
    "totalSiren": 1,
    "currentPage": 0,
    "totalPage": 1,
    "pageSize": 1,
    "name": "ma_sentinelle",
    "sirens": [
      "830134383"
    ]
  }
}

Un SirenStore correspond a une liste de SIREN stockée sur les serveurs de Societeinfo. Vous pouvez définir autant de SirenStore que vous le souhaitez, vous pouvez par exemple créer une liste pour :

Puis décider de faire une surveillance :

Par défaut, à chaque fois que vous créez une sentinelle, vous créez un SirenStore qui porte le même nom que votre sentinelle. C'est le SirenStore par défaut quand vous ajouter des SIREN à votre sentinelle.

Pour créer un SirenStore Lien swagger


Associez vos SirenStore et vos sentinelles Lien swagger


Pour plus d'infos sur la manière de modifier ou de supprimer des SirenStore, rendez-vous dans la section SirenStore de la documentation Swagger.

Events API

Get Events

Ce service retourne les événements stratégiques d'une entreprise recueillis à travers différents médias. Vous y trouverez différents sujets tels que les levées de fonds, les fusions & acquisitions, la prise de participation, les recrutements, l'actualité financière, les communiqués des entreprises, les nominations dans l'équipe de direction, etc.

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/events.json/<registration_number>?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API.
registration_number Non Numéro SIREN ou SIRET de l'entreprise
curl "https://societeinfo.com/app/rest/api/v2/events.json/83013438300017?key=DEMO"

La commande retourne le JSON suivant :

{
  "success": false,
  "result": {
    "id": "652919194dd1ec1371c80147",
    "organization": {
      "status": "Active",
      "risk": {
        "risk_level": 0.0,
        "risk_level_description": "Pas de risque identifié",
        "collective_procedure_in_progress": false,
        "collective_procedures": [],
        "legal_source_organization_statuses": [
          {
            "source_name": "Bodacc",
            "organization_status": "Active"
          }
        ]
      },
      "creation_date": "2017-06-05",
      "capital": "5102",
      "registration_number": "830134383",
      "full_registration_number": "83013438300017",
      "vat_number": "FR38830134383",
      "greffe_name": "Nanterre",
      "name": "SMART DATA",
      "activity": {
        "ape_code": "6201Z",
        "ape_code_level1": "JZ",
        "ape_code_level2": "JC",
        "ape_code_level3": "62",
        "ape_code_level4": "J62Z",
        "ape_code_level5": "6201Z",
        "ape_name": "Programmation informatique",
        "corporate_object": "La société a pour objet ..."
      },
      "legal": {
        "name": "Société par actions simplifiée",
        "code_level1": "5",
        "code_level2": "57",
        "code_level3": "5710",
        "person_type": "LegalEntity",
        "type": "Siege"
      },
      "address": {
        "street": "176 AVENUE CHARLES DE GAULLE",
        "postal_code": "92200",
        "city": "NEUILLY-SUR-SEINE",
        "country_code": "FR",
        "country": "FRANCE",
        "lng": 2.2697,
        "lat": 48.8846
      },
      "last_legal_update_date": "2023-10-30",
      "establishments_count": 0
    },
    "events": [
      {
        "code_sub_theme": "DCPN",
        "news_delivery_date": "2021-09-13",
        "article_publication_date": "2021-09-08",
        "news_id": "36123608",
        "article_id": "39665852",
        "sub_theme_label": "Innovation, nouveaux marchés, contrats",
        "main_full_registration_number": "83013438300017",
        "secondary_companies": [],
        "article_source": "Communiqué d'entreprise",
        "news_summary": "SOCIETEINFO remporte l’appel d’offre de BPIFrance concernant l’alimentation de ...",
        "theme": "Développement",
        "article_title": "SOCIETEINFO remporte l’appel d’offre de BPIFrance ...",
        "news_url": "https://societeinfo.com/blog/societeinfoxbpifrance"
      },
      {
        "code_sub_theme": "FAPPM",
        "news_delivery_date": "2021-03-29",
        "article_publication_date": "2021-03-22",
        "news_id": "34495436",
        "article_id": "37974745",
        "sub_theme_label": "Prise de participation minoritaire",
        "main_full_registration_number": "83013438300017",
        "secondary_companies": [
          {
            "id": "CompanyIdViewV2_518891395|51889139500015",
            "registration_number": "518891395",
            "full_registration_number": "51889139500015",
            "corporate_name": "EXPLORE"
          }
        ],
        "article_source": "Communiqué d'entreprise",
        "news_summary": "Communiqué de Presse EXPLORE s’associe à Societeinfo.com pour déployer des solutions innovantes ...",
        "theme": "Fusion, acquisition, prise de participation",
        "article_title": "Explore - Participation minoritaire au capital de la start-up Societeinfo.com"
      },
      {
        "code_sub_theme": "RECR",
        "news_delivery_date": "2021-01-11",
        "article_publication_date": "2021-01-06",
        "news_id": "33786387",
        "article_id": "37217680",
        "sub_theme_label": "Recrutement",
        "main_full_registration_number": "83013438300017",
        "secondary_companies": [],
        "article_source": "Communiqué d'entreprise",
        "news_summary": "Societeinfo recrute actuellement 1 développeur ...",
        "theme": "Recrutement",
        "article_title": "Societeinfo recherche 1 Développeur ..."
      }
    ]
  }
}

Extra API

Get Bodacc

curl "https://societeinfo.com/app/rest/api/v2/bodacc.json/342376332?key=DEMO"

La commande retourne le JSON suivant :

{
    "success": true,
    "result": [{
       "type": "Bodacc",
       "bodacc_type": "Modifications et mutations diverses",
       "parution_date": "2008-07-08",
       "number": "1716",
       "rcs_name": "342376332 RCS paris",
       "legal_name": "ILIAD",
       "legal_status": "Société anonyme",
       "capital": "12000000 EUR",
       "administration": "modification de l'Administrateur Rozenfeld, Olivier",
       "address": "8 rue de la Ville L'Évêque 75008 Paris",
       "description": "modification survenue sur l'administration"
      },
      ...
  ]
}

bundle exec middleman server

Ce service retourne l'ensemble des annonces légales du BODACC à partir d'un code SIREN

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/bodacc.json/<registration_number>?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API.
registration_number Non Numéro SIREN de l'entreprise

Autocomplete Place

curl "https://societeinfo.com/app/rest/api/v2/places.json/autocomplete?query=paris&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "errorType":null,
   "errorCode":null,
   "errorMessage":null,
   "total":5,
   "page":0,
   "views":[
      {
         "id":"587953dcb3a2b0645005d4de",
         "first":"Paris",
         "others":"Île-de-France, FRANCE",
         "type":"administrative_area_level_2",
         "sourceStatus":"Complete",
         "formatedName":"Paris, Île-de-France, FRANCE"
      },
      {
         "id":"587953d6b3a2b06450055d59",
         "first":"Paris",
         "others":"Paris, Île-de-France, FRANCE",
         "type":"locality",
         "sourceStatus":"Complete",
         "formatedName":"Paris, Paris, Île-de-France, FRANCE"
      },
    ...
   ]
}

Le service Place Autocomplete retourne des prédictions de lieu. La requête spécifie une chaîne de recherche. Le service permet de fournir la fonctionnalité de saisie semi-automatique pour les recherches géographiques textuelles et renvoie des adresses au fur et à mesure de la saisie par l'utilisateur (région, département, code postal, ville, rue)

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/places.json/autocomplete?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API
query Non Caractères spécifiés pour la recherche

Errors

L'API utilise les codes standard HTTP suivants :

Error Code Description
400 Bad Request -- Requête invalide.
401 Unauthorized -- Clé API invalide.
403 Forbidden -- Accès non autorisé.
404 Not Found -- Entité non trouvé.
429 Too Many Requests -- Vous requêtez trop vite ! Ralentissez !
500 Internal Server Error -- Nous avons un problème interne, Ré-exécuter plus tard.




{
    "success": false,
    "errorType": "Functionnal",
    "errorCode": "API_INVALID_KEY",
    "errorMessage": "The api key is not found"
}

Les réponses en erreur inclue également un champs errorCode avec un niveau de détail plus fin. En voici quelques exemples :

Error Code Description
API_COMPANY_NOT_FOUND La société n'a pas été trouvée.
API_CONTACT_NOT_FOUND Le contact n'a pas été trouvé
API_COMPANY_ANONYMIZED Le propriétaire de la société a demandé son anonymisation
API_COMPANY_QUERY_MIN_LENGTH La taille de la query doit être supérieure à deux
API_CONTACT_UNAUTHORIZED L'accès à l'API est limité aux comptes payants
API_INVALID_KEY La clé d'API est invalide.
API_UNDEFINED_KEY La clé d'API n'est pas renseignée
API_MAX_MATCH_EXCEEDED Les crédits de la clé d'API sont épuisés.
API_INVALID_PAGE La page demandée n'existe pas.
USER_COMPANY_EXPIRED Le compte est expiré, la carte de crédit a été refusée