Credits


En fonction de votre formule, vous disposez d'un stock de crédits mensuel. Chaque requête réussie consomme un ou plusieurs crédits Le coût en crédits de chaque opération est défini dans la documentation ci-dessous.


Gestion d'erreur


{ "success": false, "errorType": "Functionnal", "errorCode": "API_INVALID_KEY", "errorMessage": "The api key is invalid" }

Le champ "success" prend la valeur "true" si la requête s'est correctement déroulée. Dans le cas contraire, le champ "success" prend la valeur "false" et un code d'erreur est retourné dans le champ "errorCode". Voici les différents codes d'erreur que vous pourrez rencontrer :

  • API_COMPANY_NOT_FOUND La société n'a pas été trouvée
  • API_INVALID_KEY La clé d'API est invalide
  • 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



Consulter sa consommation







{ "success": true, "result": { "companyName": "SMART DATA", "productName": "Business", "consumedCredits": 12457, "maxCredits": 50000, "extraCredits": 50000, "consumedExtraCredits": 0, "totalAvailableCredits": 87543 } }

Ce service permet de consulter vos crédits disponibles.

https://societeinfo.com/app/rest/api/v1/apikeyinfo/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètre obligatoire

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard




Rechercher des sociétés par mots clés 1 CREDIT





{ "success":true, "total":6423, "currentPage":1, "totalPages":643, "searchMode":"keyword", "sorts":[ "score" ], "result":[ { "id":"59325baab3a258592ea0f216", "registration_number":"830015210", "full_registration_number":"83001521000016", "legal_type":"Siege", "name":"LANSROD BIG DATA", "activity":"Conseil en systèmes et logiciels informatiques", "formatted_address":"75008 Paris", "lng":2.3183, "lat":48.8763 }, { "id":"58796e94b3a2806717cd9ce8", "registration_number":"537750077", "full_registration_number":"53775007700027", "legal_type":"Siege", "name":"BIG DATA SERVICES", "activity":"Conseil en systèmes et logiciels informatiques", "formatted_address":"92200 Neuilly-sur-Seine", "lng":2.2695658, "lat":48.884683 } ... ] }

Ce service permet la recherche par nom ou mots clés et lieu sur l'ensemble de notre base. Ajustez le paramètre searchMode si vous souhaitez effectuer une recherche sémantique avec des opérateurs booléens.
Le service renvoie une vue synthétique des sociétés (nom, activité, adresse formatée, géolocation).
Pour obtenir les informations détaillées de l'entreprise, utilisez ensuite le service de recherche par ID

https://societeinfo.com/app/rest/api/v1/querysearch/companies/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètres obligatoires

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard
  • page (1 par défaut) - Numéro de la page de résultats
  • limit (10 par défaut) - Nombre de résultats par page. Limité à 25.

Paramètres facultatifs

  • query - Termes spécifiés pour la recherche
  • searchMode - Spécifie le type de recherche exécutée. Les valeurs possibles sont les suivantes :
    • legalname (par défaut) Limite la recherche à la raison social des entreprises.
    • keyword Exécute une recherche sémantique sur tous les contenus texte associé à l'entreprise (sources légales, code APE, sites web, réseaux sociaux...). Supporte les opérateurs booléens AND, OR, NOT
    • person Limite la recherche aux noms des dirigeants des entreprises.
    • name Limite la recherche aux noms (dénomination, nom commercial, sigle) et marques des entreprises.
    • auto Exécute une recherche 'legalname', puis une recherche 'keyword' si le score de la recherche 'legalname' est insuffisant.
  • placeId - Identifiant qui identifie un lieu de manière unique. L'identifiant est une sélection utilisateur du service Autocomplete. Ajoutez ce paramètre pour limiter les résultats à la zone géographique de la place.
  • where (deprecated utiliser placeId) - Ajoutez ce paramètre pour limiter les résultats au code postal ou à la ville définie
  • nafLevel - Ajoutez ce paramètre pour limiter les résultats aux entreprises appartenant aux éléments de la codification NAF définis.
    Exemple : nafLevel=61&nafLevel=6201Z
  • active (true par défaut) - Ajoutez ce paramètre pour limiter les résultats aux entreprises actives. Les valeurs possibles sont true ou false
  • withEstablishments (false par défaut) - Ajoutez ce paramètre pour inclure les établissements dans les résultats de recherche. Les valeurs possibles sont true ou false
  • minsales et maxsales - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette de chiffre d'affaire définie.
  • minprofits et maxprofits - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette de bénéfices définie.
  • minstaff et maxstaff - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette d'effectif définie.
  • mincreationdate et maxcreationdate - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette de date de création. (format YYYYMMDD)
  • withsite - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un site web identifié. Les valeurs possibles sont true ou false
  • withphone - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un téléphone identifié. Les valeurs possibles sont true ou false
  • withemail - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un mail identifié. Les valeurs possibles sont true ou false
  • withtwitter - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un compte twitter identifié. Les valeurs possibles sont true ou false
  • mintwitterfollowers - Ajoutez ce paramètre pour limiter les résultats aux entreprises dont l'un des comptes twitter a pour minimum le nombre d'abonnés défini.
  • mintwitterfriends - Ajoutez ce paramètre pour limiter les résultats aux entreprises dont l'un des comptes twitter a pour minimum le nombre d'abonnements défini.
  • sort - Ajoutez ce paramètre pour trier les résultats. Les valeurs possibles sont les suivantes :
    • score (par défaut) 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





