NAV Navbar
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.

Cette page décrit la V2 de l'API. Vous pouvez également consulter la doc de la V1 ici

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":"RCS",
                  "organization_status":"Active"
               },
               {
                  "source_name":"INSEE",
                  "organization_status":"Active"
               },
               {
                  "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",
         "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":"Arts du spectacle vivant"
         },
         "legal":{
            "name":"Société par actions simplifiée (Société à associé unique)",
            "code_level1":"5",
            "code_level2":"57",
            "code_level3":"5710",
            "person_type":"LegalEntity",
            "type":"Siege"
         },
         "address":{
            "street":"50 BOULEVARD VOLTAIRE",
            "postal_code":"75011",
            "city":"PARIS",
            "country_code":"FR",
            "country":"FRANCE",
            "lng":2.3795,
            "lat":48.8574
         },
         "last_legal_update_date":"2020-07-10",
         "establishments_count":9
      },
      "contacts":{
         "main_corporate_officier":{
            "firstName":"Jérôme",
            "lastName":"Langlet",
            "name":"Jérôme Langlet",
            "birth_date":"1971-10-18",
            "role":"Président",
            "role_start_date":"2017-01-30",
            "role_end_date":"",
            "company":false
         },
         "corporate_officiers":[
            {
               "firstName":"Jérôme",
               "lastName":"Langlet",
               "name":"Jérôme Langlet",
               "birth_date":"1971-10-18",
               "role":"Président",
               "role_start_date":"2017-01-30",
               "role_end_date":"",
               "company":false
            },
            {
               "lastName":"SCENELIS",
               "name":"SCENELIS",
               "role":"Directeur général",
               "role_start_date":"2018-02-21",
               "role_end_date":"",
               "company":true,
               "registration_number":"834361537"
            },
            {
               "lastName":"MAZARS",
               "name":"MAZARS",
               "role":"Commissaire aux comptes titulaire",
               "role_start_date":"2017-01-30",
               "role_end_date":"",
               "company":true,
               "registration_number":"784824153"
            },
            {
               "firstName":"Simon",
               "lastName":"Beillevaire",
               "name":"Simon Beillevaire",
               "birth_date":"1971-05-28",
               "role":"Commissaire aux comptes suppléant",
               "role_start_date":"2017-01-30",
               "role_end_date":"",
               "company":false
            }
         ],
         "email":"contact@bataclan.fr",
         "emails":[
            {
               "value":"contact@bataclan.fr",
               "type":"generic"
            }
         ]
      },
      "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 : Concerts - Musique - Danse - Humour - Mode - Conférence - Podcast - Sport - Exposition. ",
               "webmaster_email":"hostmaster@lagardere-se.com",
               "webmaster_phone":"01 40 69 17 91",
               "techno_types":[
                  "php",
                  "jquery",
                  "wordpress",
                  "xmlrpc",
                  "yoastseo",
                  "recaptcha"
               ],
               "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/"
         },
         "twitter":{
            "url":"https://twitter.com/@bataclan_"
         },
         "facebook":{
            "url":"https://www.facebook.com/bataclanFR/"
         },
         "wikipedia":{

         }
      },
      "financials":{
         "last_sales":3534212,
         "last_profit":-493914,
         "last_staff":6,
         "years":[
            {
               "year":"2019",
               "sales":3534212,
               "profit":-493914,
               "closing_date":"2019-12-31"
            },
            {
               "year":"2018",
               "sales":2425712,
               "profit":-518928,
               "closing_date":"2018-12-31"
            },
            {
               "year":"2017",
               "staff":6
            },
            {
               "year":"2015",
               "sales":640732,
               "profit":-220834,
               "staff":5,
               "closing_date":"2015-12-31"
            },
            {
               "year":"2014",
               "sales":725875,
               "profit":44926,
               "staff":3,
               "closing_date":"2014-08-31"
            },
            {
               "year":"2013",
               "sales":719212,
               "profit":45692,
               "staff":3,
               "closing_date":"2013-08-31"
            },
            {
               "year":"2012",
               "sales":718107,
               "profit":-121525,
               "staff":3
            },
            {
               "year":"2011",
               "sales":686694,
               "profit":43612
            }
         ]
      },
      "mark_infos":{

      },
      "last_bodacc":{
         "type":"Bodacc",
         "bodacc_type":"Avis de dépôts des comptes des sociétés",
         "parution_date":"2020-07-28",
         "number":"5871",
         "rcs_name":"702012931 RCS Paris",
         "legal_name":"SOCIETE D'EXPLOITATION DES SPECTACLES BATACLAN",
         "legal_status":"Société par actions simplifiée (à associé unique)",
         "address":"50 boulevard Voltaire 75011 Paris",
         "balance_sheet_close_date":"2019-12-31",
         "balance_sheet_deposit_type":"Comptes annuels et rapports"
      },
      "actes":[
         {
            "date":"2020-07-06",
            "type":"Extrait de procès-verbal",
            "description":"Modification(s) statutaire(s)"
         },
         {
            "date":"2020-07-06",
            "type":"Statuts mis à jour"
         },
         {
            "date":"2019-07-03",
            "type":"Extrait de procès-verbal",
            "description":"Poursuite d'activité malgré un actif net devenu inférieur à la moitié du capital social"
         },
         ...
      ]
   }
}

