Data API

Tilinpäätösdata suoraan sovellukseesi.

Strukturoidut raportit, yhtenäiset tunnusluvut ja semanttinen haku yhden rajapinnan kautta — nyt kehittäjien käyttöön.

Pohjoismaiset ja Yhdysvaltain markkinat

Miksi tämä

Miksi Clarifo Data API

Pohjoismaat + USA yhdellä rajapinnalla

Helsinki, Tukholma ja koko SEC EDGAR -universumi samasta API:sta — yhtenäisillä tunnusluku-avaimilla markkinoiden välillä.

Audit-tason lähdeviittaukset

Jokainen luku on jäljitettävissä alkuperäisen raportin sivulle: PNG-kuva (Pohjoismaat) tai EDGAR-linkki (USA). Asiakkaasi voi avata lähteen yhdellä klikkauksella.

Endpointit

Mitä rajapinta tarjoaa

Yhdeksän endpointtia kattavat haun, tunnusluvut, koko tilinpäätökset, profiilin, maantieteen, vertailun, seulonnan ja audit-snapshotit.

GET /filings/search

Hae tilinpäätöksiä

Vuosikertomukset, osavuosikatsaukset ja pörssitiedotteet yhtiöittäin, vuosittain, dokumenttityypeittäin tai markkinoittain.

POST /filings/content/search

Semanttinen sisältöhaku

RAG-haku jokaisen tilinpäätöksen koko tekstistä. Palauttaa tarkat kappaleet ja sivunumerot lähdeviittauksiin.

GET /companies/{id}/financials

Tunnusluvut

Liikevaihto, EBITDA, EBIT, nettotulos, EPS, oma pääoma, kassavirta — vuosittain plus tuorein kvartaali.

GET /companies/{id}/statement

Tilinpäätökset rivitasolla

Tuloslaskelma, tase, kassavirta — jokainen rivi, kaikilta 25 viime tilikaudelta.

POST /companies/compare

Vertaile yhtiöitä

KPI-rinnakkaisvertailu 2–5 yhtiölle. Pohjoismaisia ja yhdysvaltalaisia voi sekoittaa samaan kutsuun.

POST /companies/screen

Seulonta universumissa

Aseta koko yhtiöuniversumi paremmuusjärjestykseen kasvun tai absoluuttisen arvon mukaan, suodatettuna maan, toimialan tai tunnisteiden mukaan.

GET /companies/{id}/profile

Yhtiöprofiili

Strukturoitu liiketoimintakuvaus: tuotteet, asiakkaat, maantiede, strategia, riskit, kriittiset laskentaperiaatteet.

GET /companies/{id}/revenue-geography

Liikevaihdon maantiede

Maa- ja aluekohtainen liikevaihtojakauma ISO alpha-2 -koodeineen — valmista karttavisualisointiin.

GET /filings/snapshot

Lähdesivun snapshot

Sivun kuva (Pohjoismaat) tai EDGAR-linkki (USA) jokaiselle raportin sivulle. Audit-tason lähdeviittaus loppukäyttäjälle.

Kutsu

Miltä kutsu näyttää

Bearer-autentikointi, JSON-pyyntö, JSON-vastaus. Ei SDK-vaatimuksia.

bash
curl https://api.clarifo.com/api/v1/data/companies/Neste/financials \
  -H "Authorization: Bearer $CLARIFO_API_KEY"
Asennus

Näin saat avaimen

Kolme askelta pyynnöstä ensimmäiseen kutsuun. Käsittelemme jokaisen hakemuksen henkilökohtaisesti.

1

Lähetä pyyntö

Lähetä sähköposti osoitteeseen support@clarifo.com — kerro yrityksesi, käyttötapaus ja arvioitu API-kutsujen määrä. Vastaamme 1–2 arkipäivän kuluessa.

2

Avaamme tilauksen

Räätälöimme suunnitelman volyymisi ja tarpeesi pohjalta. API-pääsy aktivoituu Clarifo-tilillesi heti maksun jälkeen — ei lisäkonfiguraatiota tarvita.

3

Luo avain ja rakenna

Asetukset → API-avaimet → Luo avain. Käytä clf_-avainta bearer-tokenina. Dokumentaatio, koodiesimerkit ja esimerkkivastaukset löytyvät /docs-sivulta.

Pyydä pääsy Clarifo Data API:in

Lähetä sähköposti osoitteeseen support@clarifo.com — kerro yrityksesi, käyttötapaus ja arvioitu API-kutsujen määrä. Vastaamme 1–2 arkipäivän kuluessa.