Rechercher une société par SIREN/SIRET 5 CREDITS





{ "success": true, "result": { "id": "55f17734b3a2d5ccd3e9f937", "registration_number": "342376332", "full_registration_number": "34237633200082", "vat_number": "FR82342376332", "name": "ILIAD", "commercial_name": "FERMIC - ILIAD ENTREPRISE", "postal_address_additional_name": "ILIAD ENTREPRISE", "ape_code": "7010Z", "ape_code_level1": "MN", "ape_code_level2": "MA", "ape_code_level3": "70", "ape_code_level4": "M70Z", "ape_code_level5": "7010Z", "ape_label": "Activités des sièges sociaux", "rcs_name": "342376332 RCS Paris", "greffe_name": "Paris", "legal_person_type": "Natural", "legal_state": "Active", "legal_state_date": 561250800000, "legal_type": "Siege", "legal_status": "Société anonyme", "creation_date": 561250800000, "activity": "Diffusion et édition de toutes informations et services opérations de holding", "street": "16 RUE DE LA VILLE L EVEQUE", "postal_code": "75008", "city": "Paris", "country_code": "FR", "capital": "12999215", "lng": 2.3522219, "lat": 48.856614, "email": "presse@iliad.fr", "emails": [ "presse@iliad.fr" ], "website_url": "http://www.iliad.fr/", "phone_number": "01 73 50 27 07", "contacts": [{ "name": "Alexis Bidinot", "birth_date": 552434400000, "role": "Directeur général délégué", "role_start_date": 1519858800000, "company": false }, ... ], "last_sales": 157434000, "last_profit": 307980000, "last_staff": 100, "stats": [ { "type": "sales", "year": 2016, "value": "157434000" }, ... ], "marks_details": { "marks": [ { "name": "GIGABOX", "application_date": 1160431200000 }, { "name": "OPTICBOX", "application_date": 1160431200000 } ... ] }, "lastBodacc": { "type": "Bodacc", "bodacc_type": "Modifications et mutations diverses", "parution_date": 1469656800000, ... }, "risk": { "risk_level": 0.0, "collective_procedure_in_progress": false }, "establishments_count": 2 } }

Ce service permet d'obtenir les informations détaillées d'une société (données légales, chiffres clés, dirigeants, mails, sites webs, réseaux sociaux, marques déposées...)
Si le paramètre registration_number est le SIREN, la réponse est le siège
Si le paramètre registration_number est le SIRET, la réponse est l'établissement

https://societeinfo.com/app/rest/api/v1/company/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètre obligatoire

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard

Paramètre obligatoire (l'un ou l'autre)

  • registration_number - Numéro SIREN/SIRET de l'entreprise
  • id - id obtenu à partir d'une requête query search (plus rapide !)

Paramètres facultatifs

  • withEstablishments (false par défaut) - Ajoutez ce paramètre pour inclure les établissements du siège. Les valeurs possibles sont true ou false