Exemple de risk

{
...
  "risk": {
    "risk_level": 4,
    "collective_procedure_in_progress": false,
    "collective_procedures": [
      {
        "collective_procedure_type": "Liquidation judiciaire",
        "collective_procedure_startdate": "2018-03-13",
        "collective_procedure_startmessage": "Jugement prononçant la liquidation judiciaire , date de cessation des paiements le 12 Avril 2017, désignant liquidateur XXX . Les créances sont à déclarer, dans les deux mois de la présente publication, auprès du liquidateur ou sur le portail électronique à l'adresse https://www.creditors-services.com.",
        "collective_procedure_enddate": "2019-03-20",
        "collective_procedure_endmessage": "Jugement prononçant la clôture de la procédure de liquidation judiciaire pour insuffisance d'actif.",
        "collective_procedure_status": "Closed"
      }
    ],
    "legal_source_organization_statuses": [
      {
        "source_name": "RCS",
        "organization_status": "Dead",
        "organization_status_date": "2019-03-21"
      },
      {
        "source_name": "INSEE",
        "organization_status": "Active"
      },
      {
        "source_name": "Bodacc",
        "organization_status": "Dead"
      }
    ]
  }
...
}

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
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
organization.legal.code_level2 Forme juridique code Niv.2
organization.legal.code_level3 Forme juridique code Niv.3
organization.address.street Adresse
organization.address.postal_code Code postal
organization.address.city Ville
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
organization.activity.ape_code_level1 Code NAF Niv.1
organization.activity.ape_code_level2 Code NAF Niv.2
organization.activity.ape_code_level3 Code NAF Niv.3
organization.activity.ape_code_level4 Code NAF Niv.4
organization.activity.ape_code_level5 Code NAF Niv.5
organization.financials.last_sales Chiffre d'affaire
organization.financials.last_profit Résultat net
organization.financials.last_staff Nombre d'employés
organization.web_infos.website_url Url du site web principal
organization.web_infos.websites Site webs
organization.web_infos.linkedin.url Url Linkedin
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é
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

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.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,
   "result":{
      "id":"593b6fa6b3a2feb79d4f9f39",
      "organization":{
         "status":"Active",
          "risk": {
            "risk_level": 0,
            "collective_procedure_in_progress": false,
            "collective_procedures": [],
            "legal_source_organization_statuses": [
              {
                "source_name": "RCS",
                "organization_status": "Active"
              },
              {
                "source_name": "INSEE",
                "organization_status": "Active"
              },
              {
                "source_name": "Bodacc",
                "organization_status": "Active"
              }
            ]
         },
         "creation_date":"2017-06-05",
         "capital":"5000",
         "registration_number":"830134383",
         "full_registration_number":"83013438300017",
         "vat_number":"FR38830134383",
         "greffe_name":"Nanterre",
         "name":"SMART DATA",
         "activity":{
            "ape_code":"4741Z",
            "ape_code_level1":"GZ",
            "ape_code_level2":"GZ",
            "ape_code_level3":"47",
            "ape_code_level4":"G47Z",
            "ape_code_level5":"4741Z",
            "ape_name":"Commerce de détail d'ordinateurs, d'unités périphériques et de logiciels en magasin spécialisé",
            "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.2593109,
            "lat":48.8854852
         },
         "last_legal_update_date": "2019-09-11",
         "establishments_count":0
      },
      "contacts":{
          "main_corporate_officier": {
                "firstName":"Antoine",
                "lastName":"ONNEN",
                "name":"Antoine ONNEN",
                "birth_date":"1977-03-07",
                "role":"Président",
                "role_start_date":"2017-06-09",
                "company":false
          },
         "corporate_officiers":[
            {
               "firstName":"Antoine",
               "lastName":"ONNEN",
               "name":"Antoine ONNEN",
               "birth_date":"1977-03-07",
               "role":"Président",
               "role_start_date":"2017-06-09",
               "company":false
            },
            {
               "firstName":"Alexandre",
               "lastName":"CONRAUD",
               "name":"Alexandre CONRAUD",
               "role":"Directeur général",
               "role_start_date":"2017-06-09",
               "company":false
            }
         ],
         "email":"contact@societeinfo.com",
         "emails":[
            {
               "value":"contact@societeinfo.com",
               "type":"generic"
            }
         ],
         "phones":[]
      },
      "web_infos":{
         "logo_url":"https://societeinfo.com/wp-content/uploads/2017/01/Logomakr_28eUEg-1.png",
         "website_url":"http://www.societeinfo.com/",
         "websites":[
            {
                "domain": "societeinfo.com",
                "url": "http://www.societeinfo.com/",
                "description": "Societeinfo agrège des millions de données d&#039;entreprises (OPEN DATA, SIRENE, Infogreffe, WEB, BODACC, INPI) pour vous offrir toujours plus de données d&#039;entreprises. API Entreprise, Enrichissement de données, Prospection BtoB, Emails, Téléphone de sociétés",
                "webmaster_phone": "01 70 37 76 66",
                "techno_types": [
                    "wordpress",
                    "xmlrpc",
                    "woocommerce",
                    "php"
                ],
                "metadata": {
                    "owner_registration_number": "830134383",
                    "website_crawl_date": "2020-09-30"
                }
            }
         ],
         "twitter":{
            "url":"https://twitter.com/@SocieteInfo"
         }
      },
      "financials":{
         "last_sales":26696,
         "last_profit":10658,
         "years":[
            {
               "year":"2018",
               "closing_date": "2018-12-31"
            },
            {
               "year":"2017",
               "sales":26696,
               "profit":10658,
               "closing_date":"2017-05-31"
            }
         ]
      },
      "last_bodacc":{
         "type":"Bodacc",
         "bodacc_type":"Avis de dépôts des comptes des sociétés",
         "parution_date":"2018-07-11",
         "number":"18689",
         "rcs_name":"830134383 RCS Nanterre",
         "legal_name":"SMART DATA",
         "legal_status":"Société par actions simplifiée",
         "address":"176 avenue Charles de Gaulle 92200 Neuilly-sur-Seine",
         "balance_sheet_close_date":1514674800000,
         "balance_sheet_deposit_type":"Comptes annuels et rapports"
      },
      "actes":[
         {
            "date":"2018-05-24",
            "type":"Document relatif au bénéficiaire effectif"
         },
         {
            "date":"2017-06-09",
            "type":"Statuts constitutifs"
         }
      ]
   },
   "match_info": {
          "score": 0.8,
          "sources": "Nom Adresse"
    }
}

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
street2 Oui Complément d'adresse
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é
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
first_name, last_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

