Χρέωση

Το API χρεώνει σε πιστώσεις. Κάθε αίτημα κοστίζει τη βασική τιμή του endpoint του, συν τα features που επιστρέφουν δεδομένα και τις προσαυξήσεις που επιλέγεις. Οι τιμές είναι ίδιες σε κάθε πλάνο. Το πλάνο σου καθορίζει ποια features μπορείς να χρησιμοποιείς.

Τα features του fetch-organization τα ζητάς ένα ένα. Το καθένα κοστίζει μόνο όταν επιστρέφει δεδομένα:

Με όλα τα features και τις δύο προσαυξήσεις, ένα αίτημα στο fetch-organization κοστίζει το πολύ 215 πιστώσεις. Αυτό το εύρος περιλαμβάνεται στο Max.

Ένα monitor κοστίζει σταθερή τιμή ανά περίοδο 30 ημερών, ανάλογα με τη συχνότητα ελέγχου. Η δημιουργία του και η πρώτη αρχική κατάσταση είναι δωρεάν.

Μια συχνότητα ανάμεσα σε αυτά τα βήματα κοστίζει όσο το επόμενο συχνότερο βήμα. Περισσότερα στο account/monitors.

Ένα feature χωρίς δεδομένα δεν κοστίζει τίποτα. Αν επιστρέφει null ή κενή λίστα, δεν πληρώνεις γι’ αυτό. Αυτό ισχύει για κάθε feature, και για το insolvency_publications: χωρίς ανακοινώσεις αφερεγγυότητας είναι δωρεάν.

Η βασική τιμή και οι προσαυξήσεις ακολουθούν δικούς τους κανόνες. Τη βασική τιμή την πληρώνεις για κάθε προφίλ εταιρείας που παραδίδεται. Η Λειτουργία AI κοστίζει ακόμη και χωρίς αποτέλεσμα. Ο Πραγματικός χρόνος κοστίζει για κάθε επιτυχή ζωντανή ανάκτηση, ακόμη και αν δεν έχει αλλάξει τίποτα στο μητρώο. Περισσότερα στις Προσαυξήσεις.

Για ορισμένα features, μετράει συγκεκριμένο περιεχόμενο:

• Τα shareholders και shareholders_deep κοστίζουν μόνο όταν υπάρχουν τρέχουσες καταχωρίσεις. Ένα ιστορικό μόνο του είναι δωρεάν.
• Το mergers_and_acquisitions κοστίζει μόνο με συναλλαγές, σχέσεις ελέγχου ή καθολικές διαδοχές.
• Το network κοστίζει μόνο με τουλάχιστον μία σύνδεση.
• Το news κοστίζει μόλις η λίστα περιέχει τουλάχιστον ένα άρθρο.

Το fetch-organization παραλείπει ένα feature που δεν περιλαμβάνει το πλάνο σου και δεν το χρεώνει.

Στην Αναζήτηση & Εξαγωγή, στα έγγραφα και στα Signals, πληρώνεις για το ίδιο το αίτημα: μία σελίδα αποτελεσμάτων, ένα έγγραφο, μία σελίδα Signals. Μια αναζήτηση χωρίς αποτελέσματα και μια κενή σελίδα Signals χρεώνονται επίσης.

Ένα αίτημα που απέτυχε ή απορρίφθηκε δεν κοστίζει τίποτα, βλ. Σφάλματα.

Το fetch-organization έχει δύο προσαυξήσεις που ενεργοποιείς ανά αίτημα.

Η Λειτουργία AI (ai_search=on-default, +20 πιστώσεις) βρίσκει την εταιρεία ακόμη και από ασαφή είσοδο και ερευνά στο διαδίκτυο. Χρεώνεται μόλις εκτελεστεί η έρευνα, ακόμη και αν δεν βρει εταιρεία ή η πηγή δεδομένων αναφέρει σφάλμα. Μόνο όταν το API ακυρώνει το αίτημα με 408 δεν χρεώνεται.

