Questions fréquentes

Des registres et publications officiels : le Handelsregister (registre du commerce), l’Unternehmensregister (registre des entreprises) avec les comptes annuels, et les publications d’insolvabilité. Les actualités et les contenus de sites web viennent du web. Plus d’informations dans Disponibilité des données.

Nous lisons automatiquement de nombreuses informations dans les documents et publications. Nous utilisons pour cela les technologies les plus récentes et investissons beaucoup dans la qualité ; des erreurs isolées restent possibles.

Un profil d’entreprise provient de notre base de données. Avec le mode temps réel, l’API interroge aussi le Handelsregister en direct et renvoie les personnes actuellement inscrites. L’API récupère les documents au registre quand tu les demandes.

Si le même document a été récupéré peu de temps avant, il peut dater de jusqu’à 24 heures.

Les entreprises doivent publier leurs comptes annuels au plus tard douze mois après la date de clôture, et beaucoup utilisent tout le délai. Les derniers comptes portent donc souvent sur l’avant-dernière année.

Généralement parce que l’entreprise n’est pas tenue de la publier. Ce qui est public dépend de la forme juridique et de la taille : une petite GmbH, par exemple, ne publie pas de compte de résultat, il n’y a donc généralement pas de chiffre d’affaires pour elle. Les valeurs vides apparaissent sous forme de null ou [] dans la réponse.

Pour un nom partagé par plusieurs entreprises, l’API peut renvoyer l’une d’elles, pas forcément celle que tu vises, ou répondre 404. Si tu dois être précis, interroge avec le tribunal du registre et le numéro de registre, par exemple « Ansbach HRB 6089 », ou avec l’entity_id. Le numéro de registre seul ne suffit pas, car le même numéro existe auprès de nombreux tribunaux.

Non. Une fonctionnalité n’est facturée que si elle renvoie des données. Le mode IA, en revanche, est facturé même s’il ne trouve aucune entreprise. Il n’est pas facturé seulement si l’API annule la requête avec 408. Le mode temps réel coûte des crédits pour chaque récupération en direct réussie, même s’il ne montre rien de nouveau.

Rien. Une requête qui se termine par une erreur n’est pas facturée ; la seule exception est le supplément pour le mode IA. Avec le statut 402, meta.request_credit_cost indique le maximum que la requête aurait coûté. Plus d’informations dans Erreurs.

Non. Tu peux utiliser les profils d’entreprise, Recherche & Export, les documents et Signals avec n’importe quel compte ; tu ne paies que les crédits. Un abonnement de crédits débloque des données supplémentaires :

• Plus : le profil de personne.
• Pro : les indicateurs financiers étendus, la fonctionnalité Réseau d’entreprises, les filtres de recherche sur la détention, la direction et l’insolvabilité, et le thème Signals Insolvabilités.
• Max : tout ce que contient Pro, plus la fonctionnalité Associés approfondis, les comptes d’activité des fournisseurs d’énergie et le thème Signals Transformations & fusions-acquisitions.

Tout sur les prix et les plans figure dans Facturation.

Un nouveau compte reçoit 150 crédits de départ. Sans abonnement de crédits, les crédits de départ et de recharge sont valables 30 jours. Tant qu’un abonnement de crédits est actif, ils n’expirent pas.

Pour le mode temps réel, les profils de personne et les documents, au moins 120 secondes, car ces requêtes durent plus longtemps. Si seule la récupération en direct échoue avec le mode temps réel, tu obtiens les données enregistrées sans le supplément temps réel. Si la requête dure trop longtemps, elle se termine par 408, pour les documents par 504. Rien n’est alors facturé. Réessaie plus tard.

Pour les profils d’entreprise, 60 requêtes par minute et par compte, pour les documents 5. Au-delà, l’API répond avec le statut 429 et indique le temps d’attente dans Retry-After. Toutes les limites figurent dans Limites.

Oui, pour les profils d’entreprise, les profils de personne, la recherche et les documents. Envoie ta propre valeur dans le header Idempotency-Key. Si tu répètes la requête avec la même clé et les mêmes paramètres dans les 24 heures, elle ne coûte rien.

Oui. Sous Compte › Clés API, tu crées d’autres clés, par exemple une par application. Si tu supprimes une clé, elle est immédiatement invalide. Toutes les clés partagent le solde de ton compte.