Query 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
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

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

Company Parameters

Paramètre Defaut Optionnel Description
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 ci-dessous)
placeId Oui Interrogez le service Place Autocomplete, puis spécifiez l'identifiant de place retourné. Filtre les entreprises par région/département/code postal/ville/rue
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
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
mintwitterfollowers Oui Filtre les entreprises avec un nombre de follower twitter supérieur.
mintwitterfriends Oui Ajoutez ce paramètre pour trier les résultats. Les valeurs possibles sont les suivantes.
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
sort score Oui Spécifie le tri des résultat. Valeurs possibles dans le tableau suivant (voir 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
curl "https://societeinfo.com/app/rest/api/v2/companies.json?query=big%20data&contact_role_query=data%20scientist&withHighlight=true&key=DEMO

La commande retourne le JSON suivant :

{
  "success": true,
  "total": 378,
  "totalContacts": 1227,
  "currentPage": 1,
  "totalPages": 38,
  "searchMode": "keyword",
  "sorts": [
    "score"
  ],
  "result": [
    {
      "id": "5d3cdf0ff0f016d9c1dde246",
      "registration_number": "507661023",
      "full_registration_number": "50766102300048",
      "legal_type": "Siege",
      "name": "INVENTIV IT",
      "activity": "Conseil en informatique, technologies de l'information, audits, conseils, réalisations, formations. ",
      "formatted_address": "75017 PARIS",
      "lng": 2.3219,
      "lat": 48.8835,
      "highlights": [
        {
          "data_category": "Contact",
          "data_source": "Linkedin",
          "data_field": "Title",
          "texts": [
            "<em><b>Data</b></em> <em><b>scientist</b></em> / <em><b>data</b></em> engineer"
          ]
        },
        {
          "data_category": "Company",
          "data_source": "Website",
          "texts": [
            "Bigdata & <em><b>Data</b></em> Science",
            "engineer, développeur <em><b>big</b></em> <em><b>data</b></em>, architecte vous avez une première expérience sur des projets <em><b>big</b></em> <em><b>data</b></em> vous interviendrez",
            "<em><b>Data</b></em> Engineer, Développeur <em><b>Big</b></em> <em><b>Data</b></em>, Architecte"
          ]
        }
      ]
    }
  ...
  ]
}

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_role_query Oui Filtre les rôle des mandataires. Exemple : gérant OR président OR directeur




Contact API

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":"4741Z"
  },
  "email_domains":[
    {
      "domain":"societeinfo.com",
      "pattern":"{first}.{last}"
    },
    {
      "domain":"societeinfo.com",
      "pattern":"{first}"
    }
  ],
  "contacts":[
    {
    "id": "8301343831281918940",
    "firstName": "Alexandre",
    "lastName": "CONRAUD",
    "role": "Directeur général",
    "email": "alexandre.conraud@societeinfo.com",
    "email_score": 0.93,
    "email_test_result": "Safe to Send",
    "email_test_reason": "Deliverable",
    "email_test_date": "2020-07-09",
    "email_webmail": false,
    "hashcode": "911035480"
  },
  {
    "id": "830134383621532388",
    "firstName": "Antoine",
    "lastName": "ONNEN",
    "birth_date": "1977-03-07",
    "role": "Président",
    "email": "antoine.onnen@societeinfo.com",
    "email_score": 0.93,
    "email_test_result": "Safe to Send",
    "email_test_reason": "Deliverable",
    "email_test_date": "2020-07-09",
    "email_webmail": false,
    "hashcode": "947235740"
  }
  ],
  "contacts_count": 2,
  "emails":[
    {
      "value":"antoine@societeinfo.com",
      "type":"personal",
      "sources":[
        {
          "url":"http://www.societeinfo.com/"
        }
      ]
    }
  ]
}

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