Dans la réponse, les valeurs possibles des champs suivants sont :

  • legal_state Active, Closing, Dead
  • legal_type Siege, PrincipalEstablishment, SecondaryEstablishment, ComplementaryEstablishment, Affiliate
  • legal_person_type Natural, Physical
  • stats.type clotureDate, sales, salesCategory, profit, staff
  • risk.collective_procedures.collective_procedure_type Liquidation judiciaire, Redressement judiciaire, Procédure de sauvegarde
  • lastBodacc.bodacc_type "Immatriculations", "Créations d'établissements", "Vente d'établissements", "Modifications et mutations diverses", "Radiations", "Avis de dépôts des comptes des sociétés", "Jugement"
  • si lastBodacc.bodacc_type = "Avis de dépôts des comptes des sociétés" lastBodacc.balance_sheet_deposit_type "Comptes annuels et rapports","Comptes consolidés et rapports", "Comptes annuels et consolidés et rapports"
























































Rechercher une société par nom de domaine 10 CREDITS





{ "success": true, "result": { "id": "593b6fa6b3a2feb79d4f9f39", "registration_number": "830134383", "full_registration_number": "83013438300017", "vat_number": "FR38830134383", "name": "SMART DATA", "ape_code": "4741Z", "ape_code_level1": "GZ", "ape_code_level2": "GZ", "ape_code_level3": "47", "ape_code_level4": "G47Z", "ape_code_level5": "4741Z", "ape_label": "Commerce de détail d'ordinateurs, d'unités périphériques et de logiciels en magasin spécialisé", "rcs_name": "830134383 RCS Nanterre", "greffe_name": "Nanterre", "legal_person_type": "Natural", "legal_state": "Active", "legal_state_date": 1496613600000, "legal_update_date": 1497218400000, "legal_type": "Siege", "legal_status": "SAS, société par actions simplifiée", "creation_date": 1496613600000, "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", "street": "176 AVENUE CHARLES DE GAULLE", "postal_code": "92200", "city": "Neuilly-sur-Seine", "country_code": "FR", "lng": 2.2593109, "lat": 48.8854852, "email": "contact@societeinfo.com", "emails": [ "contact@societeinfo.com", "antoine@societeinfo.com" ], "website_url": "http://www.societeinfo.com/", "twitter_url": "https://twitter.com/@SocieteInfo", "phone_numbers": [], "capital": "5000", "contacts": [ { "name": "Antoine ONNEN", "birth_date": 226537200000, "role": "Président", "role_start_date": 1496959200000, "company": false }, { "name": "Alexandre CONRAUD", "birth_date": 546127200000, "role": "Directeur général", "role_start_date": 1496959200000, "company": false } ], "stats": [ { "type": "staffCategory", "year": 2017, "value": "0 salarié" } ], "lastBodacc": { "type": "Bodacc", "bodacc_type": "Créations d'établissements", ... }, "actes": [ { "date": 1496959200000, "type": "Statuts constitutifs", "description": "Déposé" } ], "risk": { "risk_level": 0, "collective_procedure_in_progress": false, "collective_procedures": [] }, "establishments_count": 0 }, "webSiteInfo": { "domain": "societeinfo.com", "website_url": "http://www.societeinfo.com/", "description": "Accédez facilement à des millions de fiches d'entreprises françaises et dopez votre prospection BtoB. Email, données financières et légales, contacts grâce à nos API d'entrprises", "host_ip": "62.210.250.190", "host_name": "societeinfo.com", "host_country": "France", "url_legal": "https://societeinfo.com/mentions-legales/", "techno_types": [ "nginx", "php", "wordpress", "piwik", "xmlrpc", "yoastseo" ] }, "match_info": { "score": 1, } }

Utiliser ce service pour identifier la société propriétaire du domaine ou éditrice du site web spécifié. Si un email est spécifié, le service effectuera une recherche sur le nom de domaine de l'email.

https://societeinfo.com/app/rest/api/v1/domainsearch/companies/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètres obligatoires

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard
  • domain_name - Le domaine / l'url du site web / L'email à analyser

Paramètres facultatifs

  • withEstablishments (false par défaut) - Ajoutez ce paramètre pour inclure les établissements du siège. Les valeurs possibles sont true ou false