Ο Πραγματικός χρόνος (realtime_mode=handelsregister-default, +10 πιστώσεις) ανακτά ζωντανά τα εγγεγραμμένα πρόσωπα από το Handelsregister (εμπορικό μητρώο). Χρεώνουμε την προσαύξηση όταν η ζωντανή ανάκτηση πετύχει, ανεξάρτητα από το τι επιστρέφει. Τότε το _realtime_mode.status έχει την τιμή success.

Οποιαδήποτε άλλη τιμή εκεί σημαίνει ότι η ζωντανή ανάκτηση απέτυχε. Λαμβάνεις τότε τα αποθηκευμένα δεδομένα και πληρώνεις για το υπόλοιπο αίτημα, χωρίς την προσαύξηση Πραγματικού χρόνου. Αν το αίτημα διαρκέσει πολύ, το API απαντά με 408 και δεν χρεώνει τίποτα.

Κάθε απάντηση σού λέει τι κόστισε. Στις απαντήσεις JSON αυτό βρίσκεται στο meta, για τα έγγραφα σε headers.

Οι απορρίψεις στην αυθεντικοποίηση (401, 403) και πάνω από το όριο (429) έρχονται συνήθως χωρίς meta. Δεν κοστίζουν ποτέ τίποτα.

Κάθε χρέωση τη βρίσκεις στο Λογαριασμός › Χρήση και μέσω του API στο GET /v1/account/usage/transactions, βλ. account.

Πριν το API επεξεργαστεί ένα αίτημα, ελέγχει αν το υπόλοιπό σου καλύπτει το υψηλότερο δυνατό κόστος: βασική τιμή, όλα τα features που ζητήθηκαν και τις προσαυξήσεις. Αν όχι, το API απαντά με 402 και δεν χρεώνει τίποτα.

Η απάντηση δείχνει αυτό το μέγιστο στο meta.request_credit_cost και το υπόλοιπό σου στο meta.credits_remaining. Το ποσό που χρεώνεται αργότερα είναι συχνά χαμηλότερο, γιατί τα features χωρίς δεδομένα δεν κοστίζουν τίποτα.

Ένα παράδειγμα: τα βασικά στοιχεία με Λειτουργία AI και το feature ubos χρειάζονται εκ των προτέρων 35 πιστώσεις. Αν το ubos δεν επιστρέψει δεδομένα, το αίτημα κοστίζει 25 πιστώσεις.

Το signals απαντά με Problem Details και τον κωδικό INSUFFICIENT_CREDITS.

Κάθε νέος λογαριασμός λαμβάνει 150 αρχικές πιστώσεις. Ισχύουν 30 ημέρες.

Με μια συνδρομή πιστώσεων (Plus, Pro, Max ή Enterprise), λαμβάνεις πιστώσεις κάθε μήνα. Ισχύουν έως το τέλος της περιόδου χρέωσης. Αν αλλάξεις πλάνο, μεταφέρεις τις αχρησιμοποίητες μηνιαίες πιστώσεις στη νέα περίοδο. Από το Plus μπορείς να χρησιμοποιείς το fetch-person· τα Pro και Max ξεκλειδώνουν επιπλέον δεδομένα.

Τις πιστώσεις επαναφόρτισης τις αγοράζεις εφάπαξ, επιπλέον. Χωρίς συνδρομή πιστώσεων, ισχύουν 30 ημέρες. Όσο τρέχει μια συνδρομή πιστώσεων, δεν λήγουν ούτε οι πιστώσεις επαναφόρτισης ούτε οι αρχικές πιστώσεις.

Το υπόλοιπό σου και τι λήγει πότε τα βλέπεις στο Λογαριασμός › Πιστώσεις και μέσω του API στο GET /v1/account/credits.

Όλα τα πλάνα και οι τιμές βρίσκονται στη σελίδα τιμών.