Filtres sur les contacts

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_role_query Oui Filtre les postes des contacts (voir ci-dessous)
contact_max Oui Nombre de contacts max dans la réponse

contact_role_query

Optionnel, Identifiez des familles de postes spécifiques en tapant des mots clés.

Par exemple "marketing" renverra tous les postes intégrant le mot "marketing" comme "Responsable marketing" ou "Directeur marketing".

Pour filtrer tous les postes de responsables/dirigeant, utilisez l'expression suivante : dirigeant OR directeur OR responsable OR CEO OR gérant OR président

Réponse

Champs Description Valeurs possibles
email_domains.domain Domain mail corporate
email_domains.pattern Pattern mail corporate
contacts.id Identifiant du contact
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
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
emails.value Email détecté
emails.type Type email generic, personal
emails.sources Sources email




curl "https://societeinfo.com/app/rest/api/v2/contacts.json?name=tilkee&contact_role_query=marketing%20OR%20founder&key=DEMO"

La commande retourne le JSON suivant :

{  
   "success":true,
   "company":{  
      "id":"58797115b3a2806717d8e0a7",
      "registration_number":"789120649",
      "full_registration_number":"78912064900031",
      "legal_type":"Siege",
      "name":"TILKEE",
      "activity":"Edition de logiciel.",
      "formatted_address":"13 RUE BURDEAU 69001 Lyon"
   },
   "email_patterns":[  
      {
        "domain": "tilkee.com",
        "pattern": "{first}"
      },
      {
        "domain": "tilkee.fr",
        "pattern": "{first}.{last}"
      },
      {
        "domain": "tilkee.fr",
        "pattern": "{first}"
      }
    ],
    "contacts":[  
      {
        "id": "789120649718434360",
        "firstName": "Tim",
        "lastName": "SAUMET",
        "role": "Cto & co-founder",
        "email": "tim@tilkee.com",
        "email_score": 0.7,
        "email_test_result": "Risky",
        "email_test_reason": "Accept All",
        "email_test_date": "2020-04-09",
        "email_webmail": false,
        "linkedin_url": "https://www.linkedin.com/in/timsaumet/",
        "extraction_date": "2019-10-01",
        "hashcode": "159027033"
      },
      {
        "id": "789120649307274538",
        "firstName": "Baptiste",
        "lastName": "RENAULT",
        "role": "Operational marketing manager | Business developer",
        "email": "baptiste@tilkee.com",
        "email_score": 0.7,
        "email_test_result": "Risky",
        "email_test_reason": "Accept All",
        "email_test_date": "2020-04-09",
        "email_webmail": false,
        "linkedin_url": "https://www.linkedin.com/in/baptisterenault/",
        "extraction_date": "2020-04-14",
        "hashcode": "1245895813"
      },
      {  
        "id": "7891206491626992254",
        "firstName": "Sylvain",
        "lastName": "TILLON",
        "role": "Chief marketing officer | Webmaster",
        "email": "sylvain@tilkee.com",
        "email_score": 0.7,
        "email_test_result": "Risky",
        "email_test_reason": "Accept All",
        "email_test_date": "2020-04-09",
        "email_webmail": false,
        "linkedin_url": "https://www.linkedin.com/in/sylvaintillon/",
        "extraction_date": "2020-04-14",
        "hashcode": "561415271"
      },
      ...
   ],
   "contacts_count": 5,
   "emails":[  
      {
        "value": "sylvain@tilkee.com",
        "type": "personal",
        "sources": [
          {
            "url": "http://audentia-gestion.fr/bpifrance/Bpifrance_Dossier%20de%20presse%20ubi%20i-o%202016_09-03-2016.pdf"
          }
        ]
     }
      ...
   ]
}

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
street2 Oui Complément d'adresse
postal_code Oui Code postal
city Oui Ville
domain_name Oui Nom de domaine OU url du site web
email Oui adresse email
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













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": "8301343831281918940",
          "firstName": "Xxxxx",
          "lastName": "XXXXXXXX",
          "birth_date": "YYYY-MM-dd",
          "role": "Président",
          "email": "xxxxxxx@xxxx.xxx",
          "email_score": 0.95,
          "email_test_result": "Safe to Send",
          "email_test_reason": "Deliverable",
          "email_test_date": "2020-07-09",
          "email_webmail": false,
          "anonymized": true,
          "hashcode": "911035480"
      },
      {
          "id": "830134383621532388",
          "firstName": "Xxxxx",
          "lastName": "XXXXXXXX",
          "role": "Directeur général",
          "email": "xxxxxxx@xxxx.xxx",
          "email_score": 0.95,
          "email_test_result": "Safe to Send",
          "email_test_reason": "Deliverable",
          "email_test_date": "2020-07-09",
          "email_webmail": false,
          "anonymized": true,
          "hashcode": "947235740"
      }
  ],
  "contacts_count": 2
}
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",
      "firstName": "Antoine",
      "lastName": "ONNEN",
      "birth_date": "1977-03-07",
      "role": "Président",
      "email": "antoine.onnen@societeinfo.com",
      "email_score": 0.92,
      "email_test_result": "Safe to Send",
      "email_test_reason": "Deliverable",
      "email_test_date": "2020-07-09",
      "email_webmail": false,
      "hashcode": "947235740"
    }
  ],
  "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_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 Parameters

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