Dans la réponse, les valeurs possibles des champs suivants sont :

  • legal_state Active, Closing, Dead
  • legal_type Siege, PrincipalEstablishment, SecondaryEstablishment, ComplementaryEstablishment, Affiliate
  • legal_person_type Natural, Physical
  • stats.type clotureDate, sales, salesCategory, profit, staff
  • risk.collective_procedures.collective_procedure_type Liquidation judiciaire, Redressement judiciaire, Procédure de sauvegarde
  • lastBodacc.bodacc_type "Immatriculations", "Créations d'établissements", "Vente d'établissements", "Modifications et mutations diverses", "Radiations", "Avis de dépôts des comptes des sociétés", "Jugement"
  • si lastBodacc.bodacc_type = "Avis de dépôts des comptes des sociétés" lastBodacc.balance_sheet_deposit_type "Comptes annuels et rapports","Comptes consolidés et rapports", "Comptes annuels et consolidés et rapports"












































































{ "success": false, "errorType": "Functionnal", "errorCode": "API_COMPANY_NOT_FOUND", "errorMessage": "The company is not found", "request_domain_name": "trumphotels.org", "result": [] }























Contacts / Emails entreprises 20 CREDITS





{ "success":true, "company":{ "id":"58797115b3a2806717d8e0a7", "registration_number":"789120649", "full_registration_number":"78912064900031", "legal_type":"Siege", "name":"TILKEE", "activity":"Edition de logiciel.", "formatted_address":"13 RUE BURDEAU 69001 Lyon" }, "email_patterns":[ { "domain":"tilkee.fr", "pattern":"{first}" }, { "domain":"tilkee.com" }, { "domain":"jeprospecte.com" } ], "contacts":[ { "firstName":"Sylvain", "lastName":"TILLON", "role":"Directeur général", "email":"sylvain@tilkee.fr", "email_score":84 }, { "firstName":"Timothée", "lastName":"SAUMET", "role":"‎cto & co-founder", "email":"timothee@tilkee.fr", "email_score":22, "linkedin_url":"https://fr.linkedin.com/in/timsaumet/fr" }, ... ], "emails":[ { "value":"sylvain@tilkee.fr", "type":"personal", "sources": [ { "url": "https://fr.slideshare.net/sylvaintillon/dossier-depressetilkee" }, { "url": "www.pertinence-invest.com/IMG/pdf/cp_tilkee_vdef.pdf" }, { "url": "www.medeflyonrhone.fr/wp-content/uploads/2014/03/livret-présentation.pdf" } ] }, { "value":"support@tilkee.com", "type":"generic", "sources":[ { "url":"https://chrome.google.com/webstore/detail/tilkee-for-gmail/hdnfcpjnbaelecfgjaebambpofifhhgg?hl=fr" } ] }, { "value":"contact@tilkee.com", "type":"generic", "sources":[ { "url":"https://apkmeet.com/fr/apk/784065-com.soluti.tilkee.tilkeemobile" } ] }, ... ] }

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

https://societeinfo.com/app/rest/api/v1/contacts/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètre obligatoire

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard

Paramètre obligatoire (l'un ou l'autre)

  • registration_number - Numéro SIREN de l'entreprise
  • domain_name - Le nom de domaine, l'algorithme doit nécessairement détecter la société propriétaire du domaine.

Paramètres facultatifs

  • domain_search_mode
    • requested_domain (mode par défaut pour la recherche par domaine) Limite les domaines mail retournés au domaine_name spécifié.
    • auto (mode par défaut pour la recherche par SIREN) Etends la détection de domaine mail à tous les domaines possédés par la société. Utiliser ce mode quand le domaine_name spécifié est un site web.

Informations sur la réponse

  • company - Informations légales sur l'entreprise
  • email_patterns - Les domaines et patterns d'emails détectés
  • contacts - Les mandataires légaux et employés de l'entreprise
  • contacts.email_score - Notre estimation de la probabilité que l'email retourné est correct.
  • emails - Les emails détectés sur le web dont les domaines matchent avec les domaines détenus par l'entreprise
  • emails.type - Retourne la valeur "personal" ou "generic"


