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/552121634?key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "result":{
      "id":"58796f37b3a2806717d059bf",
      "organization":{
         "status":"Active",
         "risk":{
            "collective_procedure_in_progress":false
         },
         "creation_date":"1955-01-01",
         "capital":"146338",
         "registration_number":"552121634",
         "full_registration_number":"55212163400059",
         "vat_number":"FR92552121634",
         "greffe_name":"Paris",
         "name":"L'OLYMPIA",
         "activity":{
            "ape_code":"9004Z",
            "ape_code_level1":"RU",
            "ape_code_level2":"RZ",
            "ape_code_level3":"90",
            "ape_code_level4":"R90Z",
            "ape_code_level5":"9004Z",
            "ape_name":"Gestion de salles de spectacles",
            "corporate_object":"Gestion de salles de spectacles"
         },
         "legal":{
            "name":"Société par actions simplifiée",
            "code_level1": "5",
            "code_level2": "57",
            "code_level3": "5710",
            "person_type":"LegalEntity",
            "type":"Siege"
         },
         "address":{
            "street":"18 RUE DE CAUMARTIN",
            "postal_code":"75009",
            "city":"Paris",
            "country_code": "FR",
            "country": "FRANCE",
            "lng":2.3399,
            "lat":48.8718
         },
         "last_legal_update_date":"2018-08-03",
         "establishments_count":0
      },
      "contacts":{
         "corporate_officiers":[
            {
               "firstName":"Simon",
               "lastName":"Gillham",
               "name":"Simon Gillham",
               "birth_date":"1956-02-24",
               "role":"Président",
               "role_start_date":"2016-06-20",
               "company":false
            },
            {
               "firstName":"Christian",
               "lastName":"Soulabaille",
               "name":"Christian Soulabaille",
               "birth_date":"1961-03-06",
               "role":"Directeur général",
               "role_start_date":"2016-06-20",
               "company":false
            },
            {
               "firstName":"Laurent",
               "lastName":"de Cerner",
               "name":"Laurent de Cerner",
               "birth_date":"1974-07-05",
               "role":"Directeur général",
               "role_start_date":"2016-06-20",
               "company":false
            },
            ...
         ],
         "email":"contact@olympiahall.com",
         "emails":[
            {
               "value":"contact@olympiahall.com",
               "type":"generic"
            }
         ],
         "phones":[
            {
               "value":"08 92 68 33 68"
            },
            {
               "value":"01 55 27 10 00"
            }
         ]
      },
      "web_infos":{
         "logo_url":"https://www.olympiahall.com/assets/images/illustrations/olympia-logo.png",
         "website_url":"http://www.olympiahall.com/",
         "websites":[
            {
                "domain": "olympiahall.com",
                "url": "http://www.olympiahall.com/",
                "description": "L’Olympia | Le music hall à Paris | Assistez aux concerts et spectacles humour/one man show des plus grands artistes dans une salle mythique.",
                "webmaster_email": "domaine.vivendi@vivendi.com",
                "webmaster_phone": "01 71 71 10 00",
                "techno_types": [
                    "php",
                    "joomla",
                    "recaptcha",
                    "yoastseo",
                    "xmlrpc",
                    "googletagmanager",
                    "googleanalytics"
                ]
            }
         ],
         "linkedin":{
            "url":"https://www.linkedin.com/company/l%27olympia-bruno-coquatrix"
         },
         "twitter":{
            "url":"https://twitter.com/@OLYMPIAHALL"
         },
         "facebook":{
            "url":"https://www.facebook.com/olympiabrunocoquatrix/"
         },
         "wikipedia":{
            "url":"https://fr.wikipedia.org/wiki/Olympia_(Paris)"
         }
      },
      "financials":{
         "last_sales":26026792,
         "last_profit":660363,
         "last_staff":36,
         "years":[
            {
               "year":"2017",
               "sales":26026792,
               "profit":660363,
               "staff":36,
               "closing_date":"2017-12-31"
            },
            {
               "year":"2016",
               "sales":25168465,
               "profit":985145,
               "staff":20,
               "closing_date":"2016-12-31"
            },
            {
               "year":"2015",
               "sales":27291684,
               "profit":1272962,
               "closing_date":"2015-12-31"
            },
            {
               "year":"2014",
               "sales":27960548,
               "profit":187032,
               "staff":35,
               "closing_date":"2014-12-31"
            },
            {
               "year":"2013",
               "sales":31441931,
               "profit":943442,
               "staff":36,
               "closing_date":"2013-12-31"
            },
            {
               "year":"2012",
               "sales":31376987,
               "profit":1149392
            }
         ]
      },
      "mark_infos":{
         "classes":[
            {
               "number":"9",
               "description":"Supports de sons et/ou d'images enregistrés et non enregistrés (à l'exception de films non exposés) ; enregistrements musicaux sonores et vidéo ; supports d'enregistrement magnétiques ; logiciels, notamment pour télécharger de la musique, du son, des images et du texte par des réseaux d'ordinateur ou de télécommunications. Musique, sonneries, fichiers MP3 et vidéos téléchargeables."
            },
            {
               "number":"41",
               "description":"Éducation ; formation ; divertissement ; activités sportives et culturelles. Informations en matière de divertissement ou d'éducation. Services de loisirs. Publication de livres. Services d'édition de livres d'albums, de catalogues et de programmes. Prêt de livres. Dressage d'animaux. Production de films sur bandes vidéos. Location de films cinématographiques. Location d'enregistrements sonores. Location de magnétoscopes ou de postes de radio et de télévision. Location de décors de spectacles. Montage de bandes vidéo. Services de photographie. Organisation de concours (éducation ou divertissement). Organisation et conduite de colloques, conférences ou congrès. Organisation d'expositions à buts culturels ou éducatifs. Réservation de places de spectacles. Services de jeux proposés en ligne (à partir d'un réseau informatique). Services de jeux d'argent. Publication électronique de livres et de périodiques en ligne. Micro-édition."
            },
            ...
         ],
         "marks":[
            {
               "name":"OH! BY L OLYMPIA",
               "application_date":"2016-12-20"
            },
            {
               "name":"Olympia by Night",
               "application_date":"2016-02-03"
            },
            {
               "name":"L'OLYMPIA",
               "application_date":"2015-11-26"
            },
            ...
         ]
      },
      "last_bodacc":{
         "type":"Bodacc",
         "bodacc_type":"Avis de dépôts des comptes des sociétés",
         "parution_date":"2018-08-02",
         "number":"15479",
         "rcs_name":"552121634 RCS Paris",
         "legal_name":"L'OLYMPIA",
         "legal_status":"Société par actions simplifiée (à associé unique)",
         "address":"18 rue de Caumartin 75009 Paris",
         "balance_sheet_close_date":"2017-12-30",
         "balance_sheet_deposit_type":"Comptes annuels et rapports"
      },
      "actes":[
         {
            "date":"2018-04-19",
            "type":"Document relatif au bénéficiaire effectif"
         },
         {
            "date":"2016-06-20",
            "type":"Extrait de procès-verbal",
            "description":"Nomination de directeur général"
         },
         {
            "date":"2015-07-29",
            "type":"Statuts mis à jour"
         },
         ...
      ]
   }
}

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

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.contacts.corporate_officiers	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.facebbok.url	Url Facebook
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

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":{
            "collective_procedure_in_progress":false
         },
         "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":"2018-07-12",
         "establishments_count":0
      },
      "contacts":{
         "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'entreprises (OPEN DATA, SIRENE, Infogreffe, WEB, BODACC, INPI) pour vous offrir toujours plus de données d'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"
                ]
            }
         ],
         "twitter":{
            "url":"https://twitter.com/@SocieteInfo"
         }
      },
      "financials":{
         "last_sales":26696,
         "last_profit":10658,
         "years":[
            {
               "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.75,
          "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%20d&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&searchMode=keyword&limit=10&key=DEMO"

La commande retourne le JSON suivant :

{
   "success":true,
   "total":6423,
   "currentPage":1,
   "totalPages":643,
   "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.

HTTP Request

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

Query 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
personQuery		Oui	Termes spécifiés pour la recherche de personnes (nom et poste)
searchMode	keyword	Oui	Spécifie quel type de recherche est appliqué à la query. (voir ci-dessous)
placeId		Oui	Id qui identifie un lieu de manière unique. L'identifiant est retourné par le service Place Autocomplete. Filtre les entreprises sur la place définie.
where		Oui	Filtre les entreprises avec le code postal ou à 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
withemail		Oui	avec un mail 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.
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

Contact API

Get Contacts

curl "https://societeinfo.com/app/rest/api/v2/contacts.json/789120649?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.fr",
         "pattern":"{first}"
      },
      {  
         "domain":"tilkee.com"
      },
      {  
         "domain":"jeprospecte.com"
      }
   ],
   "contacts":[  
      {  
         "firstName":"Sylvain",
         "lastName":"TILLON",
         "role":"Directeur général",
         "email":"sylvain@tilkee.fr",
         "email_score":84
      },
      {  
         "firstName":"Timothée",
         "lastName":"SAUMET",
         "role":"‎cto & co-founder",
         "email":"timothee@tilkee.fr",
         "email_score":22,
         "linkedin_url":"https://fr.linkedin.com/in/timsaumet/fr"
      },
      ...
   ],
   "emails":[  
      {  
         "value":"sylvain@tilkee.fr",
         "type":"personal",
         "sources": [
            {
               "url": "https://fr.slideshare.net/sylvaintillon/dossier-depressetilkee"
            },
            {
               "url": "www.pertinence-invest.com/IMG/pdf/cp_tilkee_vdef.pdf"
            },
            {
               "url": "www.medeflyonrhone.fr/wp-content/uploads/2014/03/livret-présentation.pdf"
            }
         ]
      },
      {  
         "value":"support@tilkee.com",
         "type":"generic",
         "sources":[  
            {  
               "url":"https://chrome.google.com/webstore/detail/tilkee-for-gmail/hdnfcpjnbaelecfgjaebambpofifhhgg?hl=fr"
            }
         ]
      },
      {  
         "value":"contact@tilkee.com",
         "type":"generic",
         "sources":[  
            {  
               "url":"https://apkmeet.com/fr/apk/784065-com.soluti.tilkee.tilkeemobile"
            }
         ]
      },
      ...
   ]
}

Ce service permet de récupérer les contacts et emails des employés d'une entreprise à partir d'un code SIREN. 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.

HTTP Request

GET https://societeinfo.com/app/rest/api/v2/contacts.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

Enrich Contacts

curl "https://societeinfo.com/app/rest/api/v2/contacts.json?name=tilkee&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.fr",
         "pattern":"{first}"
      },
      {  
         "domain":"tilkee.com"
      },
      {  
         "domain":"jeprospecte.com"
      }
   ],
   "contacts":[  
      {  
         "firstName":"Sylvain",
         "lastName":"TILLON",
         "role":"Directeur général",
         "email":"sylvain@tilkee.fr",
         "email_score":84
      },
      {  
         "firstName":"Timothée",
         "lastName":"SAUMET",
         "role":"‎cto & co-founder",
         "email":"timothee@tilkee.fr",
         "email_score":22,
         "linkedin_url":"https://fr.linkedin.com/in/timsaumet/fr"
      },
      ...
   ],
   "emails":[  
      {  
         "value":"sylvain@tilkee.fr",
         "type":"personal",
         "sources": [
            {
               "url": "https://fr.slideshare.net/sylvaintillon/dossier-depressetilkee"
            },
            {
               "url": "www.pertinence-invest.com/IMG/pdf/cp_tilkee_vdef.pdf"
            },
            {
               "url": "www.medeflyonrhone.fr/wp-content/uploads/2014/03/livret-présentation.pdf"
            }
         ]
      },
      {  
         "value":"support@tilkee.com",
         "type":"generic",
         "sources":[  
            {  
               "url":"https://chrome.google.com/webstore/detail/tilkee-for-gmail/hdnfcpjnbaelecfgjaebambpofifhhgg?hl=fr"
            }
         ]
      },
      {  
         "value":"contact@tilkee.com",
         "type":"generic",
         "sources":[  
            {  
               "url":"https://apkmeet.com/fr/apk/784065-com.soluti.tilkee.tilkeemobile"
            }
         ]
      },
      ...
   ]
}

Ce service vous permet de chercher les contacts sans disposer du numéro SIREN 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/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
first_name		Oui	Prénom d'un mandataire/employé
last_name		Oui	Nom d'un mandataire/employé
domain_search_mode	requested_domain	Oui	Actif uniquement si domain_name est renseigné. Limite les domaines mail retournés au domaine_name spécifié. (voir ci-dessous)
min_match_score	0	Oui	Ne retourne un résultat que si le score de matching company_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

domain_search_mode

Optionnel, Limite les domaines mail retournés au domaine_name spécifié.

Nom	Description
requested_domain	Limite les domaines mail retournés au domaine_name spécifié.
auto	Etends la détection de domaine mail à tous les domaines appartenant par la société. Utiliser ce mode quand le domaine_name spécifié est un site web.

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)

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