Contact Parameters

Paramètre Defaut Optionnel Description
contact_role_query Oui Filtre les postes des contacts (voir ci-dessus)
contact_source Oui Filtre l'origine des contacts. Les valeurs possibles sont legal,linkedin. Exemple contact_source=legal&contact_source=linkedin
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

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




Enrich contact

curl "https://societeinfo.com/app/rest/api/v2/contacts.json?name=tilkee&first_name=sylvain&last_name=tillon&key=DEMO"

La commande retourne le JSON suivant :


{
  "success": true,
  "company": {
    "id": "58797115b3a2806717d8e0a7",
    "registration_number": "789120649",
    "full_registration_number": "78912064900049",
    "legal_type": "Siege",
    "name": "TILKEE",
    "activity": "Edition de logiciel.",
    "formatted_address": "22 RUE CONSTANTINE 69001 LYON",
    "ape_code": "5829C"
  },
  "contacts": [
    {
      "firstName": "Sylvain",
      "lastName": "TILLON",
      "role": "Directeur général | Cofounder and ceo | Cofondateur",
      "email": "sylvain@tilkee.com",
      "email_score": 0.14,
      "email_test_result": "Risky",
      "email_test_reason": "Accept All",
      "email_test_date": "2019-12-18",
      "linkedin_url": "https://www.linkedin.com/in/sylvaintillon/",
      "extraction_date": "2019-10-01"
    }
  ],
  "contacts_count": 1
}

