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": {
"risk_level": 0,
"collective_procedure_in_progress": false,
"collective_procedures": [],
"legal_source_organization_statuses": [
{
"source_name": "RCS",
"organization_status": "Active"
},
{
"source_name": "INSEE",
"organization_status": "Active"
},
{
"source_name": "Bodacc",
"organization_status": "Active"
}
]
},
"creation_date":"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": "2019-08-09",
"establishments_count":0
},
"contacts":{
"main_corporate_officier": {
"firstName":"Simon",
"lastName":"Gillham",
"name":"Simon Gillham",
"birth_date":"1956-02-24",
"role":"Président",
"role_start_date":"2016-06-20",
"company":false
},
"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":26916756,
"last_profit":922684,
"last_staff":20,
"years":[
{
"year":"2018",
"sales":26916756,
"profit":922684,
"closing_date": "2018-12-31"
},
{
"year":"2017",
"sales":26026792,
"profit":660363,
"staff":20,
"closing_date":"2017-12-31"
},
{
"year":"2016",
"sales":25168465,
"profit":985145,
"staff":32,
"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": "2019-08-08",
"number": "14311",
"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": "2018-12-31",
"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"
},
...
]
}
}
Exemple de risk
{
...
"risk": {
"risk_level": 4,
"collective_procedure_in_progress": false,
"collective_procedures": [
{
"collective_procedure_type": "Liquidation judiciaire",
"collective_procedure_startdate": "2018-03-13",
"collective_procedure_startmessage": "Jugement prononçant la liquidation judiciaire , date de cessation des paiements le 12 Avril 2017, désignant liquidateur XXX . Les créances sont à déclarer, dans les deux mois de la présente publication, auprès du liquidateur ou sur le portail électronique à l'adresse https://www.creditors-services.com.",
"collective_procedure_enddate": "2019-03-20",
"collective_procedure_endmessage": "Jugement prononçant la clôture de la procédure de liquidation judiciaire pour insuffisance d'actif.",
"collective_procedure_status": "Closed"
}
],
"legal_source_organization_statuses": [
{
"source_name": "RCS",
"organization_status": "Dead",
"organization_status_date": "2019-03-21"
},
{
"source_name": "INSEE",
"organization_status": "Active"
},
{
"source_name": "Bodacc",
"organization_status": "Dead"
}
]
}
...
}
Ce service retourne les informations détaillées d'une entreprise (données légales, chiffres clés, dirigeants, mails génériques, sites web, réseaux sociaux, marques...) à partir d'un code SIREN ou d'un code SIRET
Une sandbox avec un exemple en jquery est disponible sur github ici
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/company.json/<registration_number>?key=YOUR_APIKEY
GET https://societeinfo.com/app/rest/api/v2/company.json/<id>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| registration_number | Non | Numéro SIREN ou SIRET de l'entreprise | |
| id | Oui | Identifiant societeinfo de l'entreprise | |
| withEstablishments | false | Oui | Inclue les établissements du siège. Les valeurs possibles sont true ou false |
| withContactApiCount | false | Oui | Comptabilise les contacts disponibles sur l'API contact. Les valeurs possibles sont true ou false |
| withKeywords | false | Oui | Inclue les mots clés de la société. Les valeurs possibles sont true ou false |
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| organization.status | Statut | Active, Sleeping, Dead |
| organization.name | Dénomination | |
| organization.commercial_name | Nom commercial | |
| organization.business_name | Nom enseigne | |
| organization.acronym_name | Sigle | |
| organization.legal.type | Type établissement | Siege, SecondaryEstablishment |
| organization.legal.person_type | Personnalité légale | LegalEntity, Individual |
| organization.registration_number | N° SIREN | |
| organization.full_registration_number | N° SIRET | |
| organization.vat_number | N° TVA UE | |
| organization.legal.name | Forme juridique | |
| organization.legal.code_level1 | Forme juridique code Niv.1 | |
| organization.legal.code_level2 | Forme juridique code Niv.2 | |
| organization.legal.code_level3 | Forme juridique code Niv.3 | |
| organization.address.street | Adresse | |
| organization.address.postal_code | Code postal | |
| organization.address.city | Ville | |
| organization.capital | Capital social (en €) | |
| organization.address.postal_address_additional_name | Complément nom (adressage) | |
| organization.creation_date | Date de création | |
| organization.closing_date | Date de radiation | |
| organization.last_legal_update_date | Dernière mise à jour légale | |
| organization.greffe_name | Greffe | |
| organization.contacts.main_corporate_officier | Dirigeant principal | |
| organization.contacts.main_corporate_officier.firstName | Prénom | |
| organization.contacts.main_corporate_officier.lastName | Nom | |
| organization.contacts.main_corporate_officier.name | Prénom Nom ou Dénomination | |
| organization.contacts.main_corporate_officier.birth_date | Date de naissance | |
| organization.contacts.main_corporate_officier.role | Mandat | |
| organization.contacts.main_corporate_officier.role_start_date | Date de début de mandat | |
| organization.contacts.main_corporate_officier.company | Personne morale ou Personne physique | true/false |
| organization.contacts.corporate_officiers | Liste des mandataires | |
| organization.activity.corporate_object | Objet social | |
| organization.activity.ape_code | Code APE | |
| organization.activity.ape_code_level1 | Code NAF Niv.1 | |
| organization.activity.ape_code_level2 | Code NAF Niv.2 | |
| organization.activity.ape_code_level3 | Code NAF Niv.3 | |
| organization.activity.ape_code_level4 | Code NAF Niv.4 | |
| organization.activity.ape_code_level5 | Code NAF Niv.5 | |
| organization.financials.last_sales | Chiffre d'affaire | |
| organization.financials.last_profit | Résultat net | |
| organization.financials.last_staff | Nombre d'employés | |
| organization.web_infos.website_url | Url du site web principal | |
| organization.web_infos.websites | Site webs | |
| organization.web_infos.linkedin.url | Url Linkedin | |
| organization.web_infos.twitter.url | Url Twitter | |
| organization.web_infos.facebook.url | Url Facebook | |
| organization.web_infos.wikipedia.url | Url Wikipedia | |
| organization.web_infos.keywords | Mots et poids des termes clés de la société | |
| contacts.phones | Téléphones | |
| contacts.email | Email générique principal | |
| contacts.emails | Emails génériques | |
| contacts.corporate_officiers | Mandataires légaux | |
| contacts.contact_api_count | Nombre de contacts disponibles dans l'API contact |
Modèle de risque
| Champs | Description | Valeurs possibles |
|---|---|---|
| organization.risk.risk_level | Niveau de risque du siège | 0-4 (voir tableau ci dessous) |
| organization.risk.collective_procedure_in_progress | Procédure collective en cours | true/false |
| organization.risk.legal_source_organization_statuses.source_name | Fournisseur de data | RCS, INSEE, Bodacc |
| organization.risk.legal_source_organization_statuses.organization_status | Statut | Active, Sleeping, Dead |
| organization.risk.legal_source_organization_statuses.organization_status_date | Statut | Date de fermeture |
| organization.risk.collective_procedures.collective_procedure_type | Type de procédure collectives | |
| organization.risk.collective_procedures.collective_procedure_startdate | Date d'ouverture | |
| organization.risk.collective_procedures.collective_procedure_startmessage | Libellé jugement | |
| organization.risk.collective_procedures.collective_procedure_enddate | Date de clôture | |
| organization.risk.collective_procedures.collective_procedure_endmessage | Libellé jugement | |
| organization.risk.collective_procedures.collective_procedure_status | Etat | Open, Closed |
Calcul de risque
| Valeur | Description |
|---|---|
| 0 | Société active ET pas de procédures collectives ou aucune procédure collective (sauf liquidation) clôturée depuis plus de 5 ans |
| 1 | Société active ET une procédure collective clôturée (sauf liquidation) depuis moins de 5 ans |
| 2 | Société active ET Au moins une procédure collective en cours (quelque soit son type) |
| 3 | Un indicateur de radiation OU (Société active ET procédure collective de liquidation clôturée) |
| 4 | Société clôturée OU (un indicateur de radiation ET une procédure collective de liquidation terminée) |
Enrich Company
curl "https://societeinfo.com/app/rest/api/v2/company.json?name=smart%20data&postal_code=92200&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"result":{
"id":"593b6fa6b3a2feb79d4f9f39",
"organization":{
"status":"Active",
"risk": {
"risk_level": 0,
"collective_procedure_in_progress": false,
"collective_procedures": [],
"legal_source_organization_statuses": [
{
"source_name": "RCS",
"organization_status": "Active"
},
{
"source_name": "INSEE",
"organization_status": "Active"
},
{
"source_name": "Bodacc",
"organization_status": "Active"
}
]
},
"creation_date":"2017-06-05",
"capital":"5000",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"vat_number":"FR38830134383",
"greffe_name":"Nanterre",
"name":"SMART DATA",
"activity":{
"ape_code":"4741Z",
"ape_code_level1":"GZ",
"ape_code_level2":"GZ",
"ape_code_level3":"47",
"ape_code_level4":"G47Z",
"ape_code_level5":"4741Z",
"ape_name":"Commerce de détail d'ordinateurs, d'unités périphériques et de logiciels en magasin spécialisé",
"corporate_object":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet"
},
"legal":{
"name":"Société par actions simplifiée",
"code_level1": "5",
"code_level2": "57",
"code_level3": "5710",
"person_type":"LegalEntity",
"type":"Siege"
},
"address":{
"street":"176 AVENUE CHARLES DE GAULLE",
"postal_code":"92200",
"city":"Neuilly-sur-Seine",
"country_code":"FR",
"country": "FRANCE",
"lng":2.2593109,
"lat":48.8854852
},
"last_legal_update_date": "2019-09-11",
"establishments_count":0
},
"contacts":{
"main_corporate_officier": {
"firstName":"Antoine",
"lastName":"ONNEN",
"name":"Antoine ONNEN",
"birth_date":"1977-03-07",
"role":"Président",
"role_start_date":"2017-06-09",
"company":false
},
"corporate_officiers":[
{
"firstName":"Antoine",
"lastName":"ONNEN",
"name":"Antoine ONNEN",
"birth_date":"1977-03-07",
"role":"Président",
"role_start_date":"2017-06-09",
"company":false
},
{
"firstName":"Alexandre",
"lastName":"CONRAUD",
"name":"Alexandre CONRAUD",
"role":"Directeur général",
"role_start_date":"2017-06-09",
"company":false
}
],
"email":"contact@societeinfo.com",
"emails":[
{
"value":"contact@societeinfo.com",
"type":"generic"
}
],
"phones":[]
},
"web_infos":{
"logo_url":"https://societeinfo.com/wp-content/uploads/2017/01/Logomakr_28eUEg-1.png",
"website_url":"http://www.societeinfo.com/",
"websites":[
{
"domain": "societeinfo.com",
"url": "http://www.societeinfo.com/",
"description": "Societeinfo agrège des millions de données d'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":"2018",
"closing_date": "2018-12-31"
},
{
"year":"2017",
"sales":26696,
"profit":10658,
"closing_date":"2017-05-31"
}
]
},
"last_bodacc":{
"type":"Bodacc",
"bodacc_type":"Avis de dépôts des comptes des sociétés",
"parution_date":"2018-07-11",
"number":"18689",
"rcs_name":"830134383 RCS Nanterre",
"legal_name":"SMART DATA",
"legal_status":"Société par actions simplifiée",
"address":"176 avenue Charles de Gaulle 92200 Neuilly-sur-Seine",
"balance_sheet_close_date":1514674800000,
"balance_sheet_deposit_type":"Comptes annuels et rapports"
},
"actes":[
{
"date":"2018-05-24",
"type":"Document relatif au bénéficiaire effectif"
},
{
"date":"2017-06-09",
"type":"Statuts constitutifs"
}
]
},
"match_info": {
"score": 0.8,
"sources": "Nom Adresse"
}
}
Ce service vous permet d'enrichir vos données si vous ne disposez pas du numéro SIREN de l'entreprise. Il retourne les données complètes de l'entreprise.
Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/company.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| name | Oui | Nom de l'entreprise | |
| street | Oui | Rue et voie OU voie | |
| street2 | Oui | Complément d'adresse | |
| postal_code | Oui | Code postal | |
| city | Oui | Ville | |
| domain_name | Oui | Nom de domaine OU url du site web | |
| 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&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.
Pour ajouter des critères avancés sur les sociétés possédant des contacts, consultez la section Search Contacts
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY
Company Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| page | 1 | Oui | Numéro de la page de résultats |
| limit | 10 | Oui | Nombre de résultats par page. Limité à 25. |
| query | Oui | Termes spécifiés pour la recherche | |
| searchMode | keyword | Oui | Spécifie quel type de recherche est appliqué à la query. (voir ci-dessous) |
| placeId | Oui | Interrogez le service Place Autocomplete, puis spécifiez l'identifiant de place retourné. Filtre les entreprises par région/département/code postal/ville/rue | |
| where | Oui | Filtre les entreprises avec le code postal/la ville définie | |
| active | true | Oui | Inclue dans les résultats les entreprises inactives. Les valeurs possibles sont true ou false |
| withEstablishments | false | Oui | Inclue les établissements. Les valeurs possibles sont true ou false |
| nafLevel | Oui | Filtre les entreprises avec la codification NAF définie. Exemple : nafLevel=61&nafLevel=6201Z | |
| nafLevelsExclude | Oui | Ajoutez ce paramètre pour exclure les codes NAF définis. Les valeurs possibles sont true ou false | |
| juridicalFormLevel | Oui | Filtre les entreprises avec la codification des formes juridiques définie. Exemple : juridicalFormLevel=1&juridicalFormLevel=57 | |
| juridicalFormlevelsExclude | Oui | Ajoutez ce paramètre pour exclure les formes juridiques définies. Les valeurs possibles sont true ou false | |
| minsales | Oui | Filtre les entreprises avec un chiffre d'affaire supérieur. | |
| maxsales | Oui | Filtre les entreprises avec un chiffre d'affaire inférieur. | |
| minprofits | Oui | Filtre les entreprises avec un bénéfice supérieur. | |
| maxprofits | Oui | Filtre les entreprises avec un bénéfice inférieur. | |
| minstaff | Oui | Filtre les entreprises avec un effectif supérieur. | |
| maxstaff | Oui | Filtre les entreprises avec un effectif inférieur. | |
| mincreationdate | Oui | Filtre les entreprises avec une date de création supérieur. (format YYYYMMDD) | |
| maxcreationdate | Oui | Filtre les entreprises avec une date de création inférieur. (format YYYYMMDD) | |
| minceobirthdate | Oui | Filtre les entreprises dont la date de naissance du ceo est supérieur. (format YYYYMMDD) | |
| maxceobirthdate | Oui | Filtre les entreprises dont la date de naissance du ceo est inférieur. (format YYYYMMDD) | |
| withsite | Oui | avec un site web identifié. Les valeurs possibles sont true ou false | |
| withphone | Oui | avec un téléphone identifié. Les valeurs possibles sont true ou false | |
| withLinkedin | Oui | avec un compte linkedin corporate identifié. Les valeurs possibles sont true ou false | |
| withemail | Oui | avec un email générique identifié. Les valeurs possibles sont true ou false | |
| email_test_status | all | Oui | Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe |
| withFacebook | Oui | avec un compte facebook identifié. Les valeurs possibles sont true ou false | |
| withtwitter | Oui | avec un compte twitter identifié. Les valeurs possibles sont true ou false | |
| mintwitterfollowers | Oui | Filtre les entreprises avec un nombre de follower twitter supérieur. | |
| mintwitterfriends | Oui | Ajoutez ce paramètre pour trier les résultats. Les valeurs possibles sont les suivantes. | |
| withHighlight | false | Oui | Ajoutez ce paramètre pour ajouter à la réponse la source des mots clés. Les valeurs possibles sont true ou false |
| sort | score | Oui | Spécifie le tri des résultat. Valeurs possibles dans le tableau suivant (voir ci-dessous) |
Search Mode
Le paramètre SearchMode permet de spécifier les types de données sur lequels la query est appliquée
| Nom | Description |
|---|---|
| keyword | Applique la query sur les contenus texte associé à l'entreprise (sources légales, code APE, sites web, réseaux sociaux...). Applique la personQuery sur l'ensemble des données de contact. Supporte les opérateurs booléens AND, OR, NOT (défaut) |
| legalname | Applique la query sur les termes de la raison sociale. |
| name | Applique la query sur les noms (dénomination, nom commercial, sigle) et marques. |
| autocomplete | Applique la query sur les caractères de la raison sociale. Cette option revient à utiliser le service dédié d'AutoComplete (personQuery non appliqué). |
| auto | Exécute une query 'legalname', puis une query 'keyword' si le score de la query 'legalname' est insuffisant. |
Sort
| Nom | Description |
|---|---|
| score | Pertinence |
| salesDesc | Chiffre d'affaire décroissant |
| salesAsc | Chiffre d'affaire croissant |
| salesGrowthDesc | Variation chiffre d'affaire décroissant |
| salesGrowthAsc | Variation chiffre d'affaire croissant |
| profitDesc | Bénéfice décroissant |
| profitAsc | Bénéfice croissant |
| profitGrowthDesc | Variation bénéfice décroissant |
| profitGrowthAsc | Variation bénéfice croissant |
| staffDesc | Effectifs décroissants |
| staffAsc | Effectifs croissants |
| staffGrowthDesc | Variation effectifs décroissant |
| staffGrowthAsc | Variation effectifs croissant |
| riskLevelDesc | Risque décroissant |
| riskLevelAsc | Risque croissant |
| creationDateDesc | Date de création décroissante |
| creationDateAsc | Date de création croissante |
| twitterFollowerDesc | Followers twitter décroissant |
| alexaRankAsc | Rank Alexa croissant |
| totalMarksDesc | Nombre de marques décroissant |
curl "https://societeinfo.com/app/rest/api/v2/companies.json?query=big%20data&contact_role_query=data%20scientist&withHighlight=true&key=DEMO
La commande retourne le JSON suivant :
{
"success": true,
"total": 17,
"currentPage": 1,
"totalPages": 2,
"searchMode": "keyword",
"sorts": [
"score"
],
"result": [
{
"id": "5d3cdf0ff0f016d9c1dde246",
"registration_number": "507661023",
"full_registration_number": "50766102300048",
"legal_type": "Siege",
"name": "INVENTIV IT",
"activity": "Conseil en informatique, technologies de l'information, audits, conseils, réalisations, formations. ",
"formatted_address": "75017 PARIS",
"lng": 2.3219,
"lat": 48.8835,
"highlights": [
{
"data_category": "Contact",
"data_source": "Linkedin",
"data_field": "Title",
"texts": [
"<em><b>Data</b></em> <em><b>scientist</b></em> / <em><b>data</b></em> engineer"
]
},
{
"data_category": "Company",
"data_source": "Website",
"texts": [
"Bigdata & <em><b>Data</b></em> Science",
"engineer, développeur <em><b>big</b></em> <em><b>data</b></em>, architecte vous avez une première expérience sur des projets <em><b>big</b></em> <em><b>data</b></em> vous interviendrez",
"<em><b>Data</b></em> Engineer, Développeur <em><b>Big</b></em> <em><b>Data</b></em>, Architecte"
]
}
]
}
...
]
}
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| total | Nombre de résultats | |
| currentPage | page courante | |
| totalPages | Nombre total de pages | |
| searchMode | Mode de recherche | Voir bloc 'Search Mode' |
| sorts | Mode de tri | Voir bloc 'Sort' |
| result.id | Identifiant technique | |
| result.registration_number | SIREN | |
| result.full_registration_number | SIRET | |
| result.legal_type | Type établissement | Siege, SecondaryEstablishment |
| result.name | Dénomination | |
| result.activity | Objet social | |
| result.formatted_address | Code postal et Ville | |
| result.lng | longitude | |
| result.lat | latitude | |
| result.highlights.data_category | Catégorie de donnée | Company, Contact |
| result.highlights.data_source | Source de donnée | Legal, Website, Twitter, Linkedin |
| result.highlights.data_field | Type de donnée | Name, Title, Content |
| result.highlights.texts | Extraits de texte avec mots clés |
Search Companies By Officiers
curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_first_name=antoine&contact_last_name=onnen&contact_birth_date=19770307&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":2,
"currentPage":1,
"totalPages":1,
"searchMode":"all",
"sorts":[
"score"
],
"result":[
{
"id":"593b6fa6b3a2feb79d4f9f39",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"legal_type":"Siege",
"name":"SMART DATA",
"activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
"formatted_address":"92200 NEUILLY-SUR-SEINE",
"lng":2.2593109,
"lat":48.8854852
},
{
"id":"5879740fb3a2806717e65fc1",
"registration_number":"803477181",
"full_registration_number":"80347718100017",
"legal_type":"Siege",
"name":"HEGOA",
"activity":"Développement informatique, conseil en systèmes et logiciels informatiques. ",
"formatted_address":"75018 PARIS",
"lng":2.3439171,
"lat":48.896718
}
]
}
curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_registration_number=538520487&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":2,
"currentPage":1,
"totalPages":1,
"searchMode":"all",
"sorts":[
"score"
],
"result":[
{
"id": "5879590ab3a28067176b87b9",
"registration_number": "332522341",
"full_registration_number": "33252234100095",
"legal_type": "Siege",
"name": "BOUCHERIES ANDRE",
"activity": "Commerce de détails de produits alimentaires. ",
"formatted_address": "69140 Rillieux-la-Pape",
"lng": 4.9,
"lat": 45.8167
},
...
]
}
Recherche toutes les entreprises dans lesquelles une personne physique/morale est mandataire
GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY
Paramètres pour une personne physique
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_first_name | Oui | Prénom du mandataire | |
| contact_last_name | Oui | Nom du mandataire | |
| contact_birth_date | Oui | Date de naissance du mandataire (format YYYYMMDD) |
Paramètres pour une personne morale (entreprise)
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_registration_number | Non | SIREN mandataire |
Paramètres optionnels
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_role_query | Oui | Filtre les rôle des mandataires. Exemple : gérant OR président OR directeur |
Contact API
Get Contacts By Company
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"company":{
"id":"593b6fa6b3a2feb79d4f9f39",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"legal_type":"Siege",
"name":"SMART DATA",
"activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
"formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 Neuilly-sur-Seine",
"ape_code":"4741Z"
},
"email_domains":[
{
"domain":"societeinfo.com",
"pattern":"{first}.{last}"
},
{
"domain":"societeinfo.com",
"pattern":"{first}"
}
],
"contacts":[
{
"id": "8301343831281918940",
"firstName": "Alexandre",
"lastName": "CONRAUD",
"role": "Directeur général",
"email": "alexandre.conraud@societeinfo.com",
"email_score": 0.93,
"email_test_result": "Safe to Send",
"email_test_reason": "Deliverable",
"email_test_date": "2020-07-09",
"hashcode": "911035480"
},
{
"id": "830134383621532388",
"firstName": "Antoine",
"lastName": "ONNEN",
"birth_date": "1977-03-07",
"role": "Président",
"email": "antoine.onnen@societeinfo.com",
"email_score": 0.93,
"email_test_result": "Safe to Send",
"email_test_reason": "Deliverable",
"email_test_date": "2020-07-09",
"hashcode": "947235740"
}
],
"contacts_count": 2,
"emails":[
{
"value":"antoine@societeinfo.com",
"type":"personal",
"sources":[
{
"url":"http://www.societeinfo.com/"
}
]
}
]
}
Ce service permet de récupérer les contacts d'une entreprise comporant un email ou un linkedin. Les contacts sont un mix des mandataires légaux, des profils des employés sur les réseaux sociaux et des emails corporate détectés sur le web.
Si uniquement des mandataires légaux sans linkedin ou email sont détectés, aucun résultat n'est renvoyé. En effet l'ensemble des mandataires sans linkedin/email est inclu pour 1 crédit dans le service Get Company
Identifiez l'entreprise avec le numéro SIREN
GET https://societeinfo.com/app/rest/api/v2/contacts.json/<registration_number>?key=YOUR_APIKEY
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| registration_number | Non | Numéro SIREN de l'entreprise |
Filtres sur les contacts
Les paramètres suivants vous permettent de limiter le nombre de contacts retournés par le service
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| withemail | Oui | Filtre les contacts avec email. Valeur possible : true | |
| email_test_status | all | Oui | Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe |
| withlinkedin | Oui | Filtre les contacts avec linkedin. Valeur possible : true | |
| withlegal | Oui | Filtre les contacts mandataires légaux. Valeur possible : true | |
| contact_role_query | Oui | Filtre les postes des contacts (voir ci-dessous) | |
| contact_max | Oui | Nombre de contacts max dans la réponse |
contact_role_query
Optionnel, Identifiez des familles de postes spécifiques en tapant des mots clés.
Par exemple "marketing" renverra tous les postes intégrant le mot "marketing" comme "Responsable marketing" ou "Directeur marketing".
Pour filtrer tous les postes de responsables/dirigeant, utilisez l'expression suivante : dirigeant OR directeur OR responsable OR CEO OR gérant OR président
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| email_domains.domain | Domain mail corporate | |
| email_domains.pattern | Pattern mail corporate | |
| contacts.id | Identifiant du contact | |
| contacts.firstName | Prénom | |
| contacts.lastName | Nom | |
| contacts.role | Mandat ET/OU Rôle linkedin | |
| contacts.email | ||
| 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.linkedin_url | Url profil linkedin | |
| contacts.extraction_date | Date extraction linkedin | |
| contacts.hashcode | Hash sur la donnée de contact | |
| emails.value | Email détecté | |
| emails.type | Type email | generic, personal |
| emails.sources | Sources email |
curl "https://societeinfo.com/app/rest/api/v2/contacts.json?name=tilkee&contact_role_query=marketing%20OR%20founder&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"company":{
"id":"58797115b3a2806717d8e0a7",
"registration_number":"789120649",
"full_registration_number":"78912064900031",
"legal_type":"Siege",
"name":"TILKEE",
"activity":"Edition de logiciel.",
"formatted_address":"13 RUE BURDEAU 69001 Lyon"
},
"email_patterns":[
{
"domain": "tilkee.com",
"pattern": "{first}"
},
{
"domain": "tilkee.fr",
"pattern": "{first}.{last}"
},
{
"domain": "tilkee.fr",
"pattern": "{first}"
}
],
"contacts":[
{
"id": "789120649718434360",
"firstName": "Tim",
"lastName": "SAUMET",
"role": "Cto & co-founder",
"email": "tim@tilkee.com",
"email_score": 0.7,
"email_test_result": "Risky",
"email_test_reason": "Accept All",
"email_test_date": "2020-04-09",
"linkedin_url": "https://www.linkedin.com/in/timsaumet/",
"extraction_date": "2019-10-01",
"hashcode": "159027033"
},
{
"id": "789120649307274538",
"firstName": "Baptiste",
"lastName": "RENAULT",
"role": "Operational marketing manager | Business developer",
"email": "baptiste@tilkee.com",
"email_score": 0.7,
"email_test_result": "Risky",
"email_test_reason": "Accept All",
"email_test_date": "2020-04-09",
"linkedin_url": "https://www.linkedin.com/in/baptisterenault/",
"extraction_date": "2020-04-14",
"hashcode": "1245895813"
},
{
"id": "7891206491626992254",
"firstName": "Sylvain",
"lastName": "TILLON",
"role": "Chief marketing officer | Webmaster",
"email": "sylvain@tilkee.com",
"email_score": 0.7,
"email_test_result": "Risky",
"email_test_reason": "Accept All",
"email_test_date": "2020-04-09",
"linkedin_url": "https://www.linkedin.com/in/sylvaintillon/",
"extraction_date": "2020-04-14",
"hashcode": "561415271"
},
...
],
"contacts_count": 5,
"emails":[
{
"value": "sylvain@tilkee.com",
"type": "personal",
"sources": [
{
"url": "http://audentia-gestion.fr/bpifrance/Bpifrance_Dossier%20de%20presse%20ubi%20i-o%202016_09-03-2016.pdf"
}
]
}
...
]
}
Identifiez l'entreprise sans le numéro SIREN
Ces paramètres vous permetttent de chercher les contacts d'une entreprise sans disposer du numéro SIREN.
Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !
GET https://societeinfo.com/app/rest/api/v2/contacts.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| name | Oui | Nom de l'entreprise | |
| street | Oui | Rue et voie OU voie | |
| street2 | Oui | Complément d'adresse | |
| postal_code | Oui | Code postal | |
| city | Oui | Ville | |
| domain_name | Oui | Nom de domaine OU url du site web | |
| Oui | adresse email | ||
| min_match_score | 0 | Oui | Ne retourne un résultat que si le score de matching match_info.score est supérieur au score minimum spécifié. Double entre 0.0 et 1.0 |
- 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 |
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?show_all_anonymized=true&key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"contacts": [
{
"id": "8301343831281918940",
"firstName": "Xxxxx",
"lastName": "XXXXXXXX",
"birth_date": "YYYY-MM-dd",
"role": "Président",
"email": "xxxxxxx@xxxx.xxx",
"email_score": 0.95,
"email_test_result": "Safe to Send",
"email_test_reason": "Deliverable",
"email_test_date": "2020-07-09",
"anonymized": true,
"hashcode": "911035480"
},
{
"id": "830134383621532388",
"firstName": "Xxxxx",
"lastName": "XXXXXXXX",
"role": "Directeur général",
"email": "xxxxxxx@xxxx.xxx",
"email_score": 0.95,
"email_test_result": "Safe to Send",
"email_test_reason": "Deliverable",
"email_test_date": "2020-07-09",
"anonymized": true,
"hashcode": "947235740"
}
],
"contacts_count": 2
}
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?contact_ids=830134383621532388&key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"contacts": [
{
"id": "830134383621532388",
"firstName": "Antoine",
"lastName": "ONNEN",
"birth_date": "1977-03-07",
"role": "Président",
"email": "antoine.onnen@societeinfo.com",
"email_score": 0.92,
"email_test_result": "Safe to Send",
"email_test_reason": "Deliverable",
"email_test_date": "2020-07-09",
"hashcode": "947235740"
}
],
"contacts_count": 1
}
Visualisez et sélectionnez les rôles que vous souhaitez
Pour sélectionner unitairement les contacts à retourner, spécifiez le paramètre 'show_all_anonymized'. 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' (voir exemple)
Interrogez ensuite ce même service avec le paramètre 'contact_ids' pour obtenir le détail des contacts désirés.
Si vous souhaitez vérifier la fraicheur de vos données de contacts, utilisez 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_role_query=data%20scientist&email_type=personal&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":1203,
"currentPage":1,
"totalPages":121,
"searchMode":"keyword",
"sorts":[
"score"
],
"result":[
{
"id":"587964c5b3a2806717a2dd45",
"registration_number":"469500961",
"full_registration_number":"46950096100831",
"legal_type":"Siege",
"name":"ArcelorMittal Distribution Solutions France",
"activity":"la branche du fonds de commerce ayant pour activité l'achat, la préparation, la transformation, le conditionnement, le transport et la vente de plaque d'acier",
"formatted_address":"51370 Saint-Brice-Courcelles",
"lng":3.9833,
"lat":49.2667
},
{
"id":"58796634b3a2806717a93453",
"registration_number":"484893110",
"full_registration_number":"48489311000052",
"legal_type":"Siege",
"name":"INFOLOGIK",
"activity":"Conseil en systèmes et logiciels informatiques",
"formatted_address":"56100 Lorient",
"lng":-3.3667,
"lat":47.75
},
{
"id":"587966a6b3a2806717ab2781",
"registration_number":"489139436",
"full_registration_number":"48913943601383",
"legal_type":"Siege",
"name":"BCA EXPERTISE SAS",
"activity":"Évaluation des risques et dommages",
"formatted_address":"92600 Asnières-sur-Seine",
"lng":2.2833,
"lat":48.9167
},
...
]
}
Ce service permet de rechercher les sociétés contenant des contacts.
Les données d'entreprise renvoyées sont dans un format synthétique (SIREN, nom, activité, adresse formattée, géolocation). Requêtez ensuite par SIREN le service Get Contacts By Company pour obtenir les contacts de chaque société
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY
Company Parameters
Les critères société (forme juridique, chiffre d'affaire...) sont définis dans le service Search Companies
Contact Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_role_query | Oui | Filtre les postes des contacts (voir ci-dessus) | |
| contact_source | Oui | Filtre l'origine des contacts. Les valeurs possibles sont legal,linkedin. Exemple contact_source=legal&contact_source=linkedin | |
| email_type | Oui | Filtre les sociétés avec le/les types d'emails souhaités. Voir tableau email_type ci-dessous. Exemple : email_type=personal&email_type=withoutwebmail | |
| email_test_status | all | Oui | Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe |
Email Type
Le paramètre email_type permet de spécifier les types d'emails de la société
| Nom | Description |
|---|---|
| generic | Avec emails génériques |
| personal | Avec emails directs |
| withwebmail | Avec webmails |
| withoutwebmail | Sans webmails |
Enrich contact
curl "https://societeinfo.com/app/rest/api/v2/contacts.json?name=tilkee&first_name=sylvain&last_name=tillon&key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"company": {
"id": "58797115b3a2806717d8e0a7",
"registration_number": "789120649",
"full_registration_number": "78912064900049",
"legal_type": "Siege",
"name": "TILKEE",
"activity": "Edition de logiciel.",
"formatted_address": "22 RUE CONSTANTINE 69001 LYON",
"ape_code": "5829C"
},
"contacts": [
{
"firstName": "Sylvain",
"lastName": "TILLON",
"role": "Directeur général | Cofounder and ceo | Cofondateur",
"email": "sylvain@tilkee.com",
"email_score": 0.14,
"email_test_result": "Risky",
"email_test_reason": "Accept All",
"email_test_date": "2019-12-18",
"linkedin_url": "https://www.linkedin.com/in/sylvaintillon/",
"extraction_date": "2019-10-01"
}
],
"contacts_count": 1
}
Ce service vous permet d'enrichir un contact depuis son nom/prénom pour obtenir son email et/ou linkedin
Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/contacts.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| last_name | Non | Nom d'un mandataire/employé | |
| first_name | Oui | Prénom d'un mandataire/employé |
- Et paramètres optionnels d'identification d'entreprise
- Et paramètres optionnels de filtres sur les contacts
Financial API
Get Financial
curl "https://societeinfo.com/app/rest/api/v2/financial/statements.json/342376332?key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"groups":[
{
"metadata":{
"label":"Bilan Comptable consolidé",
"statement":"BILAN",
"detail_level":"Synthetic",
"type":"Consolide",
"currency_code":"EUR",
"rows":[
{
"code":"IMMOS_INCORP",
"label":"Immobilisations incorporelles",
"total":true
},
{
"code":"IMMOS_CORP",
"label":"Immobilisations corporelles",
"total":true
},
...
]
},
"dates":[
{
"closing_date":"2016-12-31",
"duration_in_month":12,
"rows":[
{
"code":"IMMOS_INCORP",
"value":31393000
},
{
"code":"IMMOS_CORP",
"value":101051000
},
...
]
},
...
]
},
{
"metadata":{
"label":"Bilan Comptable social",
"statement":"BILAN",
"detail_level":"Synthetic",
"type":"Complet",
"currency_code":"EUR",
"rows":[
{
"code":"IMMOS_INCORP",
"label":"Immobilisations incorporelles",
"total":true
},
{
"code":"IMMOS_CORP",
"label":"Immobilisations corporelles",
"total":true
},
...
]
},
"dates":[
{
"closing_date":"2016-12-31",
"duration_in_month":12,
"rows":[
{
"code":"IMMOS_INCORP",
"value":3904044
},
{
"code":"IMMOS_CORP",
"value":26126233
},
...
]
},
...
]
},
{
"metadata":{
"label":"Compte de résultat consolidé",
"statement":"PNL",
"detail_level":"Synthetic",
"type":"Consolide",
"currency_code":"EUR",
"rows":[
{
"code":"CA_NET_EXPORT",
"label":"Dont C.A. réalisé à l'export",
"total":false
},
{
"code":"CA_NET_TOTAL",
"label":"Chiffres d’affaires nets Total",
"total":true
},
...
]
},
"dates":[
{
"closing_date":"2016-12-31",
"duration_in_month":12,
"rows":[
{
"code":"AUTRES_PRODUITS_EXP",
"value":4732000
},
{
"code":"TOTAL_SALAIRES_CHARGES_EXT",
"value":174900000
},
...
]
},
...
]
},
...
]
}
Ce service permet de récupérer les données des liasses fiscales déposées au greffe par les entreprises françaises. L’API renvoie les états financiers de tous les exercices disponibles.
Seuls les sociétés déposant leurs comptes au greffe et n’ayant pas opté pour l’option de confidentialité sont disponibles.
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/financial/statements.json/<registration_number>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Défaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| registration_number | Non | Numéro SIREN de l'entreprise | |
| detailLevel | Synthetic | Oui | Niveau de détail (voir ci-dessous) |
| statement | Oui | Filtre l'etat financier retourné (voir ci-dessous) | |
| type | Auto | Oui | Type de comptes (voir ci-dessous) |
detailLevel
| Nom | Description |
|---|---|
| Synthetic | Renvoie les principaux agrégats comptables |
| Full | Renvoie toutes les lignes disponibles dans la liasse fiscale |
statement
Les états financiers sont composés d’un bilan comptable et d’un compte de résultat. Par défaut l’API renvoie les deux. Ajoutez ce paramètre pour limiter au bilan comptable / compte de résultat
| Nom | Description |
|---|---|
| BILAN | Limite au bilan comptable |
| PNL | Limite au compte de résultat |
type
Les comptes publiés par les entreprises françaises peuvent avoir différents formats :
Consolidés : Comptes consolidés de la société correspondant au SIREN demandé. Ces comptes ne sont disponibles que pour les sociétés étant des têtes de groupes et publiant leurs comptes.
Complets : Comptes sociaux détaillés. Ces comptes correspondent aux comptes sociaux des sociétés remplissant au minimum 2 des 3 critères suivants : Total bilan supérieur à 3 650 000 euros et/ou Total chiffre d’affaires supérieur à 7 300 000 euros et/ou Nombre de salariés supérieur à 50.
Simplifiés : Comptes sociaux simplifiés. Les sociétés ont la possibilité de publier des comptes simplifiés lorsqu’elles remplissent au minimum 2 des 3 critères suivants : Total bilan inférieur ou égal à 1 000 000 euros et/ou Total chiffre d’affaires supérieur à 2 000 000 euros et/ou Nombre de salariés inférieur ou égal à 20.
Banque : Comptes simplifiés de banque. L’INPI ne divulgue que des comptes simplifiés pour les établissements bancaires.
Assurance : Comptes simplifiés d’assurance. L’INPI ne divulgue que des comptes simplifiés pour les sociétés d’assurance.
Ajoutez l'un des paramètres suivant pour sélectionner le/les types de comptes :
| Nom | Description |
|---|---|
| Auto | Renvoie les comptes consolidés si disponibles, si ce n’est pas le cas renvoie les comptes sociaux (Complets, Simplifiés, Banque ou Assurance) |
| Social | Renvoie les comptes sociaux (Complets, Simplifiés, Banque ou Assurance) même si les comptes consolidés sont disponibles |
| All | Renvoie tous les comptes disponibles. Exemple : Consolidés + Complets / Simplifiés |
Extra API
Get Bodacc
curl "https://societeinfo.com/app/rest/api/v2/bodacc.json/342376332?key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"result": [{
"type": "Bodacc",
"bodacc_type": "Modifications et mutations diverses",
"parution_date": "2008-07-08",
"number": "1716",
"rcs_name": "342376332 RCS paris",
"legal_name": "ILIAD",
"legal_status": "Société anonyme",
"capital": "12000000 EUR",
"administration": "modification de l'Administrateur Rozenfeld, Olivier",
"address": "8 rue de la Ville L'Évêque 75008 Paris",
"description": "modification survenue sur l'administration"
},
...
]
}
Ce service retourne l'ensemble des annonces légales du BODACC à partir d'un code SIREN
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/bodacc.json/<registration_number>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| registration_number | Non | Numéro SIREN de l'entreprise |
Autocomplete Place
curl "https://societeinfo.com/app/rest/api/v2/places.json/autocomplete?query=paris&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"errorType":null,
"errorCode":null,
"errorMessage":null,
"total":5,
"page":0,
"views":[
{
"id":"587953dcb3a2b0645005d4de",
"first":"Paris",
"others":"Île-de-France, FRANCE",
"type":"administrative_area_level_2",
"sourceStatus":"Complete",
"formatedName":"Paris, Île-de-France, FRANCE"
},
{
"id":"587953d6b3a2b06450055d59",
"first":"Paris",
"others":"Paris, Île-de-France, FRANCE",
"type":"locality",
"sourceStatus":"Complete",
"formatedName":"Paris, Paris, Île-de-France, FRANCE"
},
...
]
}
Le service Place Autocomplete retourne des prédictions de lieu. La requête spécifie une chaîne de recherche. Le service permet de fournir la fonctionnalité de saisie semi-automatique pour les recherches géographiques textuelles et renvoie des adresses au fur et à mesure de la saisie par l'utilisateur (région, département, code postal, ville, rue)
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/places.json/autocomplete?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| query | Non | Caractères spécifiés pour la recherche |
Errors
L'API utilise les codes standard HTTP suivants :
| Error Code | Description |
|---|---|
| 400 | Bad Request -- Requête invalide. |
| 401 | Unauthorized -- Clé API invalide. |
| 403 | Forbidden -- Accès non autorisé. |
| 404 | Not Found -- Entité non trouvé. |
| 429 | Too Many Requests -- Vous requêtez trop vite ! Ralentissez ! |
| 500 | Internal Server Error -- Nous avons un problème interne, Ré-exécuter plus tard. |
{
"success": false,
"errorType": "Functionnal",
"errorCode": "API_INVALID_KEY",
"errorMessage": "The api key is not found"
}
Les réponses en erreur inclue également un champs errorCode avec un niveau de détail plus fin. En voici quelques exemples :
| Error Code | Description |
|---|---|
| API_COMPANY_NOT_FOUND | La société n'a pas été trouvée. |
| API_COMPANY_ANONYMIZED | Le propriétaire de la société a demandé son anonymisation |
| API_COMPANY_QUERY_MIN_LENGTH | La taille de la query doit être supérieure à deux |
| API_CONTACT_UNAUTHORIZED | L'accès à l'API est limité aux comptes payants |
| API_INVALID_KEY | La clé d'API est invalide. |
| API_UNDEFINED_KEY | La clé d'API n'est pas renseignée |
| API_MAX_MATCH_EXCEEDED | Les crédits de la clé d'API sont épuisés. |
| API_INVALID_PAGE | La page demandée n'existe pas. |
| USER_COMPANY_EXPIRED | Le compte est expiré, la carte de crédit a été refusée |