Elszámolás

Az API kreditben számol el. Minden kérés a végpontja alapárába kerül, plusz az adatot visszaadó funkciók és a választott felárak. Az árak minden csomagban azonosak. A csomagod dönti el, mely funkciókat használhatod.

A fetch-organization funkcióit egyenként kéred. Mindegyik csak akkor kerül valamibe, ha ad vissza adatot:

Az összes funkcióval és mindkét felárral egy fetch-organization kérés legfeljebb 215 kreditbe kerül. Ez a terjedelem a Max csomaggal érhető el.

Egy monitor 30 napos időszakonként rögzített árba kerül, az ellenőrzési időköztől függően. A létrehozás és az első kiindulási állapot ingyenes.

Az e lépcsők közötti időköz annyiba kerül, mint a következő gyakoribb lépcső. Bővebben az account/monitors alatt.

Az adat nélküli funkció nem kerül semmibe. Ha null értéket vagy üres listát ad vissza, nem fizetsz érte. Ez minden funkcióra érvényes, az insolvency_publications funkcióra is: fizetésképtelenségi közzétételek nélkül ingyenes.

Az alapár és a felárak saját szabályokat követnek. Az alapárat minden kiszállított cégprofilért fizeted. Az AI mód találat nélkül is kerül valamibe. A valós idejű mód minden sikeres élő lekérésnél kerül valamibe, akkor is, ha semmi nem változott a nyilvántartásban. Bővebben a Felárak alatt.

Néhány funkciónál konkrét tartalom számít:

• A shareholders és a shareholders_deep csak akkor kerül valamibe, ha vannak aktuális bejegyzések. Az előzmények önmagukban ingyenesek.
• A mergers_and_acquisitions csak tranzakciókkal, irányítási viszonyokkal vagy jogutódlásokkal kerül valamibe.
• A network csak legalább egy kapcsolattal kerül valamibe.
• A news akkor kerül valamibe, amint a lista legalább egy cikket tartalmaz.

A fetch-organization kihagyja a csomagodban nem szereplő funkciót, és nem számolja fel.

A Keresés és exportnál, a dokumentumoknál és a Signalsnál magáért a kérésért fizetsz: egy találati oldalért, egy dokumentumért, egy oldal Signalsért. A találat nélküli keresést és a Signals üres oldalát is felszámoljuk.

A sikertelen vagy elutasított kérés nem kerül semmibe, lásd Hibák.

A fetch-organization két felárral rendelkezik, amelyeket kérésenként kapcsolsz be.

AI mód (ai_search=on-default, +20 kredit): homályos bemenetből is megtalálja a céget, és a weben kutat. Amint a kutatás lefutott, felszámoljuk, akkor is, ha nem talál céget, vagy az adatforrás hibát jelez. Csak akkor nem számoljuk fel, ha az API 408-cal megszakítja a kérést.

Valós idejű mód (realtime_mode=handelsregister-default, +10 kredit): élőben lekéri a bejegyzett személyeket a Handelsregisterből (német cégnyilvántartás). A felárat akkor számoljuk fel, ha az élő lekérés sikerül, függetlenül attól, mit ad vissza. Ilyenkor a _realtime_mode.status értéke success.

Bármely más érték ott azt jelenti, hogy az élő lekérés nem sikerült. Ilyenkor a tárolt adatokat kapod, és a kérés többi részéért fizetsz, a valós idejű mód felára nélkül. Ha a kérés túl sokáig tart, az API 408-cal válaszol, és semmit nem számol fel.

Minden válasz megmondja, mennyibe került. A JSON-válaszokban ez a meta alatt, dokumentumoknál headerekben van.

A hitelesítésnél (401, 403) és a limit felett (429) történő elutasítások általában meta nélkül érkeznek. Soha nem kerülnek semmibe.

Minden terhelést megtalálsz a Fiók › Felhasználás alatt és az API-n keresztül a GET /v1/account/usage/transactions végponton, lásd account.

Mielőtt az API feldolgoz egy kérést, ellenőrzi, hogy az egyenleged fedezi-e a lehető legmagasabb költséget: alapár, az összes kért funkció és a felárak. Ha nem, az API 402-vel válaszol, és semmit nem számol fel.

A válasz ezt a maximumot a meta.request_credit_cost, az egyenlegedet a meta.credits_remaining mezőben mutatja. A később felszámított összeg gyakran alacsonyabb, mert az adat nélküli funkciók nem kerülnek semmibe.

Egy példa: az alapadatokhoz AI móddal és az ubos funkcióval előre 35 kredit kell. Ha az ubos nem ad vissza adatot, a kérés 25 kreditbe kerül.

A signals Problem Detailsszel és az INSUFFICIENT_CREDITS kóddal válaszol.

Minden új fiók 150 kezdő kreditet kap. Ezek 30 napig érvényesek.

Kredit-előfizetéssel (Plus, Pro, Max vagy Enterprise) minden hónapban krediteket kapsz. Ezek az elszámolási időszak végéig érvényesek. Ha csomagot váltasz, a fel nem használt havi krediteket átviszed az új időszakba. Plus csomagtól használhatod a fetch-person végpontot; a Pro és a Max további adatokat nyit meg.

Feltöltött krediteket egyszer, pluszban vásárolsz. Kredit-előfizetés nélkül 30 napig érvényesek. Amíg egy kredit-előfizetés fut, sem a feltöltött, sem a kezdő kreditek nem járnak le.

Az egyenlegedet, és hogy mi mikor jár le, a Fiók › Kreditek alatt és az API-n keresztül a GET /v1/account/credits végponton látod.

Minden csomag és ár az árak oldalon található.