Ce service vous permet d'enrichir un contact depuis son nom/prénom pour obtenir son email et/ou linkedin

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/contacts.json?key=YOUR_APIKEY

URL Parameters

Paramètre Defaut Optionnel Description
key Non Votre clé d'API
last_name Non Nom d'un mandataire/employé
first_name Oui Prénom d'un mandataire/employé




Financial API

Get Financial

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

La commande retourne le JSON suivant :

{
   "success":true,
   "groups":[
      {
         "metadata":{
            "label":"Bilan Comptable consolidé",
            "statement":"BILAN",
            "detail_level":"Synthetic",
            "type":"Consolide",
            "currency_code":"EUR",
            "rows":[
               {
                  "code":"IMMOS_INCORP",
                  "label":"Immobilisations incorporelles",
                  "total":true
               },
               {
                  "code":"IMMOS_CORP",
                  "label":"Immobilisations corporelles",
                  "total":true
               },
               ...
           ]
        },
        "dates":[
           {
              "closing_date":"2016-12-31",
              "duration_in_month":12,
              "rows":[
                 {
                    "code":"IMMOS_INCORP",
                    "value":31393000
                 },
                 {
                    "code":"IMMOS_CORP",
                    "value":101051000
                 },
                 ...
              ]
           },
          ...
        ]
     },
     {
        "metadata":{
           "label":"Bilan Comptable social",
           "statement":"BILAN",
           "detail_level":"Synthetic",
           "type":"Complet",
           "currency_code":"EUR",
           "rows":[
              {
                 "code":"IMMOS_INCORP",
                 "label":"Immobilisations incorporelles",
                 "total":true
              },
              {
                 "code":"IMMOS_CORP",
                 "label":"Immobilisations corporelles",
                 "total":true
              },
              ...
           ]
        },
        "dates":[
           {
              "closing_date":"2016-12-31",
              "duration_in_month":12,
              "rows":[
                 {
                    "code":"IMMOS_INCORP",
                    "value":3904044
                 },
                 {
                    "code":"IMMOS_CORP",
                    "value":26126233
                 },
                 ...
              ]
           },
           ...
        ]
     },
     {
        "metadata":{
           "label":"Compte de résultat consolidé",
           "statement":"PNL",
           "detail_level":"Synthetic",
           "type":"Consolide",
           "currency_code":"EUR",
           "rows":[
              {
                 "code":"CA_NET_EXPORT",
                 "label":"Dont C.A. réalisé à l'export",
                 "total":false
              },
              {
                 "code":"CA_NET_TOTAL",
                 "label":"Chiffres d’affaires nets Total",
                 "total":true
              },
              ...
           ]
        },
        "dates":[
           {
              "closing_date":"2016-12-31",
              "duration_in_month":12,
              "rows":[
                 {
                    "code":"AUTRES_PRODUITS_EXP",
                    "value":4732000
                 },
                 {
                    "code":"TOTAL_SALAIRES_CHARGES_EXT",
                    "value":174900000
                 },
                 ...
              ]
           },
           ...
        ]
     },
     ...
  ]
}

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

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
detailLevel Synthetic Oui Niveau de détail (voir ci-dessous)
statement Oui Filtre l'etat financier retourné (voir ci-dessous)
type Auto Oui Type de comptes (voir ci-dessous)

