Laskutus
Mitä pyyntö maksaa ja miten voit jäljittää sen.
Hinnat päätepisteittäin ja ominaisuuksittain
API laskuttaa krediitteinä. Jokainen pyyntö maksaa päätepisteensä perushinnan sekä dataa palauttavat ominaisuudet ja valitsemasi lisämaksut. Hinnat ovat samat jokaisessa tilauksessa. Tilauksesi ratkaisee, mitä ominaisuuksia voit käyttää.
| Päätepiste | Mitä | Krediitit |
|---|---|---|
| fetch-organization | Yritysprofiili perustiedoilla | 5 |
| fetch-organization | Ominaisuudet, katso seuraava taulukko | 1–80 |
| fetch-organization | AI-tilan lisämaksu, myös ilman osumaa | +20 |
| fetch-organization | Reaaliajan lisämaksu, jokaisesta onnistuneesta suorasta hausta | +10 |
| fetch-person | Henkilöprofiili, verkkotutkimus mukana (Plussasta alkaen) | 15 |
| fetch-person |
Ominaisuus shareholdings, vain kun se palauttaa dataa
|
+5 |
| fetch-person |
Ominaisuus network (Pro, Max), vain kun se palauttaa dataa
|
+25 |
| search-organizations | Yksi tulossivu, myös tyhjä | 1 |
| fetch-document | Yksi toimitettu asiakirja | 15 |
| signals | Yksi sivu Signalsia tai yksittäinen signaali | 20 |
| signals |
Aiheluettelo /v1/signals/catalog
|
maksuton |
| account, auth | Tili, saldo, käyttö, avaimet, tokenit ja webhook-päätepisteet | maksuton |
fetch-organizationin ominaisuudet pyydät yksitellen. Kukin maksaa vain, kun se palauttaa dataa:
| Ominaisuus | Sisältö | Krediitit | Tilaus |
|---|---|---|---|
| related_persons | Johto | 2 | jokainen tili |
| shareholders | Osakkaat (Beta) | 5 | jokainen tili |
| shareholders_deep | Syvät osakastiedot | 80 | Max |
| ubos | Tosiasialliset edunsaajat (UBO, Beta) | 10 | jokainen tili |
| shareholdings | Omistukset (Beta) | 5 | jokainen tili |
| mergers_and_acquisitions | Sulautumiset & yritysostot (M&A, Beta) | 20 | jokainen tili |
| network | Yritysverkosto (Beta) | 25 | Pro, Max |
| publications | Historia: rekisterikuulutukset | 1 | jokainen tili |
| financial_kpi | Taloudelliset tunnusluvut | 1 | jokainen tili |
| balance_sheet_accounts | Tase | 3 | jokainen tili |
| profit_and_loss_account | Tuloslaskelma | 3 | jokainen tili |
| annual_financial_statements | Tilinpäätökset (Markdown) | 5 | jokainen tili |
| annual_financial_statements__html | Tilinpäätökset (HTML) | 5 | jokainen tili |
| insolvency_publications | Maksukyvyttömyyskuulutukset | 5 | jokainen tili |
| news | Uutiset | 10 | jokainen tili |
| website_content | Verkkosivuston sisältö · vain AI-tilalla | maksuton | jokainen tili |
Kaikilla ominaisuuksilla ja molemmilla lisämaksuilla pyyntö päätepisteeseen fetch-organization maksaa enintään 215 krediittiä. Tämä laajuus sisältyy Maxiin.
Monitori maksaa kiinteän hinnan 30 päivän jaksolta tarkistusvälin mukaan. Luonti ja ensimmäinen lähtötilanne ovat maksuttomia.
| Tarkistusväli | Krediittiä 30 päivältä |
|---|---|
| joka päivä | 50 |
| 3 päivän välein | 40 |
| 7 päivän välein | 20 |
| 30 päivän välein | 10 |
| Jokainen jakson lisäksi onnistunut tarkistus | +2 |
Näiden portaiden välissä oleva väli maksaa yhtä paljon kuin seuraava tiheämpi porras. Lisää kohdassa account/monitors.
Maksa vain siitä, mikä palauttaa dataa
Ominaisuus ilman dataa ei maksa mitään. Jos se palauttaa null-arvon tai tyhjän listan, et maksa siitä. Tämä koskee jokaista ominaisuutta, myös ominaisuutta insolvency_publications: ilman maksukyvyttömyyskuulutuksia se on maksuton.
Perushinnalla ja lisämaksuilla on omat sääntönsä. Perushinnan maksat jokaisesta toimitetusta yritysprofiilista. AI-tila maksaa myös ilman osumaa. Reaaliaika maksaa jokaisesta onnistuneesta suorasta hausta, vaikka rekisterissä ei olisi muuttunut mitään. Lisää kohdassa Lisämaksut.
Joissakin ominaisuuksissa ratkaisee tietty sisältö:
shareholdersjashareholders_deepmaksavat vain, kun nykyisiä merkintöjä on. Pelkkä historia on maksuton.mergers_and_acquisitionsmaksaa vain, kun on transaktioita, määräysvaltasuhteita tai oikeusseuraantoja.networkmaksaa vain, kun on vähintään yksi yhteys.newsmaksaa heti, kun listassa on vähintään yksi artikkeli.
fetch-organization jättää pois ominaisuuden, joka ei sisälly tilaukseesi, eikä veloita sitä.
Haku & viennissä, asiakirjoissa ja Signalsissa maksat itse pyynnöstä: yhdestä tulossivusta, yhdestä asiakirjasta, yhdestä Signals-sivusta. Myös haku ilman tuloksia ja tyhjä Signals-sivu veloitetaan.
Epäonnistunut tai hylätty pyyntö ei maksa mitään, katso Virheet.
AI-tilan ja Reaaliajan lisämaksut
fetch-organizationilla on kaksi lisämaksua, jotka kytket päälle pyyntökohtaisesti.
AI-tila (ai_search=on-default, +20 krediittiä) löytää yrityksen myös epämääräisestä syötteestä ja tutkii verkkoa. Se veloitetaan heti, kun tutkimus on suoritettu, vaikka se ei löytäisi yritystä tai tietolähde ilmoittaisi virheestä. Vain jos API keskeyttää pyynnön vastauksella 408, sitä ei veloiteta.
Reaaliaika (realtime_mode=handelsregister-default, +10 krediittiä) hakee rekisteröidyt henkilöt suoraan Handelsregisteristä (kaupparekisteri). Veloitamme lisämaksun, kun suora haku onnistuu, riippumatta siitä, mitä se palauttaa. Silloin kentän _realtime_mode.status arvo on success.
Mikä tahansa muu arvo siinä tarkoittaa, että suora haku epäonnistui. Saat silloin tallennetut tiedot ja maksat pyynnön muusta osasta ilman Reaaliajan lisämaksua. Jos pyyntö kestää liian kauan, API vastaa 408 eikä veloita mitään.
1{2 "name": "Hetzner Online GmbH",3 "_realtime_mode": {4 "mode": "handelsregister-default",5 "status": "success"6 },7 "meta": {8 "request_credit_cost": 15,9 "credits_remaining": 14510 }11}
Kustannukset vastauksessa
Jokainen vastaus kertoo, mitä se maksoi. JSON-vastauksissa tämä on kentässä meta, asiakirjoilla headereissa.
| Missä | Merkitys |
|---|---|
| meta.request_credit_cost |
Mitä tämä pyyntö maksoi. Idempotenssiavaimella tehdyissä uudelleenyrityksissä ja lähes kaikissa virheissä tämä on 0.
|
| meta.credits_remaining | Saldosi pyynnön jälkeen. |
| X-Credits-Charged | signals ja toimitettu asiakirja: mitä pyyntö maksoi, headerina. |
| X-Credits-Remaining | Toimitettu asiakirja: saldosi pyynnön jälkeen, headerina. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Tunnistautumisessa (401, 403) ja rajan ylittyessä (429) hylätyt pyynnöt tulevat yleensä ilman kenttää meta. Ne eivät koskaan maksa mitään.
Jokaisen veloituksen löydät kohdasta Tili › Käyttö ja API:n kautta osoitteesta GET /v1/account/usage/transactions, katso account.
Krediitit eivät riitä
Ennen kuin API käsittelee pyynnön, se tarkistaa, riittääkö saldosi korkeimpaan mahdolliseen hintaan: perushinta, kaikki pyydetyt ominaisuudet ja lisämaksut. Jos ei riitä, API vastaa 402 eikä veloita mitään.
Vastaus näyttää tämän enimmäismäärän kentässä meta.request_credit_cost ja saldosi kentässä meta.credits_remaining. Myöhemmin veloitettu määrä on usein pienempi, koska ominaisuudet ilman dataa eivät maksa mitään.
Esimerkki: perustiedot AI-tilalla ja ominaisuudella ubos vaativat etukäteen 35 krediittiä. Jos ubos ei palauta dataa, pyyntö maksaa 25 krediittiä.
signals vastaa Problem Details -muodossa koodilla INSUFFICIENT_CREDITS.
Krediittitilaus ja lisäkrediitit
Jokainen uusi tili saa 150 aloituskrediittiä. Ne ovat voimassa 30 päivää.
Krediittitilauksella (Plus, Pro, Max tai Enterprise) saat krediittejä joka kuukausi. Ne ovat voimassa laskutuskauden loppuun. Jos vaihdat tilausta, käyttämättömät kuukausikrediitit siirtyvät uudelle kaudelle. Plussasta alkaen voit käyttää fetch-personia; Pro ja Max avaavat lisää dataa.
Lisäkrediittejä ostat kertaostona päälle. Ilman krediittitilausta ne ovat voimassa 30 päivää. Niin kauan kuin krediittitilaus on voimassa, lisäkrediitit ja aloituskrediitit eivät vanhene.
Saldosi ja mitä vanhenee milloin näet kohdassa Tili › Krediitit ja API:n kautta osoitteesta GET /v1/account/credits.
Kaikki tilaukset ja hinnat ovat hinnastosivulla.