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"

{
    "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"

{
   "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",
         "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"
         },
         "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",
         },
         "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/",
            "id": "le-bataclan",
            "tech_id": "25915726",
            "name": "LE BATACLAN",
            "description": "Bataclan has always been atypical amongst Parisian venues...",
            "follower_count": 2177,
            "crawl_date": "2022-01-24"
         },
         "twitter":{
            "url":"https://twitter.com/@bataclan_"
         },
         "facebook":{
            "url":"https://www.facebook.com/bataclanFR/"
         },
         "wikipedia":{

         }
      },
      "financials":{
         "last_sales": 460718,
         "last_profit": -694735,
         "last_staff": 6,
         "years": [
           {
             "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
             }
           },
           {
             "year": "2019",
             "sales": 3534212,
             "profit": -493913,
             "staff": 13,
             "closing_date": "2019-12-31",
             "sales_metadata": {
              "estimated": false
             },
             "profit_metadata": {
              "estimated": false
             },
             "staff_metadata": {
              "estimated": true
             }
           },
           {
             "year": "2018",
             "sales": 2425712,
             "profit": -518928,
             "staff": 3,
             "closing_date": "2018-12-31",
             "sales_metadata": {
              "estimated": false
             },
             "profit_metadata": {
              "estimated": false
             },
             "staff_metadata": {
              "estimated": true
             }
           },
          ...
         ],
         "last_staff_sources":[
            {
              "source": "Sirene",
              "range_value": "6-9",
              "date": "2017-01-01",
              "estimated": true
            },
            {
              "source": "Infogreffe",
              "value": 6,
              "date": "2020-01-01",
              "estimated": false
            },
            {
              "source": "Linkedin",
              "field": "employees_range",
              "range_value": "2-10",
              "date": "2022-03-29",
              "estimated": false
            },
            {
              "source": "Linkedin",
              "field": "employees_count",
              "value": 21,
              "date": "2022-03-29",
              "estimated": false
            }
         ]
      },
      "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"
         },
         ...
      ]
   }
}

{
...
  "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
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
organization.convention_collective.name	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.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.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.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"

{
   "success":true,
   "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":"5000",
         "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.2593109,
            "lat":48.8854852
         },
         "insee_category": {
            "code": "TPE",
            "name": "Très petite entreprise",
         },
         "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://pbs.twimg.com/profile_images/847791477010968577/YUmo0c9J_400x400.jpg",
         "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"
                }
            }
         ],
         "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\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 inteface 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": 474,
            "crawl_date": "2022-02-09"
         },
         "twitter":{
            "url":"https://twitter.com/@SocieteInfo"
         }
      },
      "financials":{
         "last_sales":490000,
         "last_profit":10657,
         "last_staff":5,
         "years":[
            {
               "year":"2022",
               "staff":5,
               "staff_metadata":{
                  "estimated":true
               }
            },
            {
               "year":"2019",
               "sales":490000,
               "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": "2022-03-12",
              "estimated": false
            },
            {
              "source": "Linkedin",
              "field": "employees_count",
              "value": 8,
              "date": "2022-03-12",
              "estimated": false
            }
         ]
      },
      "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
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"

