Introduction
Bienvenue sur societeinfo.com. Première plate-forme d'agrégation de données d'entreprises.
Vous avez accès avec notre API aux informations légales, financières, ainsi que toutes les données de contact détectées sur le web par nos algos (mails, sites web, réseaux sociaux...).
Notre data légale est rafraichie quotidiennement depuis les répertoires SIRENE, INPI et BODACC.
Utilisation
Authentification
Pour accéder au service vous devez obtenir une clé d'API. Enregistrez vous. Une fois enregistré, récupérez ou générez vos clés dans votre dashboard personnel.
Vous pouvez ajouter le header X-API-KEY à vos requêtes (recommandé)
GET https://something
X-API-KEY:YOUR_APIKEY
Ou plus simplement ajouter le paramètre key à vos requêtes
GET https://something?key=YOUR_APIKEY
Crédits
curl "https://societeinfo.com/app/rest/api/v2/apikeyinfo.json?key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"result": {
"companyName": "SMART DATA",
"productName": "Business",
"consumedCredits": 12457,
"maxCredits": 50000,
"extraCredits": 50000,
"consumedExtraCredits": 0,
"totalAvailableCredits": 87543
}
}
Chaque requête réussie consomme un ou plusieurs crédits. Le service suivant indique votre solde de crédits
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/apikeyinfo.json?key=YOUR_APIKEY
Query Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. |
Format
Les réponses peuvent être générées au format JSON ou au format XML
Dans toutes vos requêtes API, spécifiez dans l'url le format attendu : json ou xml
Company API
Get Company
curl "https://societeinfo.com/app/rest/api/v2/company.json/702012931?key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"result":{
"id":"58796f69b3a2806717d13c40",
"organization":{
"status":"Active",
"risk":{
"risk_level":0,
"risk_level_description":"Pas de risque identifié",
"collective_procedure_in_progress":false,
"collective_procedures":[
],
"legal_source_organization_statuses":[
{
"source_name":"Bodacc",
"organization_status":"Active"
}
]
},
"creation_date":"1970-01-01",
"capital":"100000",
"registration_number":"702012931",
"full_registration_number":"70201293100011",
"vat_number":"FR25702012931",
"greffe_name":"Paris",
"name":"SOC EXPLOITATION SPECTACLES BATACLAN",
"business_name": "CLASSIC ART MANAGEMENT",
"activity":{
"ape_code":"9001Z",
"ape_code_level1":"RU",
"ape_code_level2":"RZ",
"ape_code_level3":"90",
"ape_code_level4":"R90Z",
"ape_code_level5":"9001Z",
"ape_name":"Arts du spectacle vivant",
"corporate_object": "LOCATION DE SALLES - ENTREPRENEUR DE SPECTACLES"
},
"legal":{
"name": "SASU Société par actions simplifiée à associé unique",
"code_level1": "5",
"code_level2": "57",
"code_level3": "5720",
"person_type": "LegalEntity",
"type": "Siege"
},
"convention_collective": {
"code": "3090",
"name": "Convention collective nationale des entreprises du secteur privé du spectacle vivant"
},
"address":{
"street":"50 BOULEVARD VOLTAIRE",
"postal_code":"75011",
"city":"PARIS",
"country_code":"FR",
"country":"FRANCE",
"lng":2.3795,
"lat":48.8574
},
"insee_category": {
"code": "TPE",
"name": "Très petite entreprise",
},
"beneficiaires_effectifs": [
{
"firstName": "PHILIP",
"lastName": "ANSCHUTZ",
"birth_date": "1939-12",
"pourcentage_parts": 43.6,
"details_parts_indirectes": {
"details_en_personne_morale": {
"pourcentage_pleine_propriete": 43.6
}
},
"details_votes_indirects": {
"details_en_personne_morale": {
"pourcentage_pleine_propriete": 43.6
}
}
}
],
"last_legal_update_date":"2022-08-29",
"establishments_count":9
},
"contacts":{
"main_corporate_officier":{
"lastName":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
"name":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
"role":"Président",
"role_start_date":"2021-11-19",
"role_end_date":"",
"company":true,
"registration_number":"326433117"
},
"corporate_officiers":[
{
"lastName":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
"name":"SOCIETE ANONYME D'EXPLOITATION DU PALAIS OMNISPORTS DE PARIS-BERCY",
"role":"Président",
"role_start_date":"2021-11-19",
"role_end_date":"",
"company":true,
"registration_number":"326433117"
},
{
"lastName": "DELOITTE & ASSOCIES",
"name": "DELOITTE & ASSOCIES",
"role": "Commissaire aux comptes titulaire",
"role_start_date": "2023-11-21",
"role_end_date": "",
"company": true,
"registration_number": "572028041"
}
],
"email":"contact@bataclan.fr",
"emails":[
{
"value":"contact@bataclan.fr",
"type":"generic",
"email_test_result": "Risky",
"email_test_reason": "Accept All",
"email_test_date": "2023-09-16",
"email_webmail": false
}
]
},
"web_infos":{
"logo_url":"https://pbs.twimg.com/profile_images/1173587700257046528/r069sLPZ_400x400.jpg",
"website_url":"http://www.bataclan.fr/",
"websites":[
{
"domain":"bataclan.fr",
"url":"http://www.bataclan.fr/",
"description": "Site officiel du Bataclan : Salle de concerts et de spectacles parisienne affranchie des genres, âges et époques! Là où passion, impertinence et énergie s'agitent librement depuis 1865. sition. ",
"webmaster_email": "gestion.ndd@lagardere-le.com",
"webmaster_phone":"01 40 69 17 91",
"techno_types":[
"facebook-pixel",
"popper",
"wordpress",
"apache-http-server",
"smash-balloon-instagram-feed",
"bootstrap",
"owl-carousel",
"amazon-web-services",
"contact-form-7",
"jquery",
"core-js",
"yoast-seo",
"google-analytics",
"amazon-ses",
"scrollmagic",
"recaptcha",
"mysql",
"google-tag-manager",
"azure",
"docusign",
"microsoft-365",
"gsap",
"tiktok-pixel",
"jquery-migrate",
"twitter-emoji-twemoji",
"fancybox",
"videojs",
"php",
"open-graph"
],
"metadata":{
"owner_registration_number":"702012931",
"website_crawl_date":"2020-08-23",
"domain_creation_date":"2000-04-19"
}
}
],
"linkedin":{
"url": "https://www.linkedin.com/company/le-bataclan/",
"id": "le-bataclan",
"tech_id": "25915726",
"name": "LE BATACLAN",
"description": "Bataclan has always been atypical amongst Parisian venues. It has been the first “café-concert” free of its artistic choices since its beginnings. For 150 years, the venue reflects the Parisian culture and way of life. Rock, French music, rap, electro and world music… the Bataclan still a crucial step for many artists careers. ",
"follower_count": 4587,
"employees_range": "2-10",
"employees_count": 31,
"crawl_date": "2023-10-15"
},
"twitter":{
"url":"https://twitter.com/@bataclan_"
},
"facebook":{
"url":"https://www.facebook.com/bataclanFR/"
},
"wikipedia":{
}
"youtube": {
},
"instagram": {
"url": "https://www.instagram.com/bataclanofficiel/"
}
},
"financials":{
"last_sales": 1752459,
"last_profit": 49868,
"last_staff": 6,
"years":[
{
"year":"2023",
"staff":6,
"staff_metadata":{
"estimated":true
}
},
{
"year":"2022",
"sales": 1752459,
"profit": 49868,
"staff":23,
"closing_date": "2022-08-31",
"sales_metadata":{
"estimated":false
},
"profit_metadata":{
"estimated":false
},
"staff_metadata":{
"estimated":true
}
},
{
"year":"2021",
"sales":1005656,
"profit":-446592,
"staff":6,
"closing_date":"2021-12-31",
"sales_metadata":{
"estimated":false
},
"profit_metadata":{
"estimated":false
},
"staff_metadata":{
"estimated":false
}
},
{
"year":"2020",
"sales":460718,
"profit":-694735,
"staff":6,
"closing_date":"2020-12-31",
"sales_metadata":{
"estimated":false
},
"profit_metadata":{
"estimated":false
},
"staff_metadata":{
"estimated":false
}
},
...
],
"last_staff_sources":[
{
"source":"RncsBILANS",
"value":6,
"date":"2021-01-01",
"estimated":false
},
{
"source":"Infogreffe",
"value":6,
"date":"2020-01-01",
"estimated":false
},
{
"source":"Sirene",
"range_value":"6-9",
"date":"2017-01-01",
"estimated":true
},
{
"source":"Linkedin",
"field":"employees_range",
"range_value": "2-10",
"date": "2023-10-15",
"estimated": false
},
{
"source":"Linkedin",
"field": "employees_count",
"value": 31,
"date": "2023-10-15",
"estimated": false
}
]
},
"mark_infos":{
},
"last_bodacc":{
"type": "Bodacc",
"bodacc_type": "Modifications et mutations diverses",
"parution_date": "2023-11-26",
"number": "2069",
"rcs_name": "702012931 RCS Paris",
"legal_name": "SOCIETE D'EXPLOITATION DES SPECTACLES BATACLAN",
"legal_status": "Société par actions simplifiée (à associé unique)",
"capital": "100000.00 EUR",
"administration": "nomination du Commissaire aux comptes : DELOITTE & ASSOCIES",
"address": "50 boulevard Voltaire 75011 Paris",
"description": "modification survenue sur l'administration"
},
"actes":[
{
"date":"2022-07-22",
"type":"Décision(s) de l'associé unique",
"description":"Changement relatif à la date de clôture de l'exercice social"
},
{
"date":"2022-07-22",
"type":"Décision(s) de l'associé unique",
"description":"Modification(s) statutaire(s)"
},
{
"date":"2022-07-22",
"type":"Statuts mis à jour"
},
...
]
}
}
Exemple de risk
{
...
"risk": {
"risk_level": 4,
"risk_level_description": "Société clôturée",
"collective_procedure_in_progress": true,
"collective_procedures": [
{
"collective_procedure_type": "Procédure de sauvegarde",
"collective_procedure_startdate": "2019-10-02",
"collective_procedure_enddate": "2019-11-12",
"collective_procedure_status": "Closed"
},
{
"collective_procedure_type": "Redressement Judiciaire",
"collective_procedure_startdate": "2019-11-13",
"collective_procedure_enddate": "2019-12-11",
"collective_procedure_status": "Closed"
},
{
"collective_procedure_type": "Liquidation Judiciaire",
"collective_procedure_startdate": "2019-12-12",
"collective_procedure_enddate": "",
"collective_procedure_status": "Open"
}
],
"legal_source_organization_statuses": [
{
"source_name": "Bodacc",
"organization_status": "Dead",
"organization_status_date": "2019-12-12"
}
]
},
...
}
Ce service retourne les informations détaillées d'une entreprise (données légales, chiffres clés, dirigeants, mails génériques, sites web, réseaux sociaux, marques...) à partir d'un code SIREN ou d'un code SIRET
Une sandbox avec un exemple en jquery est disponible sur github ici
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/company.json/<registration_number>?key=YOUR_APIKEY
GET https://societeinfo.com/app/rest/api/v2/company.json/<id>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| registration_number | Non | Numéro SIREN ou SIRET de l'entreprise | |
| id | Oui | Identifiant societeinfo de l'entreprise | |
| withEstablishments | false | Oui | Inclue les établissements du siège. Les valeurs possibles sont true ou false |
| withGoogleMyBusiness | false | Oui | Inclue les informations de Google My Business dans le champ web_infos. Les valeurs possibles sont true ou false |
| withContactApiCount | false | Oui | Comptabilise les contacts disponibles sur l'API contact. Les valeurs possibles sont true ou false |
| withKeywords | false | Oui | Inclue les mots clés de la société. Les valeurs possibles sont true ou false |
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| organization.status | Statut | Active, Sleeping, Dead |
| organization.name | Dénomination | |
| organization.commercial_name | Nom commercial | |
| organization.business_name | Nom enseigne | |
| organization.acronym_name | Sigle | |
| organization.legal.type | Type établissement | Siege, SecondaryEstablishment |
| organization.legal.person_type | Personnalité légale | LegalEntity, Individual |
| organization.registration_number | N° SIREN | |
| organization.full_registration_number | N° SIRET | |
| organization.vat_number | N° TVA UE | |
| organization.legal.name | Forme juridique | |
| organization.legal.code_level1 | Forme juridique code Niv.1 | Forme juridique code Niv.1 |
| organization.legal.code_level2 | Forme juridique code Niv.2 | Forme juridique code Niv.2 |
| organization.legal.code_level3 | Forme juridique code Niv.3 | Forme juridique code Niv.3 |
| organization.convention_collective.code | Code de la convention collective | Code de la convention collective |
| organization.convention_collective.name | Nom de la convention collective | Nom de la convention collective |
| organization.address.street | Adresse | |
| organization.address.postal_code | Code postal | |
| organization.address.city | Ville | |
| organization.insee_category.code | Code de la catégorie INSEE | TPE, PE, ME, ETI, GE, NON_DEFINIE |
| organization.insee_category.name | libellé de la catégorie INSEE | |
| organization.beneficiaires_effectifs | Liste des bénéficiaires effectifs | |
| organization.beneficiaires_effectifs.firstName | Prénom | |
| organization.beneficiaires_effectifs.firstName | Nom | |
| organization.beneficiaires_effectifs.birth_date | Date de naissance | |
| organization.beneficiaires_effectifs.pourcentage_parts | Pourcentage de parts | |
| organization.beneficiaires_effectifs.details_parts_indirectes | Détails des parts indirectes | |
| organization.beneficiaires_effectifs.details_votes_indirects | Détails des votes indirectes | |
| organization.capital | Capital social (en €) | |
| organization.address.postal_address_additional_name | Complément nom (adressage) | |
| organization.creation_date | Date de création | |
| organization.closing_date | Date de radiation | |
| organization.last_legal_update_date | Dernière mise à jour légale | |
| organization.greffe_name | Greffe | |
| organization.establishments_count | Nombre d'établissements secondaires | |
| organization.establishments | Etablissements secondaires (param withEstablishments) | Modèle |
| organization.contacts.main_corporate_officier | Dirigeant principal | |
| organization.contacts.main_corporate_officier.firstName | Prénom | |
| organization.contacts.main_corporate_officier.lastName | Nom | |
| organization.contacts.main_corporate_officier.name | Prénom Nom ou Dénomination | |
| organization.contacts.main_corporate_officier.birth_date | Date de naissance | |
| organization.contacts.main_corporate_officier.role | Mandat | |
| organization.contacts.main_corporate_officier.role_start_date | Date de début de mandat | |
| organization.contacts.main_corporate_officier.company | Personne morale ou Personne physique | true, false |
| organization.contacts.corporate_officiers | Liste des mandataires | |
| organization.activity.corporate_object | Objet social | |
| organization.activity.ape_code | Code APE | Code NAF Niv.5 |
| organization.activity.ape_code_level1 | Code NAF Niv.1 | Code NAF Niv.1 |
| organization.activity.ape_code_level2 | Code NAF Niv.2 | Code NAF Niv.2 |
| organization.activity.ape_code_level3 | Code NAF Niv.3 | Code NAF Niv.3 |
| organization.activity.ape_code_level4 | Code NAF Niv.4 | Code NAF Niv.4 |
| organization.activity.ape_code_level5 | Code NAF Niv.5 | Code NAF Niv.5 |
| organization.web_infos.website_url | Url du site web principal | |
| organization.web_infos.websites | Site webs | |
| organization.web_infos.websites.domain | Domaine du site web | |
| organization.web_infos.websites.url | Url du site web | |
| organization.web_infos.websites.description | Description du site web | |
| organization.web_infos.websites.techno_types | Technologies présentes sur le site web principal | Référentiel des technologies web |
| organization.web_infos.websites.metadata | SIREN de l'entreprise principale / Dates de crawling | |
| organization.web_infos.linkedin.url | Url Linkedin | |
| organization.web_infos.linkedin.id | ID Linkedin | |
| organization.web_infos.linkedin.tech_id | ID tech Linkedin | |
| organization.web_infos.linkedin.name | Nom Linkedin | |
| organization.web_infos.linkedin.description | Descirption Linkedin | |
| organization.web_infos.linkedin.follower_count | Followers Linkedin | |
| organization.web_infos.linkedin.employees_range | Tranche déclarée d'employés | |
| organization.web_infos.linkedin.employees_count | Nombre d'employés attachés au compte linkedin | |
| organization.web_infos.linkedin.crawl_date | Date de crawling | |
| organization.web_infos.twitter.url | Url Twitter | |
| organization.web_infos.facebook.url | Url Facebook | |
| organization.web_infos.wikipedia.url | Url Wikipedia | |
| organization.web_infos.keywords | Mots et poids des termes clés de la société | |
| financials.last_sales | Dernier chiffre d'affaire | |
| financials.last_profit | Dernier résultat net | |
| financials.last_staff | Dernier effectif | |
| financials.years.[financial type] | Chiffre de l'année X | |
| financials.years.[financial type]_metadata.estimated | Chiffre estimé ? | true, false |
| financials.last_staff_sources.source | source d'effectif | |
| financials.last_staff_sources.range_value/value | valeur de la source d'effectif | |
| financials.last_staff_sources.date | date de la source d'effectif | |
| financials.last_staff_sources.estimated | Chiffre estimé ? | true, false |
| contacts.phones | Téléphones | |
| contacts.email | Email générique principal | |
| contacts.emails | Emails génériques | |
| contacts.corporate_officiers | Mandataires légaux | |
| contacts.contact_api_count | Nombre de contacts disponibles dans l'API contact |
sales_metadata
Modèle de risque
| Champs | Description | Valeurs possibles |
|---|---|---|
| organization.risk.risk_level | Niveau de risque du siège | 0-4 (voir tableau ci dessous) |
| organization.risk.risk_level_description | Description | |
| organization.risk.collective_procedure_in_progress | Procédure collective en cours | true, false |
| organization.risk.legal_source_organization_statuses.source_name | Fournisseur de data | RCS, INSEE, Bodacc |
| organization.risk.legal_source_organization_statuses.organization_status | Statut | Active, Sleeping, Dead |
| organization.risk.legal_source_organization_statuses.organization_status_date | Statut | Date de fermeture |
| organization.risk.collective_procedures.collective_procedure_type | Type de procédure collectives | |
| organization.risk.collective_procedures.collective_procedure_startdate | Date d'ouverture | |
| organization.risk.collective_procedures.collective_procedure_startmessage | Libellé jugement | |
| organization.risk.collective_procedures.collective_procedure_enddate | Date de clôture | |
| organization.risk.collective_procedures.collective_procedure_endmessage | Libellé jugement | |
| organization.risk.collective_procedures.collective_procedure_status | Etat | Open, Closed |
Calcul de risque
| Valeur | Description |
|---|---|
| 0 | Société active ET pas de procédures collectives ou aucune procédure collective (sauf liquidation) clôturée depuis plus de 5 ans |
| 1 | Société active ET une procédure collective clôturée (sauf liquidation) depuis moins de 5 ans |
| 2 | Société active ET Au moins une procédure collective en cours (quelque soit son type) |
| 3 | Un indicateur de radiation OU (Société active ET procédure collective de liquidation clôturée) |
| 4 | Société clôturée OU (un indicateur de radiation ET une procédure collective de liquidation terminée) |
Enrich Company
curl "https://societeinfo.com/app/rest/api/v2/company.json?name=smart%20data&postal_code=92200&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"match_info":{
"score":0.59,
"sources":"Nom Adresse"
},
"result":{
"id":"593b6fa6b3a2feb79d4f9f39",
"organization":{
"status":"Active",
"risk":{
"risk_level":0,
"risk_level_description":"Pas de risque identifié",
"collective_procedure_in_progress":false,
"collective_procedures":[
],
"legal_source_organization_statuses":[
{
"source_name":"Bodacc",
"organization_status":"Active"
}
]
},
"creation_date":"2017-06-05",
"capital":"5102",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"vat_number":"FR38830134383",
"greffe_name":"Nanterre",
"name":"SMART DATA",
"activity":{
"ape_code":"6201Z",
"ape_code_level1":"JZ",
"ape_code_level2":"JC",
"ape_code_level3":"62",
"ape_code_level4":"J62Z",
"ape_code_level5":"6201Z",
"ape_name":"Programmation informatique",
"corporate_object":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet"
},
"legal":{
"name":"Société par actions simplifiée",
"code_level1":"5",
"code_level2":"57",
"code_level3":"5710",
"person_type":"LegalEntity",
"type":"Siege"
},
"address":{
"street":"176 AVENUE CHARLES DE GAULLE",
"postal_code":"92200",
"city":"NEUILLY-SUR-SEINE",
"country_code":"FR",
"country":"FRANCE",
"lng":2.2697,
"lat":48.8846
},
"insee_category":{
"code":"PE",
"name":"Petite entreprise"
},
"last_legal_update_date":"2022-09-25",
"establishments_count":0
},
"contacts":{
"main_corporate_officier":{
"lastName":"ACINVEST",
"name":"ACINVEST",
"role":"Président",
"role_start_date":"2021-03-17",
"role_end_date":"",
"company":true,
"registration_number":"834282527"
},
"corporate_officiers":[
{
"lastName":"ACINVEST",
"name":"ACINVEST",
"role":"Président",
"role_start_date":"2021-03-17",
"role_end_date":"",
"company":true,
"registration_number":"834282527"
},
{
"lastName":"HEGOA",
"name":"HEGOA",
"role":"Directeur général",
"role_start_date":"2021-03-17",
"role_end_date":"",
"company":true,
"registration_number":"803477181"
}
],
"email":"contact@societeinfo.com",
"emails":[
{
"value":"contact@societeinfo.com",
"type":"generic",
"email_test_result":"Risky",
"email_test_reason":"Deliverable",
"email_test_date":"2022-02-17",
"email_webmail":false
}
]
},
"web_infos":{
"logo_url":"https://media.licdn.com/dms/image/C4E0BAQGQVw8sQSJ0BA/company-logo_200_200/0/1670859487862?e=1682553600&v=beta&t=-ryaZ7hrI7wLtk1kkFGi-b-8O1pt4L_78NRre0-fAys",
"website_url":"http://www.societeinfo.com/",
"websites":[
{
"domain":"societeinfo.com",
"url":"http://www.societeinfo.com/",
"description":"Toutes les données légales, web et les contacts emails BtoB des entreprises françaises. Data B2B, fichiers emails, LEADGEN, Prospection BtoB, Enrichissement de données, Annuaire entreprises, Génération de leads",
"webmaster_phone":"01 70 37 76 66",
"techno_types":[
"youtube",
"google-font-api",
"facebook-pixel",
"nginx",
"weglot",
"microsoft-365",
"lottiefiles",
"jquery",
"core-js",
"webpack",
"webflow",
"recaptcha",
"hsts",
"open-graph",
"axeptio",
"hubspot",
"module-federation",
"google-tag-manager",
"google-hosted-libraries"
],
"metadata":{
"owner_registration_number":"830134383",
"website_crawl_date":"2022-12-14",
"domain_creation_date":"2015-10-12"
}
}
],
"linkedin":{
"url":"https://www.linkedin.com/company/societeinfo-com/",
"id":"societeinfo-com",
"tech_id":"10250344",
"name":"Societeinfo.com",
"description":"Fruit de l’Open Data et des dernières technologies Big Data, Societeinfo vous offre :\n-\tPlus de 12 millions de profils de sociétés & 20 millions de contacts\n-\tDes millions de contacts mails, tel et réseaux sociaux\n-\tUn moteur de recherche sémantique révolutionnaire vous permettant d’hypercibler vos marchés\n\nAvec societeinfo.com, vous pourrez notamment :\n-\tGénérer des listes de prospection ou des fichiers d’emailing ciblés \n-\tEnrichir efficacement votre fichier client \n-\tIdentifier rapidement un marché ou un segment de marché à partir de mots ou expressions clés\n\nSoucieux de mettre à disposition nos données à la portée de tous nous avons développé à la fois une interface web et une puissante API vous permettant d’accéder facilement et à moindre coût à toute la donnée BtoB !\n\nTestez et dopez votre prospection commerciale directement sur https://societeinfo.com/\n\nL’équipe Societeinfo.com",
"follower_count":762,
"employees_range":"2-10",
"employees_count":14,
"crawl_date":"2023-01-26"
},
"twitter":{
"url":"https://twitter.com/@SocieteInfo"
},
"facebook":{
},
"wikipedia":{
},
"youtube":{
},
"instagram":{
}
},
"financials":{
"last_sales":970000,
"last_profit":10657,
"last_staff":14,
"years":[
{
"year":"2023",
"staff":14,
"staff_metadata":{
"estimated":true
}
},
{
"year":"2022",
"sales":970000,
"staff":11,
"sales_metadata":{
"estimated":true
},
"staff_metadata":{
"estimated":true
}
},
{
"year":"2021",
"sales":710000,
"staff":8,
"sales_metadata":{
"estimated":true
},
"staff_metadata":{
"estimated":true
}
},
{
"year":"2020",
"sales":70000,
"sales_metadata":{
"estimated":true
}
},
{
"year":"2019",
"sales":70000,
"sales_metadata":{
"estimated":true
}
},
{
"year":"2017",
"sales":26696,
"profit":10657,
"closing_date":"2017-12-31",
"sales_metadata":{
"estimated":false
},
"profit_metadata":{
"estimated":false
}
}
],
"last_staff_sources":[
{
"source":"Linkedin",
"field":"employees_range",
"range_value":"2-10",
"date":"2023-01-26",
"estimated":false
},
{
"source":"Linkedin",
"field":"employees_count",
"value":14,
"date":"2023-01-26",
"estimated":false
}
]
},
"mark_infos":{
},
"actes":[
{
"date":"2022-08-20",
"type":"Décision(s) du président",
"description":"Augmentation du capital social "
},
{
"date":"2022-08-20",
"type":"Statuts mis à jour"
},
{
"date":"2021-03-17",
"type":"Décision(s) des associés",
"description":"Changement relatif à la date de clôture de l'exercice social"
},
{
"date":"2021-03-17",
"type":"Décision(s) des associés",
"description":"Changement de président"
},
{
"date":"2021-03-17",
"type":"Décision(s) des associés",
"description":"Changement de directeur général"
},
{
"date":"2021-03-17",
"type":"Statuts mis à jour"
},
...
]
}
}
Ce service vous permet d'enrichir vos données si vous ne disposez pas du numéro SIREN de l'entreprise. Il retourne les données complètes de l'entreprise.
Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/company.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| name | Oui | Nom de l'entreprise | |
| street | Oui | Rue et voie OU voie | |
| postal_code | Oui | Code postal | |
| city | Oui | Ville | |
| domain_name | Oui | Nom de domaine OU url du site web | |
| Oui | adresse email | ||
| first_name | Oui | Prénom d'un mandataire/employé | |
| last_name | Oui | Nom d'un mandataire/employé | |
| full_name | Oui | Prénom Nom / Nom prénom d'un mandataire/employé | |
| linkedin_url | Oui | URL Linkedin entreprise (official/admin/sales navigator) ou profil | |
| registration_number | Oui | SIREN/SIRET l'entreprise | |
| min_match_score | 0 | Oui | Ne retourne un résultat que si le score de matching match_info.score est supérieur au score minimum spécifié. Double entre 0.0 et 1.0 |
Combinaisons supportées
| Combinaisons | Supportée | Pertinence |
|---|---|---|
| name, street, postal_code, city | OUI | Killer |
| name, street | OUI | Killer |
| name, postal_code, city | OUI | Good |
| name, city | OUI | Good |
| name, postal_code | OUI | Good |
| street | OUI | Weak |
| name | OUI | Depends :) |
| domain_name ET/OU email | OUI | Good |
| domain_name ET/OU email, name | OUI | Killer |
| domain_name, name | OUI | Killer |
| Linkedin corporate / profil | OUI | Good |
| Linkedin + une autre combinaison | OUI | Killer |
| first_name, last_name, full_name + autre combinaison | OUI | Killer |
Réponse
Le format de réponse de la société est similaire au service Get Company
Le champs match_info.score indique la pertinence du matching. En dessous de 0.3 le résultat devient aléatoire.
Autocomplete Company
curl "https://societeinfo.com/app/rest/api/v2/companies.json/autocomplete?query=smart%20da&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":760,
"currentPage":1,
"totalPages":153,
"searchMode":"autocomplete",
"sorts":[
"score"
],
"result":[
{
"id":"593b6fa6b3a2feb79d4f9f39",
"name":"SMART DATA",
"formatted_address":"92200 Neuilly-sur-Seine",
"lng":2.2593109,
"lat":48.8854852
},
{
"id":"5a6ab622b3a2abb87f16dfe7",
"name":"SMART DATA",
"formatted_address":"92000 Nanterre",
"lng":2.2050135,
"lat":48.8887668
},
{
"id":"5879768ab3a2806717f1b100",
"name":"SMART DIS",
"formatted_address":"75017 Paris",
"lng":2.3078388,
"lat":48.8833078
},
...
]
}
Ce service est recommandé pour l'intégration de formulaires de recherche d'entreprise avec autocompletion. Il permet la recherche par caractère sur les noms et villes des entreprises. Le service supporte aussi les codes SIREN/SIRET
Les données d'entreprise renvoyées sont synthétiques (nom, adresse formattée, géolocation). Pour obtenir les informations détaillées, passez le paramètre ID dans le service Get Company
Une sandbox avec un exemple en jquery est disponible sur github ici
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/companies.json/autocomplete?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| limit | 5 | Oui | Nombre de résultats par page. Limité à 25. |
| query | Oui | Caractères spécifiés pour la recherche |
Advanced URL Parameters
Des paramètres avancés peuvent être spécifiés pour limiter les résultats de recherche à certaines activités ou formes juridiques
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| active | true | Oui | Inclue dans les résultats les entreprises inactives. Les valeurs possibles sont true ou false |
| withEstablishments | false | Oui | Inclue les établissements. Les valeurs possibles sont true ou false |
| nafLevel | Oui | Filtre les entreprises avec la codification NAF définie. Exemple : nafLevel=61&nafLevel=6201Z | |
| nafLevelsExclude | Oui | Ajoutez ce paramètre pour exclure les codes NAF définis. Les valeurs possibles sont true ou false | |
| juridicalFormLevel | Oui | Filtre les entreprises avec la codification des formes juridiques définie. Exemple : juridicalFormLevel=1&juridicalFormLevel=57 | |
| juridicalFormlevelsExclude | Oui | Ajoutez ce paramètre pour exclure les formes juridiques définies. Les valeurs possibles sont true ou false | |
| placeId | Oui | Interrogez le service Place Autocomplete, puis spécifiez les identifiants de places retournés. Filtre les entreprises par région/département/code postal/ville/rue. Exemple : placeId=ID1&placeId=ID2 | |
| convention_collective_code | Oui | Filtre les entreprises selon une liste d'identifiants de conventions collectives. Exemple : convention_collective_code=0016,3216 | |
| with_convention_collective | Oui | Filtre les entreprises disposant d'une convention collective. Les valeurs possibles sont true ou false |
Autocomplete Company V3
curl "https://societeinfo.com/app/rest/api/v3/companies.json/autocomplete?query=smart%20data&key=DEMO"
{
"success":true,
"total":10000,
"currentPage":1,
"totalPages":2000,
"searchMode":"autocomplete",
"sorts":[
"score"
],
"result":[
{
"id":"593b6fa6b3a2feb79d4f9f39",
"name":"SMART DATA",
"formatted_address":"92200 NEUILLY-SUR-SEINE"
},
{
"id":"63474e01c25eb200e588b342",
"name":"DATA-SMART",
"formatted_address":"75007 PARIS"
},
{
"id":"5a6ab622b3a2abb87f16dfe7",
"name":"SMART DATA",
"formatted_address":"95870 BEZONS"
},
...
]
}
[BETA]
Cette version de l'autocomplete est utilisée sur notre application web
La V3 de l'autocomplete ne fonctionne pas sur le principe du N-GRAM, des termes complets doivent être saisis.
Le traitement des termes de la query est plus avancé sur cette version : dénomination, mandataires, bénéficiaires effectifs, localisation...
Cette version ne nécessite pas de paramètres avancés.
HTTP Request
GET https://societeinfo.com/app/rest/api/v3/companies.json/autocomplete?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| limit | 5 | Oui | Nombre de résultats par page. Limité à 25. |
| query | Oui | Caractères spécifiés pour la recherche |
Search Companies
curl "https://societeinfo.com/app/rest/api/v2/companies.json?query=big%20data&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":9090,
"totalContacts":227261,
"currentPage":1,
"totalPages":910,
"searchMode":"keyword",
"sorts":[
"score"
],
"result":[
{
"id":"59325baab3a258592ea0f216",
"registration_number":"830015210",
"full_registration_number":"83001521000016",
"legal_type":"Siege",
"name":"LANSROD BIG DATA",
"activity":"Conseil en systèmes et logiciels informatiques",
"formatted_address":"75008 Paris",
"lng":2.3183,
"lat":48.8763
},
{
"id":"58796e94b3a2806717cd9ce8",
"registration_number":"537750077",
"full_registration_number":"53775007700027",
"legal_type":"Siege",
"name":"BIG DATA SERVICES",
"activity":"Conseil en systèmes et logiciels informatiques",
"formatted_address":"92200 Neuilly-sur-Seine",
"lng":2.2695658,
"lat":48.884683
}
...
]
}
Ce service permet une recherche multi-critères sur l'ensemble des sociétés. Ajustez le paramètre searchMode pour piloter le moteur de recherche
Les données d'entreprise renvoyées sont dans un format synthétique (nom, activité, adresse formattée, géolocation). Pour obtenir les informations détaillées, utilisez ensuite le service de recherche par SIREN/SIRET.
Pour ajouter des critères avancés sur les sociétés possédant des contacts, consultez la section Search Contacts
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description | Valeurs possibles |
|---|---|---|---|---|
| key | Non | Votre clé d'API. | ||
| page | 1 | Oui | Numéro de la page de résultats | |
| limit | 10 | Oui | Nombre de résultats par page. Limité à 25. | |
| query | Oui | Termes spécifiés pour la recherche | ||
| searchMode | keyword | Oui | Spécifie quel type de recherche est appliqué à la query. (voir la liste ci-dessous) | |
| placeId | Oui | Interrogez le service Place Autocomplete, puis spécifiez les identifiants de places retournés. Filtre les entreprises par région/département/code postal/ville/rue. Exemple : placeId=ID1&placeId=ID2 | ||
| where | Oui | Filtre les entreprises avec le code postal/la ville définie | ||
| active | true | Oui | Inclue dans les résultats les entreprises inactives. Les valeurs possibles sont true ou false | |
| withEstablishments | false | Oui | Inclue les établissements. Les valeurs possibles sont true ou false | |
| nafLevel | Oui | Filtre les entreprises avec la codification NAF définie. Exemple : nafLevel=61&nafLevel=6201Z | ||
| nafLevelsExclude | Oui | Ajoutez ce paramètre pour exclure les codes NAF définis. Les valeurs possibles sont true ou false | ||
| juridicalFormLevel | Oui | Filtre les entreprises avec la codification des formes juridiques définie. Exemple : juridicalFormLevel=1&juridicalFormLevel=57 | ||
| juridicalFormlevelsExclude | Oui | Ajoutez ce paramètre pour exclure les formes juridiques définies. Les valeurs possibles sont true ou false | ||
| convention_collective_code | Oui | Filtre les entreprises selon une liste d'identifiants de conventions collectives. Exemple : convention_collective_code=0016,3216 | ||
| with_convention_collective | Oui | Filtre les entreprises disposant d'une convention collective. Les valeurs possibles sont true ou false | ||
| minsales | Oui | Filtre les entreprises avec un chiffre d'affaire supérieur. | ||
| maxsales | Oui | Filtre les entreprises avec un chiffre d'affaire inférieur. | ||
| minprofits | Oui | Filtre les entreprises avec un bénéfice supérieur. | ||
| maxprofits | Oui | Filtre les entreprises avec un bénéfice inférieur. | ||
| minstaff | Oui | Filtre les entreprises avec un effectif supérieur. | ||
| maxstaff | Oui | Filtre les entreprises avec un effectif inférieur. | ||
| mincreationdate | Oui | Filtre les entreprises avec une date de création supérieur. (format YYYYMMDD) | ||
| maxcreationdate | Oui | Filtre les entreprises avec une date de création inférieur. (format YYYYMMDD) | ||
| minceobirthdate | Oui | Filtre les entreprises dont la date de naissance du ceo est supérieur. (format YYYYMMDD) | ||
| maxceobirthdate | Oui | Filtre les entreprises dont la date de naissance du ceo est inférieur. (format YYYYMMDD) | ||
| withsite | Oui | avec un site web identifié. Les valeurs possibles sont true ou false | ||
| withphone | Oui | avec un téléphone identifié. Les valeurs possibles sont true ou false | ||
| withLinkedin | Oui | avec un compte linkedin corporate identifié. Les valeurs possibles sont true ou false | ||
| withemail | Oui | avec un email générique identifié. Les valeurs possibles sont true ou false | ||
| email_test_status | all | Oui | Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe | |
| withFacebook | Oui | avec un compte facebook identifié. Les valeurs possibles sont true ou false | ||
| withtwitter | Oui | avec un compte twitter identifié. Les valeurs possibles sont true ou false | ||
| min_linkedin_followers | Oui | Filtre les entreprises avec un nombre de follower linkedin supérieur. | ||
| max_linkedin_followers | Oui | Filtre les entreprises avec un nombre de follower linkedin inférieur. | ||
| withHighlight | false | Oui | Ajoutez ce paramètre pour ajouter à la réponse la source des mots clés. Les valeurs possibles sont true ou false | |
| analytics | Oui | Filtre les entreprises selon des valeurs analytiques (voir la liste ci-dessous) comme par exemple l'éxcédent brut d'exploitation, EBE (format de filtre d'une mesure: NomMesure @ ValeurMin (optionel) @ ValeurMax (optionel)) | EBE@2000000@4000000,EBE_CA@0.08 | |
| events | Oui | Filtre les entreprises selon les évènements stratégiques (voir la liste ci-dessous dans le catalogue des évènements d'entreprises) ( format de filtre d'un évènement : EvtNiv1 @ EvtNiv2 (optionel) @ SourceÉmeteurEvt (optionel) @ nbMoisAnciennetéMax (optionel) @ nbMoisAnciennetéMin (optionel) @ minDate (optionel) @ maxDate (optionel)). Il est possible d'ajouter plusieurs évènements dans le filtre en utilisant le séparateur ",". Cela entraînera une fusion dans le résultat (et non une intersection). | EVT_39@TYPE_EVT_397@@12,EVT_2@TYPE_EVT_441@Le Progrès de Lyon@@@20220515@20230514 | |
| web_technos | Oui | Filtre les entreprises selon les identifiants des technos utilisées. Exemple : web_technos=magento&web_technos=hubspot Cette exemple filtrera toutes les sociétés utilisant Magento ou Hubspot. | ||
| sort | score | Oui | Spécifie le tri des résultat. Valeurs possibles dans le tableau suivant (voir la liste ci-dessous) |
Search Mode
Le paramètre SearchMode permet de spécifier les types de données sur lequels la query est appliquée
| Nom | Description |
|---|---|
| keyword | Applique la query sur les contenus texte associé à l'entreprise (sources légales, code APE, sites web, réseaux sociaux...). Applique la personQuery sur l'ensemble des données de contact. Supporte les opérateurs booléens AND, OR, NOT (défaut) |
| legalname | Applique la query sur les termes de la raison sociale. |
| name | Applique la query sur les noms (dénomination, nom commercial, sigle) et marques. |
| autocomplete | Applique la query sur les caractères de la raison sociale. Cette option revient à utiliser le service dédié d'AutoComplete (personQuery non appliqué). |
| auto | Exécute une query 'legalname', puis une query 'keyword' si le score de la query 'legalname' est insuffisant. |
Sort
| Nom | Description |
|---|---|
| score | Pertinence |
| salesDesc | Chiffre d'affaire décroissant |
| salesAsc | Chiffre d'affaire croissant |
| salesGrowthDesc | Variation chiffre d'affaire décroissant |
| salesGrowthAsc | Variation chiffre d'affaire croissant |
| profitDesc | Bénéfice décroissant |
| profitAsc | Bénéfice croissant |
| profitGrowthDesc | Variation bénéfice décroissant |
| profitGrowthAsc | Variation bénéfice croissant |
| staffDesc | Effectifs décroissants |
| staffAsc | Effectifs croissants |
| staffGrowthDesc | Variation effectifs décroissant |
| staffGrowthAsc | Variation effectifs croissant |
| riskLevelDesc | Risque décroissant |
| riskLevelAsc | Risque croissant |
| creationDateDesc | Date de création décroissante |
| creationDateAsc | Date de création croissante |
| twitterFollowerDesc | Followers twitter décroissant |
| alexaRankAsc | Rank Alexa croissant |
| totalMarksDesc | Nombre de marques décroissant |
Catalogue des ratios financiers societeinfo inclus dans la recherche
| Nom | Description |
|---|---|
| CA_NET_TOTAL | Chiffre d'affaire Total |
| CA_NET_FR | CA France |
| CA_NET_EXPORT | CA Export;Dont CA réalisé à l'export |
| TOTAL_ACHATS | Achats |
| TOTAL_SALAIRES_CHARGES_EXT | Salaires et Charges externes |
| REX | Résultat d'exploitation |
| IS | Impôts sur les bénéfices |
| RESULTAT_NET | Résultat net |
| TOTAL_TRESO | Trésorerie |
| CAPITAUX_PROPRES | Capitaux propres |
| TOTAL_PASSIF | Total Passif |
| MARGE_BRUTE | Marge brute |
| EBE | Excédent brut d'exploitation |
| RCAI | Résultat courant avant impôt |
| EBE_CA | Poids de l'EBE sur le CA |
| LRE | Ratio de liquidité réduite |
| BFR_JCA | BFR en jour de CA |
| BFRE_JCA | BFRE en jour de CA |
| DETTES_EBE | Nombre d'années d'EBE équivalent à la dette |
| DSO | Délai de règlement client moyen en jour de CA |
| DPO | Délai de règlement fournisseur moyen en jour d'achat |
| GEARING | Taux d'endettement net (Gearing) |
| CAF_CA | Ratio CAF sur CA |
| SAL_CA | Ratio Salaires sur CA |
| INTENS_K | Instensité capitalisitique |
| CAP_REMB | Capacité de remboursement |
| VAR_BFRE_CA | Variation du poids du BFRE sur CA |
| CAGR | Taux de croissance annuel moyen |
Catalogue des évènements d'entreprises societeinfo inclus dans la recherche
| EvtNiv1 | Description EvtNiv1 | EvtNiv2 | Description EvtNiv2 |
|---|---|---|---|
| EVT_15 | Fusion, acquisition, prise de participation | TYPE_EVT_406 | Fusion et acquisition d’entreprise |
| EVT_15 | Fusion, acquisition, prise de participation | TYPE_EVT_407 | Intention d’achat, rumeur d’opération |
| EVT_15 | Fusion, acquisition, prise de participation | TYPE_EVT_408 | Prise de participation minoritaire |
| EVT_1 | Actualité financière | TYPE_EVT_279 | Avis de notations financières d’agences |
| EVT_1 | Actualité financière | TYPE_EVT_280 | Introduction en bourse |
| EVT_1 | Actualité financière | TYPE_EVT_281 | Levées de fonds, augmentation de capital |
| EVT_1 | Actualité financière | TYPE_EVT_281 | Levées de fonds, augmentation de capital |
| EVT_1 | Actualité financière | TYPE_EVT_282 | Publications de résultats |
| EVT_37 | Recrutement | TYPE_EVT_444 | Recrutement |
| EVT_37 | Recrutement | TYPE_EVT_445 | Augmentation stratégique des effectifs |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_418 | Direction des achats et services généraux |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_419 | Direction administrative et financière |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_420 | Direction commerciale et marketing |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_421 | Direction Exploitation |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_422 | Direction export |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_423 | Direction générale |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_424 | Direction immobilière |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_425 | Direction Innovation |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_426 | Direction juridique |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_427 | Direction Logistique |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_428 | Direction des ressources humaines |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_429 | Direction des systèmes d'information |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_430 | Direction Technique |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_431 | Direction Zone |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_432 | Direction développement durable |
| EVT_25 | Nomination dans l'équipe de direction | TYPE_EVT_433 | Direction Etudes / Recherche / Développement |
| EVT_10 | Développement | TYPE_EVT_400 | Croissance du chiffre d'affaires |
| EVT_10 | Développement | TYPE_EVT_401 | Création de filiales, établissements, franchises (export) |
| EVT_10 | Développement | TYPE_EVT_402 | Création de filiales, établissements, franchises (domestique) |
| EVT_10 | Développement | TYPE_EVT_403 | Stratégie de la marque, identité visuelle |
| EVT_10 | Développement | TYPE_EVT_404 | Nouveau concept de distribution |
| EVT_10 | Développement | TYPE_EVT_405 | Innovation, nouveaux marchés, contrats |
| EVT_19 | Investissement productif | TYPE_EVT_409 | Bâti |
| EVT_19 | Investissement productif | TYPE_EVT_410 | Machines |
| EVT_19 | Investissement productif | TYPE_EVT_411 | Non précisé |
| EVT_19 | Investissement productif | TYPE_EVT_412 | Regroupement de sites/Rationalisation |
| EVT_27 | Organisation, rationalisation, externalisation | TYPE_EVT_434 | Externalisation de fonctions supports / logistique / informatique |
| EVT_27 | Organisation, rationalisation, externalisation | TYPE_EVT_435 | Optimisation des fonctions supports, moyens centraux |
| EVT_27 | Organisation, rationalisation, externalisation | TYPE_EVT_436 | Réduction des charges, des coûts |
| EVT_39 | Sinistres | TYPE_EVT_397 | Incendie |
| EVT_39 | Sinistres | TYPE_EVT_398 | Inondation, Tempête |
| EVT_39 | Sinistres | TYPE_EVT_399 | Effraction, vandalisme |
| EVT_2 | Actualités sociales, difficultés | TYPE_EVT_440 | Délocalisation et démantèlement d’unité |
| EVT_2 | Actualités sociales, difficultés | TYPE_EVT_441 | Grève, Tension sociale |
| EVT_2 | Actualités sociales, difficultés | TYPE_EVT_442 | Pertes de marché |
| EVT_2 | Actualités sociales, difficultés | TYPE_EVT_443 | Restructuration et licenciement |
| EVT_2 | Actualités sociales, difficultés | TYPE_EVT_454 | Décès du dirigeant |
| EVT_2 | Actualités sociales, difficultés | TYPE_EVT_455 | Dépôt de plaintes |
curl "https://societeinfo.com/app/rest/api/v2/companies.json?query=big%20data&contact_domain_code=IT&contact_role_query=data%20scientist&email_type=personal&withHighlight=true&key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"total": 378,
"totalContacts": 1227,
"currentPage": 1,
"totalPages": 38,
"searchMode": "keyword",
"sorts": [git
"score"
],
"result": [
{
"id": "5fc19b830932a5204d6575c0",
"registration_number": "790172043",
"full_registration_number": "79017204300065",
"legal_type": "Siege",
"name": "CRAYON FRANCE",
"activity": "Le conseil en gestion d'actifs logiciels, le négoce de logiciels, la formation",
"formatted_address": "92310 SÈVRES",
"lng": 2.2176,
"lat": 48.8229,
"highlights": [
{
"data_category": "Contact",
"data_source": "Linkedin",
"texts": [
"<em><b>Data</b></em> <em><b>scientist</b></em>",
"<em><b>i80</b></em>"
]
},
{
"data_category": "Company",
"data_source": "Linkedin",
"data_field": "Title",
"texts": [
"We provide guidance on the best solutions for our clients’ business needs and budget with software, cloud, AI and <em><b>big</b></em> <em><b>data</b></em>"
]
}
]
},
...
]
}
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| total | Nombre de sociétés | |
| totalContacts | Nombre de contacts dans les sociétés identifiées | |
| currentPage | page courante | |
| totalPages | Nombre total de pages | |
| searchMode | Mode de recherche | Voir bloc 'Search Mode' |
| sorts | Mode de tri | Voir bloc 'Sort' |
| result.id | Identifiant technique | |
| result.registration_number | SIREN | |
| result.full_registration_number | SIRET | |
| result.legal_type | Type établissement | Siege, SecondaryEstablishment |
| result.name | Dénomination | |
| result.activity | Objet social | |
| result.formatted_address | Code postal et Ville | |
| result.lng | longitude | |
| result.lat | latitude | |
| result.highlights.data_category | Catégorie de donnée | Company, Contact |
| result.highlights.data_source | Source de donnée | Legal, Website, Twitter, Linkedin |
| result.highlights.data_field | Type de donnée | Name, Title, Content |
| result.highlights.texts | Extraits de texte avec mots clés |
Search Companies By Officiers
curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_first_name=antoine&contact_last_name=onnen&contact_birth_date=19770307&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":2,
"totalContacts":2,
"currentPage":1,
"totalPages":1,
"searchMode":"all",
"sorts":[
"score"
],
"result":[
{
"id":"593b6fa6b3a2feb79d4f9f39",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"legal_type":"Siege",
"name":"SMART DATA",
"activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
"formatted_address":"92200 NEUILLY-SUR-SEINE",
"lng":2.2593109,
"lat":48.8854852
},
{
"id":"5879740fb3a2806717e65fc1",
"registration_number":"803477181",
"full_registration_number":"80347718100017",
"legal_type":"Siege",
"name":"HEGOA",
"activity":"Développement informatique, conseil en systèmes et logiciels informatiques. ",
"formatted_address":"75018 PARIS",
"lng":2.3439171,
"lat":48.896718
}
]
}
curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_registration_number=538520487&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":2,
"totalContacts":2,
"currentPage":1,
"totalPages":1,
"searchMode":"all",
"sorts":[
"score"
],
"result":[
{
"id": "5879590ab3a28067176b87b9",
"registration_number": "332522341",
"full_registration_number": "33252234100095",
"legal_type": "Siege",
"name": "BOUCHERIES ANDRE",
"activity": "Commerce de détails de produits alimentaires. ",
"formatted_address": "69140 Rillieux-la-Pape",
"lng": 4.9,
"lat": 45.8167
},
...
]
}
Recherche toutes les entreprises dans lesquelles une personne physique/morale est mandataire
GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY
Paramètres pour une personne physique
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_first_name | Oui | Prénom du mandataire | |
| contact_last_name | Oui | Nom du mandataire | |
| contact_birth_date | Oui | Date de naissance du mandataire (format YYYYMMDD) |
Paramètres pour une personne morale (entreprise)
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_registration_number | Non | SIREN mandataire |
Paramètres optionnels
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_level_code | Oui | Filtre le/les niveau(x) de responsabilité des contacts. Exemple : contact_level_code=DIRECTEUR&contact_level_code=RESPONSABLE (voir liste ci-dessous) | |
| contact_domain_code | Oui | Filtre le/les domaine(s) d'activité des contacts. Exemple : contact_domain_code=MARKETING&contact_domain_code=COMMUNICATION (voir liste ci-dessous) | |
| contact_role_query | Oui | Filtre les rôle des mandataires. Exemple : gérant OR président OR directeur |
Contact API
Enrich contact
curl "https://societeinfo.com/app/rest/api/v2/contact.json?domain_name=societeinfo.com&first_name=antoine&last_name=onnen&key=DEMO"
curl "https://societeinfo.com/app/rest/api/v2/contact.json?email=antoine@societeinfo.com&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"contact":{
"id":"830134383621532388",
"civility":"Mr",
"firstName":"Antoine",
"lastName":"ONNEN",
"birth_date":"1977-03-07",
"domain_code":"DG",
"domain_label":"Direction Générale",
"level_code":"DIRIGEANT",
"level_label":"Dirigeant",
"role":"Co-Founder/CTO",
"email":"antoine.onnen@societeinfo.com",
"email_score":0.9,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2022-11-17",
"email_webmail":false,
"linkedin_url":"https://www.linkedin.com/in/antoine-onnen-4376242/",
"extraction_date":"2018-04-01",
"hashcode":"1267633835",
"contact_score":0.95
},
"company":{
"id":"593b6fa6b3a2feb79d4f9f39",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"legal_type":"Siege",
"name":"SMART DATA",
"activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
"formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 NEUILLY-SUR-SEINE",
"ape_code":"6201Z",
"ape_name":"Programmation informatique",
"address":{
"street":"176 AVENUE CHARLES DE GAULLE",
"postal_code":"92200",
"city":"NEUILLY-SUR-SEINE",
"country_code":"FR",
"country":"FRANCE",
"lng":2.2697,
"lat":48.8846
},
"juridical_form_code":"5710",
"juridical_form_name":"Société par actions simplifiée",
"website_url":"http://www.societeinfo.com/",
"linkedin_url":"https://www.linkedin.com/company/societeinfo-com/",
"generic_email":"contact@societeinfo.com",
"last_sales":970000,
"last_profit":10657,
"last_staff":14,
"insee_category":{
"code":"PE",
"name":"Petite entreprise"
}
}
}
Ce service vous permet d'enrichir un contact
Spécifiez uniquement les datas donc vous disposez (prenom, nom, nom société, domaine, linkedin...). Et nos algos de matching feront le reste !
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/contact.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| first_name | Oui | Prénom | |
| last_name | Oui | Nom | |
| full_name | Oui | Prénom Nom / Nom prénom | |
| name | Oui | Nom de l'entreprise | |
| street | Oui | Rue et voie OU voie de l'entreprise | |
| postal_code | Oui | Code postal de l'entreprise | |
| city | Oui | Ville de l'entreprise | |
| domain_name | Oui | Nom de domaine OU url du site web | |
| registration_number | Oui | SIREN/SIRET | |
| Oui | adresse email | ||
| linkedin_url | Oui | URL Linkedin profil | |
| company_linkedin_url | Oui | URL Linkedin entreprise (official/admin/sales navigator) | |
| registration_number | Oui | SIREN/SIRET l'entreprise | |
| withEmail | Oui | Filtre les contacts avec email | |
| withLinkedin | Oui | Filtre les contacts avec linkedin | |
| contact_score | Oui | Score minimum du contact |
Combinaisons supportées
Un ou plusieurs paramètres de contact (prenom, nom, email) et au moins un paramètre entreprise (nom, adresse, linkedin corporate).
Si le paramètre linkedin_url est spécifié, les paramètres entreprises sont optionnels
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| contact.id | Identifiant du contact | |
| contact.civility | Civilité | Mr, Mrs |
| contact.firstName | Prénom | |
| contact.lastName | Nom | |
| contact.domain_code | Code du domaine d'activité | Valeurs possibles |
| contact.domain_label | Libellé du domaine d'activité | Valeurs possibles |
| contact.level_code | Code du niveau de responsabilité | Valeurs possibles |
| contact.level_label | Libellé du niveau de responsabilité | Valeurs possibles |
| contact.role | Mandat ET/OU Rôle linkedin | |
| contact.email | ||
| contact.email_score | Score pertinence email | Double entre 0.0 et 1.0 |
| contact.email_test_result | Résultat test email | Safe to Send, Risky, Invalid, Unknown |
| contact.email_test_reason | Raison test email | Deliverable, Bounce, Accept All, Unreachable |
| contact.email_test_date | Date test email | |
| contact.email_webmail | Webmail ou non (gmail.com, yahoo.fr...) | true, false |
| contact.linkedin_url | Url profil linkedin | |
| contact.extraction_date | Date extraction linkedin | |
| contact.hashcode | Hash sur la donnée de contact | |
| contacts.contact_score | Score du contact | VERY_GOOD [0,85-1], GOOD=[0.7,0,85], AVERAGE=[0.5,0.7], RISKY=[0,0.5] |
| company.id | Identifiant societeinfo de la société | |
| company.registration_number | SIREN | |
| company.full_registration_number | SIRET | |
| company.legal_name | Forme juridique | |
| company.legal_type | Type établissement | Siege, SecondaryEstablishment |
| company.name | Dénomination sociale | |
| company.activity | Objet social | |
| company.formatted_address | Adresse formatée | |
| company.ape_code | Code APE | Code NAF Niv.5 |
| company.ape_label | Libellé code APE | |
| company.address.street | Adresse | |
| company.address.postal_code | Code postal | |
| company.address.city | Ville | |
| company.juridical_form_code | Forme juridique code Niv.3 | |
| company.juridical_form_name | Forme juridique | |
| company.website_url | Site web principal | |
| company.linkedin_url | Url Linkedin corporate | |
| company.generic_email | Email générique principal | |
| company.generic_phone | Téléphone standard principal | |
| company.last_sales | Dernier chiffre d'affaire | |
| company.last_profit | Dernier résultat net | |
| company.last_staff | Dernier nombre d'employés | |
| company.insee_category.code | Code de la catégorie INSEE | TPE, PE, ME, ETI, GE, NON_DEFINIE |
| company.insee_category.name | libellé de la catégorie INSEE |
Get Contacts By Company
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"company":{
"id":"593b6fa6b3a2feb79d4f9f39",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"legal_type":"Siege",
"name":"SMART DATA",
"activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
"formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 NEUILLY-SUR-SEINE",
"ape_code":"6201Z",
"ape_name":"Programmation informatique",
"address":{
"street":"176 AVENUE CHARLES DE GAULLE",
"postal_code":"92200",
"city":"NEUILLY-SUR-SEINE",
"country_code":"FR",
"country":"FRANCE",
"lng":2.2697,
"lat":48.8846
},
"juridical_form_code":"5710",
"juridical_form_name":"Société par actions simplifiée",
"website_url":"http://www.societeinfo.com/",
"linkedin_url":"https://www.linkedin.com/company/societeinfo-com/",
"generic_email":"contact@societeinfo.com",
"last_sales":970000,
"last_profit":10657,
"last_staff":14,
"insee_category":{
"code":"PE",
"name":"Petite entreprise"
}
},
"email_domains":[
{
"domain":"societeinfo.com",
"pattern":"{first}.{last}"
},
{
"domain":"societeinfo.com",
"pattern":"{first}"
}
],
"contacts":[
{
"id":"830134383621532388",
"civility":"Mr",
"firstName":"Antoine",
"lastName":"ONNEN",
"birth_date":"1977-03-07",
"domain_code":"DG",
"domain_label":"Direction Générale",
"level_code":"DIRIGEANT",
"level_label":"Dirigeant",
"role":"Co-Founder/CTO",
"email":"antoine.onnen@societeinfo.com",
"email_score":0.9,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2022-11-17",
"email_webmail":false,
"linkedin_url":"https://www.linkedin.com/in/antoine-onnen-4376242/",
"extraction_date":"2018-04-01",
"hashcode":"1267633835",
"contact_score":0.95
},
{
"id":"8301343831281918940",
"civility":"Mr",
"firstName":"Alexandre",
"lastName":"CONRAUD",
"birth_date":"1987-04-23",
"domain_code":"DG",
"domain_label":"Direction Générale",
"level_code":"DIRIGEANT",
"level_label":"Dirigeant",
"role":"Co-fondateur",
"email":"alexandre.conraud@societeinfo.com",
"email_score":0.9,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2022-11-17",
"email_webmail":false,
"linkedin_url":"https://www.linkedin.com/in/alexandre-conraud/",
"extraction_date":"2022-07-22",
"hashcode":"534384522",
"contact_score":0.69
},
...
],
"contacts_count":12,
"emails":[
]
}
Ce service permet de récupérer les contacts d'une entreprise comportant un email ou un linkedin. Les contacts sont un mix des mandataires légaux, des profils des employés sur les réseaux sociaux et des emails corporate détectés sur le web.
Si uniquement des mandataires légaux sans linkedin ou email sont détectés, aucun résultat n'est renvoyé. En effet l'ensemble des mandataires sans linkedin/email est inclu pour 1 crédit dans le service Get Company
Identifiez l'entreprise avec le numéro SIREN
GET https://societeinfo.com/app/rest/api/v2/contacts.json/<registration_number>?key=YOUR_APIKEY
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| registration_number | Non | Numéro SIREN de l'entreprise |
URL Parameters
Les paramètres suivants vous permettent de limiter le nombre de contacts retournés par le service
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| withemail | Oui | Filtre les contacts avec email. Valeur possible : true | |
| email_test_status | all | Oui | Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe |
| withlinkedin | Oui | Filtre les contacts avec linkedin. Valeur possible : true | |
| withlegal | Oui | Filtre les contacts mandataires légaux. Valeur possible : true | |
| contact_level_code | Oui | Filtre le/les niveau(x) de responsabilité des contacts. Exemple : contact_level_code=DIRECTEUR&contact_level_code=RESPONSABLE (voir liste ci-dessous) | |
| contact_domain_code | Oui | Filtre le/les domaine(s) d'activité des contacts. Exemple : contact_domain_code=MARKETING&contact_domain_code=COMMUNICATION (voir liste ci-dessous) | |
| contact_role_query | Oui | Ajout d'une requête sémantique sur les postes des contacts | |
| contact_max | Oui | Nombre de contacts max dans la réponse |
contact_level_code
Voir les valeurs possibles
contact_domain_code
Par exemple "python" renverra tous les postes intégrant le mot "python"
Voir les valeurs possibles
contact_role_query
Optionnel, Identifiez des mots clés dans spécifiques dans les postes
Par exemple "python" renverra tous les postes intégrant le mot "python"
Pour étendre les résultats, utilisez l'expression sémantique suivante : "python OR javascript"
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| email_domains.domain | Domain mail corporate | |
| email_domains.pattern | Pattern mail corporate | |
| contacts.id | Identifiant du contact | |
| contacts.civility | Civilité | Mr, Mrs |
| contacts.firstName | Prénom | |
| contacts.lastName | Nom | |
| contacts.role | Mandat ET/OU Rôle linkedin | |
| contacts.email | ||
| contacts.email_score | Score pertinence email | Double entre 0.0 et 1.0 |
| contacts.email_test_result | Résultat test email | Safe to Send, Risky, Invalid, Unknown |
| contacts.email_test_reason | Raison test email | Deliverable, Bounce, Accept All, Unreachable |
| contacts.email_test_date | Date test email | |
| contacts.email_webmail | Webmail ou non (gmail.com, yahoo.fr...) | true, false |
| contacts.linkedin_url | Url profil linkedin | |
| contacts.extraction_date | Date extraction linkedin | |
| contacts.hashcode | Hash sur la donnée de contact | |
| contacts.contact_score | Score du contact | VERY_GOOD [0,85-1], GOOD=[0.7,0,85], AVERAGE=[0.5,0.7], RISKY=[0,0.5] |
| emails.value | Email détecté | |
| emails.type | Type email | generic, personal |
| emails.sources | Sources email | |
| company.registration_number | SIREN | |
| company.full_registration_number | SIRET | |
| company.legal_name | Forme juridique | |
| company.legal_type | Type établissement | Siege, SecondaryEstablishment |
| company.name | Dénomination sociale | |
| company.activity | Objet social | |
| company.formatted_address | Adresse formatée | |
| company.ape_code | Code APE | |
| company.ape_label | Libellé code APE | |
| company.address.street | Adresse | |
| company.address.postal_code | Code postal | |
| company.address.city | Ville | |
| company.juridical_form_code | Code forme juridique | Forme juridique code Niv.3 |
| company.juridical_form_name | Libellé forme juridique | |
| company.website_url | Site web principal | |
| company.linkedin_url | Url Linkedin corporate | |
| company.generic_email | Email générique principal | |
| company.generic_phone | Téléphone standard principal | |
| company.last_sales | Dernier chiffre d'affaire | |
| company.last_profit | Dernier résultat net | |
| company.last_staff | Dernier nombre d'employés | |
| company.insee_category.code | Code de la catégorie INSEE | TPE, PE, ME, ETI, GE, NON_DEFINIE |
| company.insee_category.name | libellé de la catégorie INSEE |
curl "https://societeinfo.com/app/rest/api/v2/contacts.json?domain_name=societeinfo.com&contact_domain_code=MARKETING&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"company":{
"id":"593b6fa6b3a2feb79d4f9f39",
"registration_number":"830134383",
"full_registration_number":"83013438300017",
"legal_type":"Siege",
"name":"SMART DATA",
"activity":"La société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet",
"formatted_address":"176 AVENUE CHARLES DE GAULLE 92200 NEUILLY-SUR-SEINE",
"ape_code":"6201Z",
"ape_name":"Programmation informatique",
"address":{
"street":"176 AVENUE CHARLES DE GAULLE",
"postal_code":"92200",
"city":"NEUILLY-SUR-SEINE",
"country_code":"FR",
"country":"FRANCE",
"lng":2.2697,
"lat":48.8846
},
"juridical_form_code":"5710",
"juridical_form_name":"Société par actions simplifiée",
"website_url":"http://www.societeinfo.com/",
"linkedin_url":"https://www.linkedin.com/company/societeinfo-com/",
"generic_email":"contact@societeinfo.com",
"last_sales":970000,
"last_profit":10657,
"last_staff":14,
"insee_category":{
"code":"PE",
"name":"Petite entreprise"
}
},
"email_domains":[
{
"domain":"societeinfo.com",
"pattern":"{first}.{last}"
},
{
"domain":"societeinfo.com",
"pattern":"{first}"
}
],
"contacts":[
{
"id":"8301343831742052641",
"civility":"Mrs",
"firstName":"Afef",
"lastName":"AYED",
"domain_code":"MARKETING",
"domain_label":"Marketing",
"level_code":"RESPONSABLE",
"level_label":"Responsable",
"role":"Head of growth marketing",
"email":"afef.ayed@societeinfo.com",
"email_score":0.94,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2023-01-19",
"email_webmail":false,
"linkedin_url":"https://www.linkedin.com/in/afef-ayed/",
"extraction_date":"2022-12-30",
"hashcode":"1689321661",
"contact_score":0.98
}
],
"contacts_count":1,
"emails":[
]
}
Identifiez l'entreprise sans le numéro SIREN
Ces paramètres vous permetttent de chercher les contacts d'une entreprise sans disposer du numéro SIREN.
Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste !
GET https://societeinfo.com/app/rest/api/v2/contacts.json?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| name | Oui | Nom de l'entreprise | |
| street | Oui | Rue et voie OU voie | |
| postal_code | Oui | Code postal | |
| city | Oui | Ville | |
| domain_name | Oui | Nom de domaine OU url du site web | |
| Oui | adresse email | ||
| linkedin_url | Oui | URL Linkedin | |
| min_match_score | 0 | Oui | Ne retourne un résultat que si le score de matching match_info.score est supérieur au score minimum spécifié. Double entre 0.0 et 1.0 |
- Et paramètres optionnels de filtres sur les contacts
Combinaisons supportées
| Combinaisons | Supportée | Pertinence |
|---|---|---|
| name, street, postal_code, city | OUI | Killer |
| name, street | OUI | Killer |
| name, postal_code, city | OUI | Good |
| name, city | OUI | Good |
| name, postal_code | OUI | Good |
| street | OUI | Weak |
| name | OUI | Depends :) |
| domain_name ET/OU email | OUI | Good |
| domain_name ET/OU email, name | OUI | Killer |
| domain_name, name | OUI | Killer |
| Linkedin corporate | OUI | Good |
| Linkedin + une autre combinaison | OUI | Killer |
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?show_all_anonymized=true&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"contacts":[
{
"id":"830134383621532388",
"civility":"Xx",
"firstName":"Xxxxx",
"lastName":"XXXXXXXX",
"birth_date":"YYYY-MM-dd",
"domain_code":"DG",
"domain_label":"Direction Générale",
"level_code":"DIRIGEANT",
"level_label":"Dirigeant",
"role":"Co-Founder/CTO",
"email":"xx@xx.xx",
"email_score":0.9,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2022-11-17",
"email_webmail":false,
"linkedin_url":"https://fr.linkedin.com/in/x",
"extraction_date":"2018-04-01",
"anonymized":true,
"hashcode":"1267633835",
"contact_score":0.95
},
{
"id":"8301343831281918940",
"civility":"Xx",
"firstName":"Xxxxx",
"lastName":"XXXXXXXX",
"birth_date":"YYYY-MM-dd",
"domain_code":"DG",
"domain_label":"Direction Générale",
"level_code":"DIRIGEANT",
"level_label":"Dirigeant",
"role":"Co-fondateur",
"email":"xx@xx.xx",
"email_score":0.9,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2022-11-17",
"email_webmail":false,
"linkedin_url":"https://fr.linkedin.com/in/x",
"extraction_date":"2022-07-22",
"anonymized":true,
"hashcode":"534384522",
"contact_score":0.69
},
...
],
"contacts_count":12
}
curl "https://societeinfo.com/app/rest/api/v2/contacts.json/830134383?contact_ids=830134383621532388&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"contacts":[
{
"id":"830134383621532388",
"civility":"Mr",
"firstName":"Antoine",
"lastName":"ONNEN",
"birth_date":"1977-03-07",
"domain_code":"DG",
"domain_label":"Direction Générale",
"level_code":"DIRIGEANT",
"level_label":"Dirigeant",
"role":"Co-Founder/CTO",
"email":"antoine.onnen@societeinfo.com",
"email_score":0.9,
"email_test_result":"Safe to Send",
"email_test_reason":"Deliverable",
"email_test_date":"2022-11-17",
"email_webmail":false,
"linkedin_url":"https://www.linkedin.com/in/antoine-onnen-4376242/",
"extraction_date":"2018-04-01",
"hashcode":"1267633835",
"contact_score":0.95
}
],
"contacts_count":1
}
Visualisez les contacts anonymisés et sélectionnez les rôles que vous souhaitez
Pour retourner l'ensemble des contacts d'une société sous forme anonymisée, spécifiez le paramètre 'show_all_anonymized' (voir exemple). En spécifiant ce paramètre, tous les contacts sont alors retournés gratuitement avec les champs non vides obfusqués à l'exception du champs 'role'
Visualisez, sélectionnez les rôles que vous souhaitez, puis interrogez le service avec le paramètre 'contact_ids' pour obtenir les contacts complets (voir exemple)
Rafraichissez vos données de contact
Si vous souhaitez vérifier la fraicheur de vos données de contacts, comparez vos données avec le champs 'hashcode'
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| show_all_anonymized | false | Oui | Active l'anonymisation des contacts |
| contact_ids | Oui | Liste des identifiants de contact à retourner séparés par une virgule |
- Et paramètres obligatoires d'identification d'entreprise
- Et paramètres optionnels de filtres sur les contacts
Search Contacts
curl "https://societeinfo.com/app/rest/api/v2/companies.json?contact_domain_code=IT&contact_role_query=data%20scientist&email_type=personal&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"total":1610,
"totalContacts":3564,
"currentPage":1,
"totalPages":162,
"searchMode":"keyword",
"sorts":[
"score"
],
"result":[
{
"id":"587964c5b3a2806717a2dd45",
"registration_number":"469500961",
"full_registration_number":"46950096100831",
"legal_type":"Siege",
"name":"ArcelorMittal Distribution Solutions France",
"activity":"la branche du fonds de commerce ayant pour activité l'achat, la préparation, la transformation, le conditionnement, le transport et la vente de plaque d'acier",
"formatted_address":"51370 Saint-Brice-Courcelles",
"lng":3.9833,
"lat":49.2667
},
{
"id":"58796634b3a2806717a93453",
"registration_number":"484893110",
"full_registration_number":"48489311000052",
"legal_type":"Siege",
"name":"INFOLOGIK",
"activity":"Conseil en systèmes et logiciels informatiques",
"formatted_address":"56100 Lorient",
"lng":-3.3667,
"lat":47.75
},
{
"id":"587966a6b3a2806717ab2781",
"registration_number":"489139436",
"full_registration_number":"48913943601383",
"legal_type":"Siege",
"name":"BCA EXPERTISE SAS",
"activity":"Évaluation des risques et dommages",
"formatted_address":"92600 Asnières-sur-Seine",
"lng":2.2833,
"lat":48.9167
},
...
]
}
Ce service permet de rechercher les sociétés contenant des contacts.
Les données d'entreprise renvoyées sont dans un format synthétique (SIREN, nom, activité, adresse formattée, géolocation). Requêtez ensuite par SIREN le service Get Contacts By Company pour obtenir les contacts de chaque société
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/companies.json?key=YOUR_APIKEY
Company URL Parameters
Les critères société (forme juridique, chiffre d'affaire...) sont définis dans le service Search Companies
Contact URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| contact_level_code | Oui | Filtre le/les niveau(x) de responsabilité des contacts. Exemple : contact_level_code=DIRECTEUR&contact_level_code=RESPONSABLE (voir liste ci-dessous) | |
| contact_domain_code | Oui | Filtre le/les domaine(s) d'activité des contacts. Exemple : contact_domain_code=MARKETING&contact_domain_code=COMMUNICATION (voir liste ci-dessous) | |
| contact_role_query | Oui | Ajout d'une requête sémantique sur les postes des contacts | |
| email_type | Oui | Filtre les sociétés avec le/les types d'emails souhaités. Voir tableau email_type ci-dessous. Exemple : email_type=personal&email_type=withoutwebmail | |
| email_test_status | all | Oui | Filtre les emails testés. Les valeurs possibles sont all,safe,notsafe |
| contact_source | Oui | Filtre l'origine des contacts. Les valeurs possibles sont legal,linkedin. Exemple contact_source=legal&contact_source=linkedin |
Contact level
Le paramètre contact_level_code permet de spécifier les niveaux de responsabilité des contacts
| Code | Libellé |
|---|---|
| MANDATAIRE | Mandataire |
| DIRIGEANT | Dirigeant |
| GERANT | Gérant |
| DIRECTEUR | Directeur |
| RESPONSABLE | Responsable |
| ASSIST | Assistant |
| COLLAB | Collaborateur |
| AUTRE | Autre |
Contact domain
Le paramètre contact_domain_code permet de spécifier le domaine d'activité des contacts
| Code | Libellé | Disponible dans l'IHM |
|---|---|---|
| DG | Direction Générale | Oui |
| ADMIN_FINANCE | Administration et Finance | Oui |
| ACHAT | Achats | Oui |
| RH | Ressources Humaines | Oui |
| IT | Informatique | Oui |
| MARKETING | Marketing | Oui |
| COMMUNICATION | Communication | Oui |
| CONFORMITE | Conformité | Oui |
| COMMERCE | Commerce | Oui |
| JURIDIQUE | Juridique | Oui |
| R_D | Recherche et Développement | Oui |
| SAV | Relation et support client | Oui |
| PROD_LOGISTIQUE | Production et Logistique | Oui |
| AGRI | Agricole | Non |
| ARMEE | Armée et Défense | Non |
| ART | Art et Design | Non |
| AUTOMOBILE | Automobile | Non |
| BANQ_ASSUR | Banque Assurance | Non |
| BEAUTE | Soin Beauté Cosmétique | Non |
| BTP | Construction | Non |
| CAISSIER | Personnel de caisse | Non |
| CHR | Café Hotellerie Restauration | Non |
| FORMATION_ENSEIGN | Formation et Enseignement | Non |
| FUNERAIRE | Services funéraires | Non |
| LOISIR | Loisir | Non |
| MAGASIN | Magasin | Non |
| PHARMA | Pharmacie | Non |
| PRESSING | Pressing | Non |
| PUBLIC_SOCIAL | Adminstration publiques et sociales | Non |
| SECURITE | Sécurité | Non |
| SANTE | Santé et Médical | Non |
| TEXTILE | Textile | Non |
Email Type
Le paramètre email_type permet de spécifier les types d'emails de la société
| Nom | Description |
|---|---|
| generic | Avec emails génériques |
| personal | Avec emails directs |
| withwebmail | Avec webmails |
| withoutwebmail | Sans webmails |
Financial API
Get Financial
curl "https://societeinfo.com/app/rest/api/v2/financial/statements.json/342376332?statement=ANALYTICS&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"groups":[
{
"metadata":{
"label":"Ratios financiers",
"statement":"ANALYTICS",
"currency_code":"EUR",
"rows":[
{
"code":"EBE",
"label":"Excédent brut d'exploitation",
"total":true
},
{
"code":"BFR",
"label":"Besoin en fonds de roulement",
"total":true
},
{
"code":"BFRE",
"label":"Besoin en fonds de roulement d'exploitation",
"total":true
},
{
"code":"BFRHE",
"label":"Besoin en fonds de roulement hors exploitation",
"total":true
},
{
"code":"FDR",
"label":"Fonds de roulement",
"total":true
},
{
"code":"CAF",
"label":"Capacité d'autofinancement",
"total":true
},
{
"code":"EBE_CA",
"label":"Poids de l'EBE sur le CA",
"total":true
},
{
"code":"LRE",
"label":"Ratio de liquidité réduite",
"total":true
},
{
"code":"BFR_CA",
"label":"BFR / CA",
"total":true
},
{
"code":"BFRE_CA",
"label":"BFRE / CA",
"total":true
},
{
"code":"BFR_JCA",
"label":"BFR en jour de CA",
"total":true
},
{
"code":"BFRE_JCA",
"label":"BFRE en jour de CA",
"total":true
},
{
"code":"DSO",
"label":"Délai de règlement client moyen en jour de CA",
"total":true
},
{
"code":"DPO",
"label":"Délai de règlement fournisseur moyen en jour d'achat",
"total":true
},
...
]
},
"dates":[
{
"closing_date":"2020-12-31",
"valid":true,
"rows":[
{
"code":"EBE",
"value":-31765000
},
{
"code":"BFR",
"value":304799000
},
{
"code":"BFRE",
"value":18617000
},
{
"code":"BFRHE",
"value":286182000
},
{
"code":"FDR",
"value":11439160000
},
{
"code":"CAF",
"value":76321000
},
{
"code":"EBE_CA",
"value":-0.2267632781267847
},
{
"code":"LRE",
"value":20.476153517792696
},
{
"code":"BFR_CA",
"value":2.175892347230154
},
{
"code":"BFRE_CA",
"value":0.13290262707024558
},
{
"code":"BFR_JCA",
"value":783.3212450028554
},
{
"code":"BFRE_JCA",
"value":47.84494574528841
},
{
"code":"DSO",
"value":10316520000
},
{
"code":"DPO",
"value":48.96926281364973
},
...
]
}
...
]
}
]
}
Ce service permet de récupérer les données des liasses fiscales déposées au greffe par les entreprises françaises ainsi que des mesures analytiques. L’API renvoie les états financiers de tous les exercices disponibles.
Nous validons les données de l’INPI car celles-ci sont constituées à partir d’un processus d’océrisation qui peut générer des erreurs. Un champs "status" indique la validité des comptes.
Seuls les sociétés déposant leurs comptes au greffe et n’ayant pas opté pour l’option de confidentialité sont disponibles.
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/financial/statements.json/<registration_number>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Défaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| registration_number | Non | Numéro SIREN de l'entreprise | |
| statement | BILAN, PNL | Oui | Filtre la catégorie financière retourné (voir ci-dessous) |
| detailLevel | Synthetic | Oui | Limite le nombre de mesures pour un statement donné. Valeurs possibles : Synthetic,Full |
statement
| Nom | Description |
|---|---|
| ANALYTICS | Renvoie les mesures analytiques calculées par societeinfo se basant sur les données des liasses fiscales (le paramètre "detailLevel" n'a pas d'utilité ici). Le catalogue des ratios financiers societeinfo est décrit plus bas. |
| BILAN | Limite au bilan comptable |
| PNL | Limite au compte de résultat |
Voici la liste complète des indicateurs retournés
Réponse
| Champs | Description | Valeurs possibles |
|---|---|---|
| groups.metadata | Définition des champs de chaque statement | |
| groups.dates.closing_date | Date de clôture | |
| groups.dates.duration_in_month | Durée de l’exercice | |
| groups.dates.valid | Validation interne des comptes | true, false |
| groups.dates.status | Code erreur lié de la validation | OK, KO, CONFIDENTIEL |
| groups.dates.rows | Valeur des champs |
Les comptes publiés par les entreprises françaises peuvent avoir différents formats :
Consolidés : Comptes consolidés de la société correspondant au SIREN demandé.
Complets : Comptes sociaux détaillés.
Simplifiés : Comptes sociaux simplifiés.
Banque : Comptes simplifiés de banque.
Assurance : Comptes simplifiés d’assurance.
Surveillance API
Ce service permet de configurer une surveillance de SIREN. Le principe est simple, vous chargez une liste de SIREN que vous souhaitez surveiller, ensuite vous recevrez tous les jours par mail et/ou webhook les changements de données sur vos SIREN.
Les services de configuration de la surveillance sont décrits sur la page Swagger suivante
https://societeinfo.com/app/swagger/sentinel/index.html
La configuration d'une surveillance se fait en 5 étapes
- Création d'une sentinelle
- Configuration des SIREN
- Configuration des properties
- Configuration des connecteurs
- Activation de la sentinelle
Vous pouvez réaliser les étapes 2, 3 et 4 dans l'ordre que vous souhaitez, et vous pourrez toujours revenir sur la configuration même après activation.
Vous avez la possibilité de générer gratuitement un évènement de test pour valider votre intégration !
Test de la sentinelle
Création d'une sentinelle
curl -X 'POST' \
'https://societeinfo.com/app/rest/api/v2/sentinels?sentinel_name=ma_sentinelle' \
-H 'accept: application/json' \
-H 'X-API-KEY: YOUR_API_KEY' \
-d ''
La commande retourne le JSON suivant :
{
"success": true,
"status": 200,
"object": {
"name": "ma_sentinelle",
"mode": "EVERY_DAY",
"enable": false,
"cost": "Current period [2022-12-06 ; 2023-01-06[ has cost 0 credit.",
"sentinelSources": {
"sources": [
{
"type": "SIREN_STORES",
"stores": [
"ma_sentinelle"
]
}
]
},
"monitoredProperties": {
"properties": [
{
"propertyPath": "ALL",
"propertyPathCaption": "All"
}
]
},
"sentinelConnectors": {
"connectors": [
{
"type": "GAP_STORE"
}
]
}
}
}
Créez votre instance sentinelle de surveillance !
Configuration des SIREN
Le plus simple c'est de mettre l'ensemble des SIREN que vous voulez surveiller dans un fichier texte, avec ou sans en-tête de colonne. Le système arrivera à reconnaitre automatiquement la bonne colonne.
Pour charger votre liste de SIREN Lien swagger
Si vous voulez envoyer des SIREN dans votre liste sans passer par un fichier Lien swagger
Vous n'aurez qu'à séparer vos SIREN par une virgule. Attention ne mettez pas plus de 500 SIREN dans une même requête ou votre liste risque d'être tronquée.
Configuration des properties
curl "https://societeinfo.com/app/rest/api/v2/sentinels/config/properties"
La commande retourne le JSON suivant :
{
"success": true,
"status": 200,
"object": [
...
{
"propertyPath": "LEGAL/LEGAL_ETAT",
"propertyPathCaption": "Legal/Etat de l'entreprise"
},
...
{
"propertyPath": "RISK/RISK_SCORE",
"propertyPathCaption": "Risque/Risque de défaut de paiement"
},
...
{
"propertyPath": "FINANCIAL/FINANCIAL_STAFF",
"propertyPathCaption": "Financial/Effectifs déclarés par l'entreprise"
},
...
{
"propertyPath": "PUBLICATIONS/BODACCA/PRESSE_BODACCA_VENTE",
"propertyPathCaption": "Publications/BodaccA/Les ventes d'établissements"
},
...
{
"propertyPath": "PUBLICATIONS/ARTICLES_PRESSE/FUSION_ACQUISITION",
"propertyPathCaption": "Publications/Articles de presse/Fusion, acquisition, prise de participation"
},
{
"propertyPath": "PUBLICATIONS/ARTICLES_PRESSE/RECRUTEMENT",
"propertyPathCaption": "Publications/Articles de presse/Recrutement"
},
...
{
"propertyPath": "PUBLICATIONS/ACTES_STATUTS/NOMINATIONS_DEMISSIONS",
"propertyPathCaption": "Publications/Actes et statuts/Nominations / Démissions"
},
{
"propertyPath": "PUBLICATIONS/ACTES_STATUTS/FUSION",
"propertyPathCaption": "Publications/Actes et statuts/Fusion"
},
{
"propertyPath": "PUBLICATIONS/ACTES_STATUTS/LIQUIDATIONS",
"propertyPathCaption": "Publications/Actes et statuts/Liquidations judiciaires"
}
...
]
}
Configurez les informations que vous voulez surveiller sur les entreprises
Par défaut la propriété 'ALL' est activée, cela signifie que toutes les propriétés sont surveillées :)
Mais si vous voulez recevoir des notifications de changement de données sur des catégories de données particulières, par exemple que : les changements d'adresse des sièges des entreprises et les changement de chiffre d'affaires, alors vous devrez copier-coller cette chaine de caractères :
LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_SIEGE,FINANCIAL/FINANCIAL_SALES
Il existe plus de 70 niveaux de granularité Lien swagger
Configuration des connecteurs
Format JSON des messages webhook
{
"context":{
"from":"2022-12-12",
"to":"2022-12-13",
"registrationNumber":"482880788"
},
"gapList":[
{
"property":{
"propertyPath":"LEGAL/LEGAL_NOM_DENO",
"propertyPathCaption":"Legal/Dénomination de l'entreprise"
},
"gap":{
"type":"STRING",
"from":"OLD_9 ATRAM LASER",
"to":"ATRAM LASER"
}
},
{
"property":{
"propertyPath":"LEGAL/LEGAL_CAPITAL",
"propertyPathCaption":"Legal/Capital social de l'entreprise"
},
"gap":{
"type":"STRING",
"from":"1 EUR",
"to":"8000 EUR"
}
}
],
"companyInfo":{
"id":"587965d5b3a2806717a77f66",
"organization":{
"status":"Active",
"risk":{
"risk_level":0,
"risk_level_description":"Pas de risque identifié",
"collective_procedure_in_progress":false,
"collective_procedures":[],
"legal_source_organization_statuses":[
{
"source_name":"Bodacc",
"organization_status":"Active"
}
]
},
"creation_date":"2005-07-01",
"capital":"8000",
"registration_number":"482880788",
"full_registration_number":"48288078800013",
"vat_number":"FR47482880788",
"greffe_name":"Arras",
"name":"ATRAM LASER",
...
"last_legal_update_date":"2022-12-13",
"establishments_count":0
},
"contacts":{
"main_corporate_officier":{
"civility":"Mrs",
"firstName":"Marie",
"lastName":"WULLEPUT",
"name":"Marie WULLEPUT",
"birth_date":"1954-10-14",
"role":"Gérant",
"role_start_date":"2016-12-26",
"role_end_date":"",
"company":false
},
...
},
"web_infos":{
...
},
"financials":{
...
},
"actes":[
...
]
}
}
La sentinelle notifie les évènements de surveillance sur plusieurs types de connecteurs configurables.
Vous pouvez ajouter/supprimer un/des emails destinataires des notifications avec le service suivant Lien swagger
Webhook
Vous pouvez également configurer un/des webhooks via le service suivant Lien swagger
Un message est envoyé pour chaque entreprise impactée, le message contient l'ensemble des propriétés affectées par votre configuration
Le message webhook est au format JSON suivant
| Champs | Description | Valeurs possibles |
|---|---|---|
| context.from | Date de référence | AAAA-MM-JJ |
| context.to | Date de la modification | AAAA-MM-JJ |
| context.registrationNumber | Numéro SIREN de l'entreprise | |
| gapList | Liste des évènements | |
| gapList[].property.propertyPath | Code de l'évènement | Liste des propriétés |
| gapList[].property.propertyPathCaption | Nom de l'évènement | Liste des propriétés |
| gapList[].gap.type | Type de la donnée | STRING, DOUBLE, INTEGER, LONG, DATE, DATETIME, BOOLEAN, OBJECT |
| gapList[].gap.from | Précédente valeur | |
| gapList[].gap.to | Nouvelle valeur | |
| companyInfo | Informations sur la société | Service GetCompany |
GapStore
Par défaut tous les évènements générés sont persistés dans un gapStore associé à la sentinelle.
Vous pouvez interroger votre gapStore et récupérer l'historique des évènements avec le service suivant Lien swagger
Activation de la sentinelle
curl -X 'PATCH' \
'https://societeinfo.com/app/rest/api/v2/sentinels/ma_Sentinelle/enable' \
-H 'accept: application/json' \
-H 'X-API-KEY: jov4vncnp9fbhmdvpfvb89if975gquah6f5cvm0qkb0aoub6ngc'
La commande retourne le JSON suivant :
{
"success": true,
"status": 200,
"object": [
{
"name": "ma_sentinelle",
"mode": "EVERY_DAY",
"enable": true,
"sentinelSources": {
"sources": [
{
"type": "SIREN_STORES",
"stores": [
"ma_sentinelle",
"mes_clients",
"mes_prospects"
]
}
]
},
"monitoredProperties": {
"properties": [
{
"propertyPath": "LEGAL",
"propertyPathCaption": "Legal"
},
{
"propertyPath": "PUBLICATIONS",
"propertyPathCaption": "Publications"
},
{
"propertyPath": "FINANCIAL",
"propertyPathCaption": "Financial"
},
{
"propertyPath": "RISK",
"propertyPathCaption": "Risque"
}
]
},
"sentinelConnectors": {
"connectors": [
{
"type": "GAP_STORE"
},
{
"type": "MAIL",
"emails": [
"example@societeinfo.com"
]
},
{
"type": "WEB_HOOK",
"urls": ["https://mon.webhook.com"]
}
]
}
},
...
]
}
Tant que vous n'avez pas activé votre sentinelle, aucune notification ne vous sera envoyée, et aucun décompte de crédit ne sera réalisé.
Pour activer la sentinelle Lien swagger
Si vous êtes arrivé jusqu'ici sans problème c'est que votre sentinelle est configurée, et que vous allez recevoir des notifications de changement de données dés demain.
Si vous souhaitez mettre en pause votre sentinelle Lien swagger
Pour la réactiver Lien swagger
Pour toutes les étapes précédentes listées, vous avez des endpoints pour modifier ou supprimer des propriétés de votre sentinelle.
Vous pouvez consulter l'état de votre configuration de votre sentinelle Lien swagger
Vérifiez que :
- la clé
enablevauttruesi vous avez activé votre sentinelle, - et que vous retrouvez bien les éléments que vous avez configuré à chaque étape.
Test de la sentinelle
curl -X 'GET' \
'https://societeinfo.com/app/rest/api/v2/sentinels/ma_sentinelle/test' \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
La commande envoie l'objet suivant sur le webhook configuré
{
"feature": "SURVEILLANCE",
"sentinel": "sentinel_daily_murat_dev",
"context": {
"from": "2024-05-16",
"to": "2024-05-17",
"registrationNumber": "901769935"
},
"gapList": [
{
"property": {
"propertyPath": "LEGAL/LEGAL_NOM_DENO",
"propertyPathCaption": "Legal/Dénomination de l'entreprise"
},
"gap": {
"type": "STRING",
"dataType": "string",
"from": "OLD_5 CUP OF TEA",
"to": "CUP OF TEA"
}
},
{
"property": {
"propertyPath": "LEGAL/LEGAL_CAPITAL",
"propertyPathCaption": "Legal/Capital social de l'entreprise"
},
"gap": {
"type": "STRING",
"dataType": "string",
"from": "2770 EUR",
"to": "3597 EUR"
}
}
],
"companyInfo": {
"id": "610338257cf1117fc6fea3e9",
"organization": {
"status": "Active",
"registration_number": "901769935",
"full_registration_number": "90176993500015",
"vat_number": "FR90901769935",
"greffe_name": "Lyon",
"name": "CUP OF TEA",
"acronym_name": "CUPOFT",
…
},
"contacts": {
"main_corporate_officier": {
"lastName": "EGLANTINE 3.0",
"name": "EGLANTINE 3.0",
"role": "Président",
"role_start_date": "2021-07-27",
"role_end_date": "",
"company": true,
"registration_number": "821043205"
},
"corporate_officiers": [
{
"lastName": "EGLANTINE 3.0",
"name": "EGLANTINE 3.0",
"role": "Président",
"role_start_date": "2021-07-27",
"role_end_date": "",
"company": true,
"registration_number": "821043205"
}
],
"email":…
},
"web_infos": {
…
},
"financials": {
…
},
"actes": [
{
"date": "2021-07-27",
"type": "Statuts constitutifs",
"description": " Constitution d'une société commerciale par création"
}
]
}
}
Pour tester que les connecteurs de votre sentinelle sont bien configurés Lien swagger
Vous recevrez une notification "type" sur chacun des connecteurs (= sur l'ensemble des emails + webhooks qui ont été configurés). La notification ne comportera que des changements sur un SIREN pris aléatoirement dans la base Societeinfo.
Le type des valeurs gapList[].gap.from et gapList[].gap.to dependent du type de la propriété. Ce type est renseigné dans le champ gapList[].gap.dataType. Ci-dessous un tableau listant les propriétés existante dans la surveillance suivant d'un second tableau affichant un exemple pour chacun des dataTypes.
Liste des propriétés de la surveillance
| identifiant de la propriété | gapType |
|---|---|
| LEGAL/LEGAL_NOM_DENO | string |
| LEGAL/LEGAL_NOM_COMMERCIAL | string |
| LEGAL/LEGAL_NOM_ENSEIGNE | string |
| LEGAL/LEGAL_ETAT | string |
| LEGAL/LEGAL_FORJU | string |
| LEGAL/LEGAL_NAF | string |
| LEGAL/LEGAL_ETAB_ETAT | establishment_state |
| LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_SIEGE | establishment |
| LEGAL/LEGAL_ADRESSE/LEGAL_ADRESSE_ETAB_SEC | establishment |
| LEGAL/LEGAL_CAPITAL | share_capital |
| LEGAL/LEGAL_OBJET_SOCIAL | string |
| RISK/RISK_SCORE | company_risk |
| FINANCIAL/FINANCIAL_SALES | company_stats |
| FINANCIAL/FINANCIAL_STAFF | company_stats |
| PUBLICATIONS/ARTICLES_PRESSE/FUSION_ACQUISITION | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/ACTUALITE_FINANCIERES | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/RECRUTEMENT | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/NOMINATIONS | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/DEVELOPPEMENT | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/INVESTISSEMENT_PROD | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/ORGANISATION_RATIONALISATION | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/SINISTRES | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/ACTUALITE_SOCIALES | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/SALONS_FORUMS | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/OPERATION_RENOVATION | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/MOUVEMENTS | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/PROCEDURES_COLLECTIVES | press_article |
| PUBLICATIONS/ARTICLES_PRESSE/RECHERCHE_LOCAUX | press_article |
| PUBLICATIONS/BODACCA/PRESSE_BODACCA_CREATION | bodacc_event |
| PUBLICATIONS/BODACCA/PRESSE_BODACCA_VENTE | bodacc_event |
| PUBLICATIONS/BODACCB/PRESSE_BODACCB_MODIF_GEN | bodacc_event |
| PUBLICATIONS/BODACCB/PRESSE_BODACCB_RADIATION | bodacc_event |
| PUBLICATIONS/BODACCB/PRESSE_BODACCB_IMMAT | bodacc_event |
| PUBLICATIONS/BODACCC/PRESSE_BODACCC_PUBLI_FI | bodacc_event |
| PUBLICATIONS/BODACCA/PRESSE_BODACCA_JUGEMENT | bodacc_event |
| PUBLICATIONS/ACTES_STATUTS/JUGEMENTS | acte |
| PUBLICATIONS/ACTES_STATUTS/LIQUIDATIONS | acte |
| PUBLICATIONS/ACTES_STATUTS/CAPITAL_AUGMENTATION | acte |
| PUBLICATIONS/ACTES_STATUTS/CAPITAL_CONTINUATION | acte |
| PUBLICATIONS/ACTES_STATUTS/CAPITAL_RECONSTITUTION_ACTIF | acte |
| PUBLICATIONS/ACTES_STATUTS/CAPITAL_REDUCTION | acte |
| PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_CLOTURE | acte |
| PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_FORJU | acte |
| PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_OBJET_SOCIAL | acte |
| PUBLICATIONS/ACTES_STATUTS/CHANGEMENT_NOM | acte |
| PUBLICATIONS/ACTES_STATUTS/AVIS_NANTISSEMENT | acte |
| PUBLICATIONS/ACTES_STATUTS/APPORTS_ACTIFS | acte |
| PUBLICATIONS/ACTES_STATUTS/DECES | acte |
| PUBLICATIONS/ACTES_STATUTS/DISSOLUTIONS | acte |
| PUBLICATIONS/ACTES_STATUTS/MISES_SOMMEIL | acte |
| PUBLICATIONS/ACTES_STATUTS/ACTES | acte |
| PUBLICATIONS/ACTES_STATUTS/CESSIONS_PARTS | acte |
| PUBLICATIONS/ACTES_STATUTS/DECISIONS | acte |
| PUBLICATIONS/ACTES_STATUTS/DECLARATION_BE | acte |
| PUBLICATIONS/ACTES_STATUTS/FUSION | acte |
| PUBLICATIONS/ACTES_STATUTS/SCISSIONS | acte |
| PUBLICATIONS/ACTES_STATUTS/NOMINATIONS_DEMISSIONS | acte |
| PUBLICATIONS/ACTES_STATUTS/RAPPORTS | acte |
| PUBLICATIONS/ACTES_STATUTS/RAPPORTS_COMMISSAIRES | acte |
| PUBLICATIONS/ACTES_STATUTS/TRANSFERTS_SIEGE | acte |
| PUBLICATIONS/ACTES_STATUTS/UPDATE_STATUTS | acte |
| PUBLICATIONS/ACTES_STATUTS/PV_AG | acte |
| PUBLICATIONS/ACTES_STATUTS/DECLARATION_CONFORMITE | acte |
| PUBLICATIONS/ACTES_STATUTS/AFFECTATIONS_PATRIMOINE | acte |
| PUBLICATIONS/ACTES_STATUTS/ATTESTATIONS_FONDS | acte |
| PUBLICATIONS/ACTES_STATUTS/DIVERS | acte |
Liste des types d'objets de la surveillance
| gapType | exemple |
|---|---|
| string | { |
| establishment_state | { |
| establishment | { |
| share_capital | { |
| company_risk | { |
| company_stats | { |
| press_article | { |
| bodacc_event | { |
| acte | { |
Siren Store
curl -X 'GET' \
'https://societeinfo.com/app/rest/api/v2/stores/sirenstores/ma_sentinelle' \
-H "accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
La commande retourne le JSON suivant :
{
"success": true,
"status": 200,
"object": {
"totalSiren": 1,
"currentPage": 0,
"totalPage": 1,
"pageSize": 1,
"name": "ma_sentinelle",
"sirens": [
"830134383"
]
}
}
Un SirenStore correspond a une liste de SIREN stockée sur les serveurs de Societeinfo. Vous pouvez définir autant de SirenStore que vous le souhaitez, vous pouvez par exemple créer une liste pour :
- vos clients
- vos prospects
- vos partenaires
- ...
Puis décider de faire une surveillance :
- par mail + webhook pour vos clients.
- en webhook seulement pour vos prospects.
- Des mails envoyés à certaines personnes pour vos partenaires.
- ...
Par défaut, à chaque fois que vous créez une sentinelle, vous créez un SirenStore qui porte le même nom que votre sentinelle. C'est le SirenStore par défaut quand vous ajouter des SIREN à votre sentinelle.
Pour créer un SirenStore Lien swagger
Associez vos SirenStore et vos sentinelles Lien swagger
Pour plus d'infos sur la manière de modifier ou de supprimer des SirenStore, rendez-vous dans la section SirenStore de la documentation Swagger.
Events API
Get Events
Ce service retourne les événements stratégiques d'une entreprise recueillis à travers différents médias. Vous y trouverez différents sujets tels que les levées de fonds, les fusions & acquisitions, la prise de participation, les recrutements, l'actualité financière, les communiqués des entreprises, les nominations dans l'équipe de direction, etc.
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/events.json/<registration_number>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| registration_number | Non | Numéro SIREN ou SIRET de l'entreprise |
curl "https://societeinfo.com/app/rest/api/v2/events.json/83013438300017?key=DEMO"
La commande retourne le JSON suivant :
{
"success": false,
"result": {
"id": "652919194dd1ec1371c80147",
"organization": {
"status": "Active",
"risk": {
"risk_level": 0.0,
"risk_level_description": "Pas de risque identifié",
"collective_procedure_in_progress": false,
"collective_procedures": [],
"legal_source_organization_statuses": [
{
"source_name": "Bodacc",
"organization_status": "Active"
}
]
},
"creation_date": "2017-06-05",
"capital": "5102",
"registration_number": "830134383",
"full_registration_number": "83013438300017",
"vat_number": "FR38830134383",
"greffe_name": "Nanterre",
"name": "SMART DATA",
"activity": {
"ape_code": "6201Z",
"ape_code_level1": "JZ",
"ape_code_level2": "JC",
"ape_code_level3": "62",
"ape_code_level4": "J62Z",
"ape_code_level5": "6201Z",
"ape_name": "Programmation informatique",
"corporate_object": "La société a pour objet ..."
},
"legal": {
"name": "Société par actions simplifiée",
"code_level1": "5",
"code_level2": "57",
"code_level3": "5710",
"person_type": "LegalEntity",
"type": "Siege"
},
"address": {
"street": "176 AVENUE CHARLES DE GAULLE",
"postal_code": "92200",
"city": "NEUILLY-SUR-SEINE",
"country_code": "FR",
"country": "FRANCE",
"lng": 2.2697,
"lat": 48.8846
},
"last_legal_update_date": "2023-10-30",
"establishments_count": 0
},
"events": [
{
"code_sub_theme": "DCPN",
"news_delivery_date": "2021-09-13",
"article_publication_date": "2021-09-08",
"news_id": "36123608",
"article_id": "39665852",
"sub_theme_label": "Innovation, nouveaux marchés, contrats",
"main_full_registration_number": "83013438300017",
"secondary_companies": [],
"article_source": "Communiqué d'entreprise",
"news_summary": "SOCIETEINFO remporte l’appel d’offre de BPIFrance concernant l’alimentation de ...",
"theme": "Développement",
"article_title": "SOCIETEINFO remporte l’appel d’offre de BPIFrance ...",
"news_url": "https://societeinfo.com/blog/societeinfoxbpifrance"
},
{
"code_sub_theme": "FAPPM",
"news_delivery_date": "2021-03-29",
"article_publication_date": "2021-03-22",
"news_id": "34495436",
"article_id": "37974745",
"sub_theme_label": "Prise de participation minoritaire",
"main_full_registration_number": "83013438300017",
"secondary_companies": [
{
"id": "CompanyIdViewV2_518891395|51889139500015",
"registration_number": "518891395",
"full_registration_number": "51889139500015",
"corporate_name": "EXPLORE"
}
],
"article_source": "Communiqué d'entreprise",
"news_summary": "Communiqué de Presse EXPLORE s’associe à Societeinfo.com pour déployer des solutions innovantes ...",
"theme": "Fusion, acquisition, prise de participation",
"article_title": "Explore - Participation minoritaire au capital de la start-up Societeinfo.com"
},
{
"code_sub_theme": "RECR",
"news_delivery_date": "2021-01-11",
"article_publication_date": "2021-01-06",
"news_id": "33786387",
"article_id": "37217680",
"sub_theme_label": "Recrutement",
"main_full_registration_number": "83013438300017",
"secondary_companies": [],
"article_source": "Communiqué d'entreprise",
"news_summary": "Societeinfo recrute actuellement 1 développeur ...",
"theme": "Recrutement",
"article_title": "Societeinfo recherche 1 Développeur ..."
}
]
}
}
Extra API
Get Bodacc
curl "https://societeinfo.com/app/rest/api/v2/bodacc.json/342376332?key=DEMO"
La commande retourne le JSON suivant :
{
"success": true,
"result": [{
"type": "Bodacc",
"bodacc_type": "Modifications et mutations diverses",
"parution_date": "2008-07-08",
"number": "1716",
"rcs_name": "342376332 RCS paris",
"legal_name": "ILIAD",
"legal_status": "Société anonyme",
"capital": "12000000 EUR",
"administration": "modification de l'Administrateur Rozenfeld, Olivier",
"address": "8 rue de la Ville L'Évêque 75008 Paris",
"description": "modification survenue sur l'administration"
},
...
]
}
bundle exec middleman server
Ce service retourne l'ensemble des annonces légales du BODACC à partir d'un code SIREN
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/bodacc.json/<registration_number>?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API. | |
| registration_number | Non | Numéro SIREN de l'entreprise |
Autocomplete Place
curl "https://societeinfo.com/app/rest/api/v2/places.json/autocomplete?query=paris&key=DEMO"
La commande retourne le JSON suivant :
{
"success":true,
"errorType":null,
"errorCode":null,
"errorMessage":null,
"total":5,
"page":0,
"views":[
{
"id":"587953dcb3a2b0645005d4de",
"first":"Paris",
"others":"Île-de-France, FRANCE",
"type":"administrative_area_level_2",
"sourceStatus":"Complete",
"formatedName":"Paris, Île-de-France, FRANCE"
},
{
"id":"587953d6b3a2b06450055d59",
"first":"Paris",
"others":"Paris, Île-de-France, FRANCE",
"type":"locality",
"sourceStatus":"Complete",
"formatedName":"Paris, Paris, Île-de-France, FRANCE"
},
...
]
}
Le service Place Autocomplete retourne des prédictions de lieu. La requête spécifie une chaîne de recherche. Le service permet de fournir la fonctionnalité de saisie semi-automatique pour les recherches géographiques textuelles et renvoie des adresses au fur et à mesure de la saisie par l'utilisateur (région, département, code postal, ville, rue)
HTTP Request
GET https://societeinfo.com/app/rest/api/v2/places.json/autocomplete?key=YOUR_APIKEY
URL Parameters
| Paramètre | Defaut | Optionnel | Description |
|---|---|---|---|
| key | Non | Votre clé d'API | |
| query | Non | Caractères spécifiés pour la recherche |
Errors
L'API utilise les codes standard HTTP suivants :
| Error Code | Description |
|---|---|
| 400 | Bad Request -- Requête invalide. |
| 401 | Unauthorized -- Clé API invalide. |
| 403 | Forbidden -- Accès non autorisé. |
| 404 | Not Found -- Entité non trouvé. |
| 429 | Too Many Requests -- Vous requêtez trop vite ! Ralentissez ! |
| 500 | Internal Server Error -- Nous avons un problème interne, Ré-exécuter plus tard. |
{
"success": false,
"errorType": "Functionnal",
"errorCode": "API_INVALID_KEY",
"errorMessage": "The api key is not found"
}
Les réponses en erreur inclue également un champs errorCode avec un niveau de détail plus fin. En voici quelques exemples :
| Error Code | Description |
|---|---|
| API_COMPANY_NOT_FOUND | La société n'a pas été trouvée. |
| API_CONTACT_NOT_FOUND | Le contact n'a pas été trouvé |
| API_COMPANY_ANONYMIZED | Le propriétaire de la société a demandé son anonymisation |
| API_COMPANY_QUERY_MIN_LENGTH | La taille de la query doit être supérieure à deux |
| API_CONTACT_UNAUTHORIZED | L'accès à l'API est limité aux comptes payants |
| API_INVALID_KEY | La clé d'API est invalide. |
| API_UNDEFINED_KEY | La clé d'API n'est pas renseignée |
| API_MAX_MATCH_EXCEEDED | Les crédits de la clé d'API sont épuisés. |
| API_INVALID_PAGE | La page demandée n'existe pas. |
| USER_COMPANY_EXPIRED | Le compte est expiré, la carte de crédit a été refusée |