Si aucun employé OU aucun email pertinent n'est détecté une erreur API_CONTACT_NOT_FOUND est retournée et aucun crédit n'est alors consommé

















































{ "success": false, "errorType": "Functionnal", "errorCode": "API_COMPANY_NOT_FOUND", "errorMessage": "The company is not found" }







{ "success": false, "errorType": "Functionnal", "errorCode": "API_CONTACT_NOT_FOUND", "errorMessage": "No emails or contacts found" }











Enrichissement d'entreprise / sirénisation 10 CREDITS





{ "success": true, "result": { "id": "593b6fa6b3a2feb79d4f9f39", "registration_number": "830134383", "full_registration_number": "83013438300017", "vat_number": "FR38830134383", "name": "SMART DATA", "ape_code": "4741Z", "ape_code_level1": "GZ", "ape_code_level2": "GZ", "ape_code_level3": "47", "ape_code_level4": "G47Z", "ape_code_level5": "4741Z", "ape_label": "Commerce de détail d'ordinateurs, d'unités périphériques et de logiciels en magasin spécialisé", "rcs_name": "830134383 RCS Nanterre", "greffe_name": "Nanterre", "legal_person_type": "Natural", "legal_state": "Active", "legal_state_date": 1496613600000, "legal_update_date": 1497218400000, "legal_type": "Siege", "legal_status": "SAS, société par actions simplifiée", "creation_date": 1496613600000, "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", "street": "176 AVENUE CHARLES DE GAULLE", "postal_code": "92200", "city": "Neuilly-sur-Seine", "country_code": "FR", "lng": 2.2593109, "lat": 48.8854852, "email": "contact@societeinfo.com", "emails": [ "contact@societeinfo.com", "antoine@societeinfo.com" ], "website_url": "http://www.societeinfo.com/", "twitter_url": "https://twitter.com/@SocieteInfo", "phone_numbers": [], "capital": "5000", "contacts": [ { "name": "Antoine ONNEN", "birth_date": 226537200000, "role": "Président", "role_start_date": 1496959200000, "company": false }, { "name": "Alexandre CONRAUD", "birth_date": 546127200000, "role": "Directeur général", "role_start_date": 1496959200000, "company": false } ], "stats": [ { "type": "staffCategory", "year": 2017, "value": "0 salarié" } ], "lastBodacc": { "type": "Bodacc", "bodacc_type": "Créations d'établissements", ... }, "actes": [ { "date": 1496959200000, "type": "Statuts constitutifs", "description": "Déposé" } ], "risk": { "risk_level": 0, "collective_procedure_in_progress": false, "collective_procedures": [] }, "establishments_count": 0 }, "match_info": { "score": 0.75, "sources": "Nom Adresse" } }

Ce service vous permet de procéder à toute sorte d'enrichissement / sirénisation. Spécifiez uniquement les datas donc vous disposez (nom, adresse, domaine email, site web). Et nos algos de matching feront le reste..

https://societeinfo.com/app/rest/api/v1/enrich/company/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètre obligatoire

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard


Paramètres facultatifs

  • registration_number - Numéro SIREN de l'entreprise
  • name - Nom de l'entreprise
  • street - Adresse de l'entreprise (numéro et voie)
  • street2 - Complément d'adresse
  • postal_code - Code postal
  • city - Ville
  • domain_name - Un nom de domaine de l'entreprise (domaine mail, site web..)





































































{ "success": false, "errorType": "Functionnal", "errorCode": "API_COMPANY_NOT_FOUND", "errorMessage": "The company is not found" }







{ "success": false, "errorType": "Functionnal", "errorCode": "API_CONTACT_NOT_FOUND", "errorMessage": "No emails or contacts found" }











Etats financiers des entreprises 10 CREDITS





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

Ce service permet de récupérer les données des liasses fiscales déposées au greffe par les entreprises françaises. L’API renvoie les états financiers de tous les exercices disponibles. Seuls les sociétés déposant leurs comptes au greffe et n’ayant pas opté pour l’option de confidentialité sont disponibles.

https://societeinfo.com/app/rest/api/v1/financial/statements/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json Réponse au format JSON.
  • xml Réponse au format XML.