{
   "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"

{
   "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	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é. 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	true pour inclure uniquement les sociétés disposant d'une convention collective	true
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 : NomMesure @ ValeurMin (optionel) @ ValeurMax (optionel))	EBE@2000000@4000000,EBE_CA@0.08
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

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"

{
  "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"

{
  "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"

{
  "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	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	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?name=tilkee&first_name=sylvain&last_name=tillon&key=DEMO"

curl "https://societeinfo.com/app/rest/api/v2/contact.json?email=sylvain@tilkee.com&key=DEMO"


{
  "success": true,
  "contact": {
    "id": "7891206491626992254",
    "civility": "Mr",
    "firstName": "Sylvain",
    "lastName": "TILLON",
    "domain_code": "DG",
    "domain_label": "Direction Générale",
    "level_code": "DIRIGEANT",
    "level_label": "Dirigeant",
    "role": "Fondateur | Webmaster",
    "email": "sylvain@tilkee.com",
    "email_score": 0.7,
    "email_test_result": "Risky",
    "email_test_reason": "Accept All",
    "email_test_date": "2022-03-31",
    "email_webmail": false,
    "linkedin_url": "https://www.linkedin.com/in/sylvaintillon/",
    "extraction_date": "2020-04-14",
    "hashcode": "561415271"
  },
  "company": {
    "id": "62327eb7afb96e54e71c4dc8",
    "registration_number": "789120649",
    "full_registration_number": "78912064900064",
    "legal_type": "Siege",
    "name": "TILKEE",
    "activity": "Edition de logiciel.",
    "formatted_address": "210 AVENUE JEAN JAURES 69007 LYON",
    "ape_code": "5829C",
    "ape_name": "Edition de logiciels applicatifs",
    "address": {
      "street": "210 AVENUE JEAN JAURES",
      "postal_code": "69007",
      "city": "LYON",
      "country_code": "FR",
      "country": "FRANCE",
      "lng": 4.842,
      "lat": 45.7452
    },
    "juridical_form_code": "5710",
    "juridical_form_name": "Société par actions simplifiée",
    "website_url": "http://www.tilkee.com/",
    "linkedin_url": "https://www.linkedin.com/company/tilkee/",
    "generic_email": "contact@tilkee.com",
    "last_sales": 807782,
    "last_profit": -1162465,
    "last_staff": 32,
    "insee_category": {
      "code": "NON_DEFINIE",
      "name": "Non définie"
    }
  }
}

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

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

{
  "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",
    "generic_phone": "01 76 35 13 26",
    "last_sales": 490000,
    "last_profit": 10657,
    "last_staff": 5,
    "insee_category": {
      "code": "TPE",
      "name": "Très petite entreprise"
    }
  },
  "email_domains":[
    {
      "domain":"societeinfo.com",
      "pattern":"{first}.{last}"
    },
    {
      "domain":"societeinfo.com",
      "pattern":"{first}"
    }
  ],
  "contacts":[
    {
      "id": "8301343831281918940",
      "civility": "Mr",
      "firstName": "Alexandre",
      "lastName": "CONRAUD",
      "domain_code": "DG",
      "domain_label": "Direction Générale",
      "level_code": "DIRIGEANT",
      "level_label": "Dirigeant",
      "role": "Associé | Ceo",
      "email": "alexandre.conraud@societeinfo.com",
      "email_score": 0.93,
      "email_test_result": "Safe to Send",
      "email_test_reason": "Deliverable",
      "email_test_date": "2022-01-11",
      "email_webmail": false,
      "linkedin_url": "https://www.linkedin.com/in/alexandre-conraud/",
      "extraction_date": "2021-04-12",
      "hashcode": "2105357818"
  },
  {
      "id": "830134383621532388",
      "civility": "Mr",
      "firstName": "Antoine",
      "lastName": "ONNEN",
      "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.93,
      "email_test_result": "Safe to Send",
      "email_test_reason": "Deliverable",
      "email_test_date": "2022-01-10",
      "email_webmail": false,
      "hashcode": "58476968"
  }
  ...
  ],
  "contacts_count": 7,
  "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_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
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

https://societeinfo.com/app/rest/api/v2/contacts.json?name=tilkee&contact_domain_code=MARKETING&key=DEMO

{  
   "success":true,
  "company": {
    "id": "62327eb7afb96e54e71c4dc8",
    "registration_number": "789120649",
    "full_registration_number": "78912064900064",
    "legal_type": "Siege",
    "name": "TILKEE",
    "activity": "Edition de logiciel.",
    "formatted_address": "210 AVENUE JEAN JAURES 69007 LYON",
    "ape_code": "5829C",
    "ape_name": "Edition de logiciels applicatifs",
    "address": {
      "street": "210 AVENUE JEAN JAURES",
      "postal_code": "69007",
      "city": "LYON",
      "country_code": "FR",
      "country": "FRANCE",
      "lng": 4.842,
      "lat": 45.7452
    },
    "juridical_form_code": "5710",
    "juridical_form_name": "Société par actions simplifiée",
    "website_url": "http://www.tilkee.com/",
    "linkedin_url": "https://www.linkedin.com/company/tilkee/",
    "generic_email": "contact@tilkee.com",
    "last_sales": 807782,
    "last_profit": -1162465,
    "last_staff": 32,
    "insee_category": {
      "code": "NON_DEFINIE",
      "name": "Non définie"
    }
  },
   "email_patterns":[  
      {
        "domain": "tilkee.com",
        "pattern": "{first}"
      }
    ],
    "contacts":[  
      {
        "id": "7891206491626992254",
        "civility": "Mr",
        "firstName": "Sylvain",
        "lastName": "TILLON",
        "domain_code": "MARKETING",
        "domain_label": "Marketing",
        "level_code": "DIRECTEUR",
        "level_label": "Directeur",
        "role": "Chief marketing officer",
        "email": "sylvain@tilkee.com",
        "email_score": 0.7,
        "email_test_result": "Risky",
        "email_test_reason": "Accept All",
        "email_test_date": "2022-03-31",
        "email_webmail": false,
        "linkedin_url": "https://www.linkedin.com/in/sylvaintillon/",
        "extraction_date": "2020-04-14",
        "hashcode": "561415271"
      },
      {
        "id": "7891206491789031704",
        "civility": "Mr",
        "firstName": "Florian",
        "lastName": "SANZ",
        "domain_code": "MARKETING",
        "domain_label": "Marketing",
        "level_code": "RESPONSABLE",
        "level_label": "Responsable",
        "role": "Product manager",
        "email": "florian@tilkee.com",
        "email_score": 0.74,
        "email_test_result": "Risky",
        "email_test_reason": "Accept All",
        "email_test_date": "2022-03-31",
        "email_webmail": false,
        "linkedin_url": "https://www.linkedin.com/in/florian-sanz/",
        "extraction_date": "2022-03-31",
        "hashcode": "2097684347"
      },
      {  
        "id": "7891206491979534535",
        "civility": "Mrs",
        "firstName": "Emilie",
        "lastName": "BOUET",
        "domain_code": "MARKETING",
        "domain_label": "Marketing",
        "level_code": "RESPONSABLE",
        "level_label": "Responsable",
        "role": "Growth marketing manager",
        "email": "emilie@tilkee.com",
        "email_score": 0.72,
        "email_test_result": "Risky",
        "email_test_reason": "Accept All",
        "email_test_date": "2022-03-31",
        "email_webmail": false,
        "linkedin_url": "https://www.linkedin.com/in/emilie-bouet-19a1a1a4/",
        "extraction_date": "2021-12-30",
        "hashcode": "555619143"
      }
   ],
   "contacts_count": 3,
   "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
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

Et paramètres optionnels de filtres sur les contacts

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"


{
  "success": true,
  "contacts": [
      {
        "id": "8301343831281918940",
        "civility": "Xx",
        "firstName": "Xxxxx",
        "lastName": "XXXXXXXX",
        "domain_code": "DG",
        "domain_label": "Direction Générale",
        "level_code": "DIRIGEANT",
        "level_label": "Dirigeant",
        "role": "Ceo",
        "email": "xx@xx.xx",
        "email_score": 0.92,
        "email_test_result": "Safe to Send",
        "email_test_reason": "Deliverable",
        "email_test_date": "2022-02-17",
        "email_webmail": false,
        "linkedin_url": "https://fr.linkedin.com/in/x",
        "extraction_date": "2021-04-12",
        "anonymized": true,
        "hashcode": "2105357818"
      },
      {
        "id": "830134383621532388",
        "civility": "Xx",
        "firstName": "Xxxxx",
        "lastName": "XXXXXXXX",
        "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.92,
        "email_test_result": "Safe to Send",
        "email_test_reason": "Deliverable",
        "email_test_date": "2022-02-17",
        "email_webmail": false,
        "linkedin_url": "https://fr.linkedin.com/in/x",
        "extraction_date": "2018-04-01",
        "anonymized": true,
        "hashcode": "2138574689"
      }
      ...
  ],
  "contacts_count": 7
}

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


{
  "success": true,
  "contacts": [
    {
      "id": "830134383621532388",
      "civility": "Mr",
      "firstName": "Antoine",
      "lastName": "ONNEN",
      "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.92,
      "email_test_result": "Safe to Send",
      "email_test_reason": "Deliverable",
      "email_test_date": "2022-02-17",
      "email_webmail": false,
      "linkedin_url": "https://www.linkedin.com/in/antoine-onnen-4376242/",
      "extraction_date": "2018-04-01",
      "hashcode": "2138574689"
    }
  ],
  "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

Et paramètres obligatoires d'identification d'entreprise
Et paramètres optionnels de filtres sur les contacts

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"

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

{
   "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.

Extra API

Get Bodacc

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

{
    "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"

{
   "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