detailLevel

Nom Description
Synthetic Renvoie les principaux agrégats comptables
Full Renvoie toutes les lignes disponibles dans la liasse fiscale

statement

Les états financiers sont composés d’un bilan comptable et d’un compte de résultat. Par défaut l’API renvoie les deux. Ajoutez ce paramètre pour limiter au bilan comptable / compte de résultat

Nom Description
BILAN Limite au bilan comptable
PNL Limite au compte de résultat

type

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é. Ces comptes ne sont disponibles que pour les sociétés étant des têtes de groupes et publiant leurs comptes.
Complets : Comptes sociaux détaillés. Ces comptes correspondent aux comptes sociaux des sociétés remplissant au minimum 2 des 3 critères suivants : Total bilan supérieur à 3 650 000 euros et/ou Total chiffre d’affaires supérieur à 7 300 000 euros et/ou Nombre de salariés supérieur à 50.
Simplifiés : Comptes sociaux simplifiés. Les sociétés ont la possibilité de publier des comptes simplifiés lorsqu’elles remplissent au minimum 2 des 3 critères suivants : Total bilan inférieur ou égal à 1 000 000 euros et/ou Total chiffre d’affaires supérieur à 2 000 000 euros et/ou Nombre de salariés inférieur ou égal à 20.
Banque : Comptes simplifiés de banque. L’INPI ne divulgue que des comptes simplifiés pour les établissements bancaires.
Assurance : Comptes simplifiés d’assurance. L’INPI ne divulgue que des comptes simplifiés pour les sociétés d’assurance.

Ajoutez l'un des paramètres suivant pour sélectionner le/les types de comptes :

Nom Description
Auto Renvoie les comptes consolidés si disponibles, si ce n’est pas le cas renvoie les comptes sociaux (Complets, Simplifiés, Banque ou Assurance)
Social Renvoie les comptes sociaux (Complets, Simplifiés, Banque ou Assurance) même si les comptes consolidés sont disponibles
All Renvoie tous les comptes disponibles. Exemple : Consolidés + Complets / Simplifiés

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"
      },
      ...
  ]
}

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_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