Paramètres obligatoires

  • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard
  • registration_number - Numéro SIREN de l'entreprise

  • Paramètres facultatifs

    • detailLevel - Ajoutez ce paramètre pour modifier le niveau de détail. Les valeurs possibles sont les suivantes :
      • Synthetic(par défaut) Renvoie les principaux agrégats comptables
      • FullRenvoie toutes les lignes disponibles dans la liasse fiscale
    • statement Les états financiers sont composés d’un bilan comptable et d’un compte de résultat. Par défaut l’API renvoie les deux.
      - Ajoutez ce paramètre pour limiter au bilan comptable / compte de résultat
      • BILAN(par défaut) Limite le résultat au bilan comptable
      • PNLLimite le résultat au compte de résultat
    • type Les comptes publiés par les entreprises françaises peuvent avoir différents formats :

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

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

      • Auto(par défaut) Renvoie les comptes consolidés si disponibles, si ce n’est pas le cas renvoie les comptes sociaux (Complets, Simplifiés, Banque ou Assurance)
      • SocialRenvoie les comptes sociaux (Complets, Simplifiés, Banque ou Assurance) même si les comptes consolidés sont disponibles
      • AllRenvoie tous les comptes disponibles. Exemple : Consolidés + Complets / Simplifiés









































































    { "success":false, "errorType":"Functionnal", "errorCode":"API_FINANCIAL_NOT_FOUND", "errorMessage":"Financial data not found" }







    { "success":false, "errorType":"Functionnal", "errorCode":"API_FINANCIAL_CONFIDENTIAL", "errorMessage":"Company has choose to make their financial data confidential. Data is not available" }











    Service d'Autocomplete géographique gratuit





    { "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 est un service qui renvoie 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)
    L'identifiant de place (placeId), doit être injecté dans le service Mots clés pour limiter la recherche d'entreprise à une zone géographique.

    https://societeinfo.com/app/rest/api/v1/placesearch/autocomplete/output?parameters

    output peut prendre l'une des valeurs suivantes :

    • json Réponse au format JSON.
    • xml Réponse au format XML.

    Paramètres obligatoires

    • key - Votre clé d'API. Vous pouvez la générer dans votre dashboard
    • query - Termes spécifiés pour la recherche

















    • Rechercher les annonces BODACC par SIREN/ID 5 CREDITS





      { "success": true, "result": [{ "type": "Bodacc", "bodacc_type": "Créations d'établissements", "parution_date": 1497564000000, "number": "1448", "rcs_name": "830134383 RCS Nanterre", "legal_name": "SMART DATA", "legal_status": "Société par actions simplifiée", "capital": "5000 EUR", "administration": "Président : ONNEN Antoine ; Directeur général : CONRAUD Alexandre", "address": "176 avenue Charles de Gaulle 92200 Neuilly-sur-Seine", "establishments": [{ "quality": "Etablissement principal", "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.", "funds_origin": "Création d'un fonds de commerce" }], "start_date": 1496613600000 }] }

      Obtenez l'ensemble des annonces légales du bodacc

      https://societeinfo.com/app/rest/api/v1/bodacc/output?parameters

      output peut prendre l'une des valeurs suivantes :

      • json Réponse au format JSON.
      • xml Réponse au format XML.

      Paramètre obligatoire

      • key -Votre clé d'API. Vous pouvez la générer dans votre dashboard

      Paramètre obligatoire (l'un ou l'autre)

      • registration_number - Numéro SIREN de l'entreprise
      • id - id obtenu à partir d'une requête query search (plus rapide)

      Dans la réponse, les valeurs possibles des champs suivants sont :

      • bodacc_type "Immatriculations", "Créations d'établissements", "Vente d'établissements", "Modifications et mutations diverses", "Radiations", "Avis de dépôts des comptes des sociétés", "Jugement"
      • si bodacc_type = "Avis de dépôts des comptes des sociétés" balance_sheet_deposit_type "Comptes annuels et rapports","Comptes consolidés et rapports", "Comptes annuels et consolidés et rapports"




























      Si la société n'existe pas ou le siren invalide cette erreur est retournée :

      { "success":false, "errorType":"Functionnal", "errorCode":"API_COMPANY_NOT_FOUND", "errorMessage":"The company is not found" }