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


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

Exemple d'erreur

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


Consulter sa consommation


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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètre obligatoire

  • key — Clé d'API

Exemple

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


Rechercher des sociétés par mots clés  1 crédit/requête


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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.
  • 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

Exemple

{ "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 }, { "id":"5879733fb3a2806717e2c4a7", "registration_number":"800295420", "full_registration_number":"80029542000015", "legal_type":"Siege", "name":"SMART BIG DATA HUB", "activity":"Conseil en systèmes et logiciels informatiques", "formatted_address":"95530 La Frette-sur-Seine" }, { "id":"587971e5b3a2806717dc8d02", "registration_number":"792640112", "full_registration_number":"79264011200019", "legal_type":"Siege", "name":"BIG DATA FREE SPIRIT", "activity":"Activités des sièges sociaux", "formatted_address":"29800 Landerneau" }, { "id":"58797601b3a2806717ef4055", "registration_number":"812623825", "full_registration_number":"81262382500013", "legal_type":"Siege", "name":"BIG SISTER DATA", "activity":"Activités de pré-presse", "formatted_address":"75018 Paris", "lng":2.3444, "lat":48.8925 }, { "id":"58797909b3a2806717fd38bb", "registration_number":"824146146", "full_registration_number":"82414614600017", "legal_type":"Siege", "name":"STEAM BEAM BIG DATA", "activity":"Programmation informatique", "formatted_address":"94420 Le Plessis-Trévise" }, { "id":"5a0bccc9b3a27ee3380fdef2", "registration_number":"833267057", "full_registration_number":"83326705700010", "legal_type":"Siege", "name":"BIG DATA CONSEIL", "activity":"Conseil en systèmes et logiciels informatiques", "formatted_address":"78800 Houilles" }, { "id":"597ab7a9b3a292d28d5a4bfb", "registration_number":"831151840", "full_registration_number":"83115184000012", "legal_type":"Siege", "name":"PERSONAL BIG DATA OY", "activity":"Services administratifs combinés de bureau", "formatted_address":"00520 helsinki" }, { "id":"59cb22ddb3a26f1940f94ade", "registration_number":"832207328", "full_registration_number":"83220732800010", "legal_type":"Siege", "name":"BIG DATA FUTURE", "activity":"Conseil en systèmes et logiciels informatiques", "formatted_address":"92320 Châtillon" }, { "id":"587972b0b3a2806717e01f35", "registration_number":"797941267", "full_registration_number":"79794126700016", "legal_type":"Siege", "name":"ZART BIG DATA", "activity":"Edition de logiciels applicatifs", "formatted_address":"84120 Pertuis" } ] }


Rechercher une société par SIREN/SIRET/ID   5 crédits/requête


Ce service permet d'obtenir les informations détaillées d'une société (données légales, chiffres clés, contacts, 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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètre obligatoire

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.

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"

Exemple

{ "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'Évêque", "postal_code": "75008", "city": "Paris", "country_code": "FR", "lng": 2.3522219, "lat": 48.856614, "email": "presse@iliad.fr", "emails": [ "presse@iliad.fr" ], "website_url": "http://www.iliad.fr/", "website_urls": [], "capital": "12999215", "contacts": [{ "name": "DELOITTE & ASSOCIES", "role": "Commissaire aux comptes titulaire" }, { "name": "BEAS", "role": "Commissaire aux comptes suppléant" }], "oldContacts": [{ "name": "Brunel Franck Georges Pierre", "role": "Directeur général" }, { "name": "DELOITTE & ASSOCIES", "role": "Commissaire aux comptes titulaire" }, { "name": "BEAS", "role": "Commissaire aux comptes suppléant" }], "last_sales": 143070000, "last_profit": 334957000, "last_staff": 100, "stats": [{ "type": "sales", "year": 2013, "value": "26562000" }, { "type": "sales", "year": 2011, "value": "27249000" }, { "type": "profit", "year": 2013, "value": "434233000" }, { "type": "profit", "year": 2011, "value": "329751000" }, { "type": "staff", "year": 2013, "value": "65" }, { "type": "salesCategory", "year": 2013, "value": "E + d 1M" }, { "type": "salesCategory", "year": 2011, "value": "E + d'1M" }, { "type": "sales", "year": 2014, "value": "120506000" }, { "type": "profit", "year": 2014, "value": "307980000" }, { "type": "staff", "year": 2014, "value": "103" }, { "type": "salesCategory", "year": 2014, "value": "E + d 1M" }, { "type": "clotureDate", "year": 2015, "value": "2015-12-31" }, { "type": "clotureDate", "year": 2014, "value": "2014-12-31" }, { "type": "clotureDate", "year": 2013, "value": "2013-12-31" }, { "type": "sales", "year": 2015, "value": "143070000" }, { "type": "profit", "year": 2015, "value": "334957000" }, { "type": "staff", "year": 2015, "value": "100" }, { "type": "staffCategory", "year": 2015, "value": "100 à 199 salariés" }], "marks_details": { "classes": [{ "number": "0", "description": "Communications.Agence de presse et d'informations.Communications radiophoniques, télégraphiques ou téléphoniques.Télescription.Transmission de messages, télégrammes.Services télématiques.Services divers.Hôtellerie, restauration.Maisons de repos et de convalescence.Pouponnières.Accompagnement en société.Agences matrimoniales.Salons de beauté, de coiffure.Pompes funèbres, fours crématoires.Réservation de chambres d'hôtel pour voyageurs.Travaux d'ingénieurs, consultations professionnelles et établissement de plans sans rapport avec la conduite des affaires.Travaux du génie (pas pour la construction).Prospection.Forages.Essais de matériaux.Laboratoires.Location de matériel pour exploitation agricole, de vêtements, de literie, d'appareils distributeurs.Imprimerie.Messagerie télématique.Services de boîtes à lettres télématiques. Services télématiques." }, { "number": "9", "description": " Appareils téléphoniques y compris fils, fibres et transmetteurs téléphoniques terminaux de télécommunication, appareils et postes téléphoniques notamment de caractère public ou personnel ou portatif ou à main libre ou à commande vocale ; récepteurs, émetteurs téléphoniques ; télécopieurs ; logiciels notamment logiciels pour le traitement de l'information, logiciels de création, de gestion, de mise a jour et d'utilisation de base de donnes, logiciels de fourniture d'accès à un service de messagerie électronique ; appareils de saisies de données, de sons et d'images ; ordinateurs notamment serveurs informatiques, terminaux informatiques, télématique et téléphoniques notamment pour les réseaux de communication mondiale (de type Internet) ; modems, connecteurs à un réseau informatique ou téléphonique, câbles électriques ou optiques base de données ; appareils émetteurs et récepteurs informatiques et de communication ; commutateurs téléphoniques, logiciels pour la fourniture d'accès à un réseau informatique ou de transmission de données notamment à un réseau de type communication mondiale (de type Internet)." }, { "number": "35", "description": " Publicité, gestion des affaires commerciales abonnement téléphonique, télématiques, à une base de données, à un serveur de bases de données, abonnement à un centre fournisseur d'accès à un réseau informatique ou de transmission de données notamment de communication mondiale (de type Internet) ; abonnement à des journaux électroniques, à un service de télécommunication. Gestion de fichiers informatiques." }, { "number": "38", "description": " Transmission d'informations par voie télématique, services téléphoniques, de télécommunication et de radiocommunication, de radiotéléphonie mobile, notamment services de transfert d'appels, de renvois d'appels, d'annuaires du téléphone, de messagerie vocale, transmission et diffusions de données, de sons et d'images, transmission et diffusions de données, de sons et d'images assistées par ordinateur notamment dans le cadre de réunions par téléphone et de visio-conférences, services de communication entre terminaux d'ordinateurs services d'accès à des bases de données et à des centres serveurs de base de données informatiques ou télématiques ; services de courrier électronique et de diffusion d'information par voie électronique notamment pour les réseaux de communication mondiale (de type Internet)." }, { "number": "41", "description": " Services de location d'appareils pour l'enregistrement, la transmission, la reproduction et le traitement de données, de sons et d'images agences de presse et d'informations. Télécommunication par tous moyens technologiques y compris par satellite ou par fibres optiques." }, { "number": "42", "description": " Location de temps d'accès à un centre serveur de bases de données notamment pour les réseaux de communication mondiale de type Internet, programmation pour ordinateurs." }], "marks": [{ "name": "SANDRA", "application_date": 545004000000 }, { "name": "GIGABOX", "application_date": 1160431200000 }, { "name": "OPTICBOX", "application_date": 1160431200000 }, { "name": "FIBERBOX", "application_date": 1160431200000 }, { "name": "CLUBA", "application_date": 558309600000 }, { "name": "ROSA", "application_date": 558309600000 }, { "name": "WWW BOURSE", "application_date": 815612400000 }, { "name": "BOURSE", "application_date": 816562800000 }, { "name": "ANNU", "application_date": 854578800000 }, { "name": "SALANGA", "application_date": 951951600000 }, { "name": "CIV", "application_date": 885942000000 }, { "name": "L'ANNUAIRE A L'ENVERS", "application_date": 886546800000 }, { "name": "WWW.DIR.COM", "application_date": 886633200000 }, { "name": "LA PAGE INVERSE", "application_date": 887324400000 }, { "name": "VL SHOW", "application_date": 890175600000 }, { "name": "RETROUVEZ UNE PERSONNE A PARTIR DE SON SIMPLE NOM SUR LA FRANCE ENTIERE TAPEZ 3617 ANNU", "application_date": 893368800000 }, { "name": "UN NUMERO DE TELEPHONE SANS NOM NI ADRESSE TAPEZ 3617 ANNU", "application_date": 893368800000 }, { "name": "RETROUVEZ UNE PERSONNE SUR LA FRANCE ENTIERE A PARTIR DE SON SIMPLE NUMERO DE TELEPHONE TAPEZ 3617 ANNU", "application_date": 893368800000 }, { "name": "EUROASIA", "application_date": 1049839200000 }, { "name": "INTER", "application_date": 901576800000 }, { "name": "AVANTI", "application_date": 907020000000 }, { "name": "VINCI", "application_date": 908748000000 }, { "name": "ILIAD", "application_date": 909615600000 }, { "name": "I-COMMERCE", "application_date": 913071600000 }, { "name": "DIR", "application_date": 913590000000 }, { "name": "ONE TO ONE", "application_date": 913762800000 }, { "name": "PROXAD", "application_date": 918774000000 }, { "name": "LINX TELECOM", "application_date": 921106800000 }, { "name": "Le National au prix du Local.", "application_date": 936914400000 }, { "name": "PROTELCO", "application_date": 1233615600000 }, { "name": "DOROTHY", "application_date": 719622000000 }] }, "lastBodacc": { "type": "Bodacc", "bodacc_type": "Modifications et mutations diverses", "parution_date": 1469656800000, "number": "1108", "rcs_name": "342376332 RCS Paris", "legal_name": "ILIAD", "legal_status": "Société anonyme", "capital": "12999215", "administration": "nomination de l'Administrateur : Vigreux, Corinne", "address": "16 rue de la Ville L'Évêque 75008 Paris", "description": "modification survenue sur l'administration" }, "risk": { "risk_level": 0.0, "collective_procedure_in_progress": false }, "establishments_count": 2 } }

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


Rechercher une société par nom de domaine / Email  10 crédits/requête


Utiliser ce service pour identifier la société propriétaire du domaine ou éditrice du site web spécifié. Si un émail 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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.
  • 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"

Exemple

{ "success": true, "total": 1, "result": [{ "id": "5944b106b3a2f5ecd3658211", "match_type": "WebSiteLegalNoticeOwnerMatch", "registration_number": "830134383", "full_registration_number": "83013438300017", "vat_number": "FR38830134383", "name": "SMART DATA", "ape_code": "6201Z", "ape_code_level1": "JZ", "ape_code_level2": "JC", "ape_code_level3": "62", "ape_code_level4": "J62Z", "ape_code_level5": "6201Z", "ape_label": "Programmation informatique", "rcs_name": "830134383 RCS Nanterre", "greffe_name": "Nanterre", "legal_person_type": "Natural", "legal_state": "Active", "legal_state_date": 1496613600000, "legal_type": "Siege", "legal_status": "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", "email": "contact@societeinfo.com", "emails": ["contact@societeinfo.com"], "website_url": "http://www.societeinfo.com/", "website_urls": [], "twitter_url": "https://twitter.com/@SocieteInfo", "twitter_urls": [], "phone_numbers": [], "capital": "5000", "contacts": [{ "name": "ONNEN Antoine ", "role": "Président" }, { "name": "CONRAUD Alexandre", "role": "Directeur général" }], "last_sales": 0, "last_profit": 0, "last_staff": 0, "stats": [{ "type": "staffCategory", "year": 2017, "value": "0 salarié" }], "lastBodacc": { "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 }, "risk": { "risk_level": 0.0, "collective_procedure_in_progress": false, "collective_procedures": [] }, "establishments_count": 0 }], "webSiteInfo": { "website_url": "http://www.societeinfo.com/", "description": "Societeinfo est un moteur de recherche B2B intégrant plus de 9 millions d'entreprises, des millions d'emails et numéros de téléphones. Dopez votre prospection commerciale, générez des leads ou enrichissez vos données !", "twitter_url": "https://twitter.com/@societeinfo" } }

Si la société n'est pas matchée :

{ "success": false, "errorType": "Functionnal", "errorCode": "API_COMPANY_NOT_FOUND", "errorMessage": "The company is not found", "result": [], "webSiteInfo": { "website_url": "http://www.lespepitestech.com/", "description": "Les Pepites Tech, les produits et services des startups de la French Tech, tous les jours. Le product hunt de la French Tech.", "facebook_url": "https://www.facebook.com/lespepitestech", "twitter_url": "https://twitter.com/lespepitestech" } }


Etats financiers des entreprises  10 crédits/requête


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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie
  • 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

Exemple

{ "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 }, { "code":"IMMOS_FIN", "label":"Immobilisations financières", "total":true }, { "code":"IMMOS_NETTES", "label":"Immobilisations nettes", "total":true }, { "code":"TOTAL_STOCKS", "label":"Stocks", "total":true }, { "code":"TOTAL_CREANCES", "label":"Créances", "total":true }, { "code":"TOTAL_TRESO", "label":"Trésorerie", "total":true }, { "code":"COMPTES_REGUL_ACTIF", "label":"Comptes de régularisation", "total":true }, { "code":"TOTAL_ACTIF", "label":"TOTAL ACTIF", "total":true }, { "code":"CAPITAUX_PROPRES", "label":"Capitaux propres", "total":true }, { "code":"QUASI_CAPITAUX_PROPRES", "label":"Quasi capitaux propres", "total":true }, { "code":"PRC", "label":"Provisions pour risques et charges", "total":true }, { "code":"TOTAL_DETTES_FI", "label":"Dettes financières", "total":true }, { "code":"TOTAL_DETTES_FRS", "label":"Dettes fournisseurs et fiscales", "total":true }, { "code":"COMPTES_REGUL_PASSIF", "label":"Comptes de régularisation passif", "total":true }, { "code":"TOTAL_PASSIF", "label":"TOTAL PASSIF", "total":true } ] }, "dates":[ { "closing_date":"2016-12-31", "duration_in_month":12, "rows":[ { "code":"IMMOS_INCORP", "value":31393000 }, { "code":"IMMOS_CORP", "value":101051000 }, { "code":"IMMOS_FIN", "value":340000 }, { "code":"IMMOS_NETTES", "value":133904000 }, { "code":"TOTAL_CREANCES", "value":73692000 }, { "code":"TOTAL_TRESO", "value":114307000 }, { "code":"COMPTES_REGUL_ACTIF", "value":7383000 }, { "code":"TOTAL_ACTIF", "value":424796000 }, { "code":"CAPITAUX_PROPRES", "value":360488000 }, { "code":"TOTAL_DETTES_FI", "value":928000 }, { "code":"TOTAL_DETTES_FRS", "value":50138000 }, { "code":"COMPTES_REGUL_PASSIF", "value":2199000 }, { "code":"TOTAL_PASSIF", "value":424796000 } ] }, { "closing_date":"2015-12-31", "rows":[ { "code":"IMMOS_INCORP", "value":35812000 }, { "code":"IMMOS_CORP", "value":100089000 }, { "code":"IMMOS_FIN", "value":523000 }, { "code":"IMMOS_NETTES", "value":137557000 }, { "code":"TOTAL_CREANCES", "value":74146000 }, { "code":"TOTAL_TRESO", "value":101217000 }, { "code":"COMPTES_REGUL_ACTIF", "value":8435000 }, { "code":"TOTAL_ACTIF", "value":412701000 }, { "code":"CAPITAUX_PROPRES", "value":347616000 }, { "code":"TOTAL_DETTES_FI", "value":1178000 }, { "code":"TOTAL_DETTES_FRS", "value":50014000 }, { "code":"COMPTES_REGUL_PASSIF", "value":2515000 }, { "code":"TOTAL_PASSIF", "value":412701000 } ] } ] }, { "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 }, { "code":"IMMOS_FIN", "label":"Immobilisations financières", "total":true }, { "code":"IMMOS_NETTES", "label":"Immobilisations nettes", "total":true }, { "code":"TOTAL_STOCKS", "label":"Stocks", "total":true }, { "code":"TOTAL_CREANCES", "label":"Créances", "total":true }, { "code":"TOTAL_TRESO", "label":"Trésorerie", "total":true }, { "code":"COMPTES_REGUL_ACTIF", "label":"Comptes de régularisation", "total":true }, { "code":"TOTAL_ACTIF", "label":"TOTAL ACTIF", "total":true }, { "code":"CAPITAUX_PROPRES", "label":"Capitaux propres", "total":true }, { "code":"QUASI_CAPITAUX_PROPRES", "label":"Quasi capitaux propres", "total":true }, { "code":"PRC", "label":"Provisions pour risques et charges", "total":true }, { "code":"DETTES_FIN", "label":"Dettes financières", "total":true }, { "code":"TOTAL_DETTES_FRS", "label":"Dettes fournisseurs et fiscales", "total":true }, { "code":"COMPTES_REGUL_PASSIF", "label":"Comptes de régularisation", "total":true }, { "code":"TOTAL_PASSIF", "label":"TOTAL PASSIF", "total":true } ] }, "dates":[ { "closing_date":"2016-12-31", "duration_in_month":12, "rows":[ { "code":"IMMOS_INCORP", "value":3904044 }, { "code":"IMMOS_CORP", "value":26126233 }, { "code":"IMMOS_FIN", "value":169016927 }, { "code":"IMMOS_NETTES", "value":199047204 }, { "code":"TOTAL_STOCKS", "value":27083374 }, { "code":"TOTAL_CREANCES", "value":92487611 }, { "code":"TOTAL_TRESO", "value":74751468 }, { "code":"COMPTES_REGUL_ACTIF", "value":1249092 }, { "code":"TOTAL_ACTIF", "value":394618749 }, { "code":"CAPITAUX_PROPRES", "value":365613203 }, { "code":"PRC", "value":2384840 }, { "code":"DETTES_FIN", "value":585841 }, { "code":"TOTAL_DETTES_FRS", "value":24446497 }, { "code":"COMPTES_REGUL_PASSIF", "value":92297 }, { "code":"TOTAL_PASSIF", "value":394618749 } ] }, { "closing_date":"2015-12-31", "rows":[ { "code":"IMMOS_INCORP", "value":4218986 }, { "code":"IMMOS_CORP", "value":25243232 }, { "code":"IMMOS_FIN", "value":182822062 }, { "code":"IMMOS_NETTES", "value":212284280 }, { "code":"TOTAL_STOCKS", "value":27300724 }, { "code":"TOTAL_CREANCES", "value":82808847 }, { "code":"TOTAL_TRESO", "value":57870787 }, { "code":"COMPTES_REGUL_ACTIF", "value":1094824 }, { "code":"TOTAL_ACTIF", "value":381359462 }, { "code":"CAPITAUX_PROPRES", "value":353191574 }, { "code":"PRC", "value":2764797 }, { "code":"DETTES_FIN", "value":974968 }, { "code":"TOTAL_DETTES_FRS", "value":23083954 }, { "code":"TOTAL_PASSIF", "value":381359462 } ] } ] }, { "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 }, { "code":"AUTRES_PRODUITS_EXP", "label":"Autres produits d’exploitation ", "total":true }, { "code":"TOTAL_ACHATS", "label":"Achats ", "total":true }, { "code":"TOTAL_SALAIRES_CHARGES_EXT", "label":"Salaires et Charges externes ", "total":true }, { "code":"EBE", "label":"Excédent Brut d'Exploitation", "total":true }, { "code":"DAP", "label":"Dotations aux amortissements et provisions", "total":true }, { "code":"REX", "label":"Résultat d'Exploitation", "total":true }, { "code":"PRODUITS_FINANCIERS", "label":"Produits financiers", "total":true }, { "code":"CHARGES_FINANCIERES", "label":"Charges financières", "total":true }, { "code":"RCAI", "label":"Résultat Courant Avant Impôts", "total":true }, { "code":"TOTAL_PRODUITS_EXCEPT", "label":"Produits Exceptionnels", "total":true }, { "code":"TOTAL_CHARGES_EXCEPT", "label":"Charges Exceptionnelles", "total":true }, { "code":"PARTICIPATION", "label":"Participation des salariés", "total":true }, { "code":"IS", "label":"Impôts sur les bénéfices ", "total":true }, { "code":"IMPOTS_DIFF_CHARGE", "label":"Impôts différés ", "total":true }, { "code":"RESULTAT_NET_CONSO", "label":"RESULTAT NET CONSO", "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 }, { "code":"EBE", "value":-170168000 }, { "code":"DAP", "value":18010000 }, { "code":"REX", "value":33201000 }, { "code":"PRODUITS_FINANCIERS", "value":9500000 }, { "code":"CHARGES_FINANCIERES", "value":4854000 }, { "code":"RCAI", "value":37847000 }, { "code":"TOTAL_PRODUITS_EXCEPT", "value":1885000 }, { "code":"TOTAL_CHARGES_EXCEPT", "value":1805000 }, { "code":"RESULTAT_NET_CONSO", "value":25043000 } ] }, { "closing_date":"2015-12-31", "rows":[ { "code":"AUTRES_PRODUITS_EXP", "value":7462000 }, { "code":"TOTAL_SALAIRES_CHARGES_EXT", "value":163674000 }, { "code":"EBE", "value":-156212000 }, { "code":"DAP", "value":14665000 }, { "code":"REX", "value":43775000 }, { "code":"PRODUITS_FINANCIERS", "value":5906000 }, { "code":"CHARGES_FINANCIERES", "value":8107000 }, { "code":"RCAI", "value":41574000 }, { "code":"TOTAL_PRODUITS_EXCEPT", "value":1125000 }, { "code":"TOTAL_CHARGES_EXCEPT", "value":726000 }, { "code":"RESULTAT_NET_CONSO", "value":27886000 } ] } ] }, { "metadata":{ "label":"Compte de résultat social", "statement":"PNL", "detail_level":"Synthetic", "type":"Complet", "currency_code":"EUR", "rows":[ { "code":"CA_NET_EXPORT", "label":"Dont CA réalisé à l'export", "total":false }, { "code":"CA_NET_TOTAL", "label":"Chiffres d’affaires nets Total", "total":true }, { "code":"AUTRES_PRODUITS_EXP", "label":"Autres produits d’exploitation ", "total":true }, { "code":"TOTAL_ACHATS", "label":"Achats ", "total":true }, { "code":"TOTAL_SALAIRES_CHARGES_EXT", "label":"Salaires et Charges externes ", "total":true }, { "code":"EBE", "label":"Excédent Brut d'Exploitation", "total":true }, { "code":"DAP", "label":"Dotations aux amortissements et provisions", "total":true }, { "code":"REX", "label":"Résultat d'Exploitation", "total":true }, { "code":"PRODUITS_FINANCIERS", "label":"Produits financiers", "total":true }, { "code":"CHARGES_FINANCIERES", "label":"Charges financières", "total":true }, { "code":"RCAI", "label":"Résultat Courant Avant Impôts", "total":true }, { "code":"TOTAL_PRODUITS_EXCEPT", "label":"Produits Exceptionnels", "total":true }, { "code":"TOTAL_CHARGES_EXCEPT", "label":"Charges Exceptionnelles", "total":true }, { "code":"PARTICIPATION", "label":"Participation des salariés", "total":true }, { "code":"IS", "label":"Impôts sur les bénéfices ", "total":true }, { "code":"RESULTAT_NET", "label":"RESULTAT NET", "total":true } ] }, "dates":[ { "closing_date":"2016-12-31", "duration_in_month":12, "rows":[ { "code":"CA_NET_EXPORT", "value":111506511 }, { "code":"CA_NET_TOTAL", "value":162722432 }, { "code":"AUTRES_PRODUITS_EXP", "value":993254 }, { "code":"TOTAL_ACHATS", "value":95357644 }, { "code":"TOTAL_SALAIRES_CHARGES_EXT", "value":56012037 }, { "code":"EBE", "value":12346005 }, { "code":"DAP", "value":4422464 }, { "code":"REX", "value":7923542 }, { "code":"PRODUITS_FINANCIERS", "value":27591953 }, { "code":"CHARGES_FINANCIERES", "value":603704 }, { "code":"RCAI", "value":34911790 }, { "code":"TOTAL_PRODUITS_EXCEPT", "value":1219628 }, { "code":"TOTAL_CHARGES_EXCEPT", "value":1271309 }, { "code":"IS", "value":2216914 }, { "code":"RESULTAT_NET", "value":32643196 } ] }, { "closing_date":"2015-12-31", "rows":[ { "code":"CA_NET_TOTAL", "value":161657467 }, { "code":"AUTRES_PRODUITS_EXP", "value":3533803 }, { "code":"TOTAL_ACHATS", "value":94990142 }, { "code":"TOTAL_SALAIRES_CHARGES_EXT", "value":55216828 }, { "code":"EBE", "value":14984300 }, { "code":"DAP", "value":4479929 }, { "code":"REX", "value":10504370 }, { "code":"PRODUITS_FINANCIERS", "value":26301019 }, { "code":"CHARGES_FINANCIERES", "value":589635 }, { "code":"RCAI", "value":36215754 }, { "code":"TOTAL_PRODUITS_EXCEPT", "value":253785 }, { "code":"TOTAL_CHARGES_EXCEPT", "value":809834 }, { "code":"IS", "value":5009439 }, { "code":"RESULTAT_NET", "value":30650266 } ] } ] } ] }

Si aucune donnée financière n'est disponible, l'erreur suivante est retournée :

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

Si la société a optée pour la confidentialitée de ses comptes, l'erreur suivante est retournée :

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


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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie
  • query — Termes spécifiés pour la recherche

Exemple

{ "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" }, { "id":"587953cab3a2b06450048491", "first":"75000", "others":"Paris, Paris, Île-de-France, FRANCE", "type":"postal_code", "sourceStatus":"Complete", "formatedName":"75000, Paris, Paris, Île-de-France, FRANCE" }, { "id":"587953cab3a2b06450048492", "first":"75001", "others":"Paris, Paris, Île-de-France, FRANCE", "type":"postal_code", "sourceStatus":"Complete", "formatedName":"75001, Paris, Paris, Île-de-France, FRANCE" }, { "id":"587953cab3a2b06450048493", "first":"75002", "others":"Paris, Paris, Île-de-France, FRANCE", "type":"postal_code", "sourceStatus":"Complete", "formatedName":"75002, Paris, Paris, Île-de-France, FRANCE" } ] }


Rechercher les annonces BODACC par SIREN/ID   5 crédits/requête


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 (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètre obligatoire

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.

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"

Exemple

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

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