Data API · kutsuvaihe

Pohjoismaiset tilinpäätökset, REST:in takaa.

Helsingin, Tukholman ja SEC:n raportit strukturoituna datana ja semanttisena hakuna. Sama dataset joka pyörittää clarifo.comia — sovellutuksesi käyttöön.

POST
·
api.clarifo.com
pyyntö
POST /api/v1/data/companies/screen
Authorization: Bearer clf_3a7f…

{ "metric": "revenue",
  "mode": "growth",
  "country": "FI",
  "top_n": 5 }
200 OK· 184 ms
vastaus
{ "metric": "revenue", "mode": "growth",
  "year": 2024, "compare_year": 2023,
  "companies": [
    { "display_name": "Fiskars Oyj Abp",
      "ticker": "FSKRS.HE",
      "value_anchor": 1320.0,
      "growth_pct": 5.6 },
    ... ] }
RESTFI · 20245 yhtiötä

Miksi Clarifo Data API

Strukturoitu pohjoismainen tilinpäätösdata on harvinaista. Tässä on se, valmiina käytettäväksi.

Pohjoismaat + USA yhdellä rajapinnalla

Helsinki, Tukholma ja koko SEC EDGAR -universumi samasta API:sta — yhtenäisillä metric-avaimilla yli markkinarajojen.

Audit-tason lähdeviittaukset

Jokaisella luvulla on page_id, jonka avulla saat aukeavan PNG-snapshotin (Pohjoismaat) tai EDGAR-linkin (USA). Asiakkaasi voi klikata lähteeseen.

Sama data kuin clarifo.com

Ei erillistä putkea. API tarjoaa samat tunnusluvut, samat raportit, samat profiilit jotka näkyvät Clarifon web-sovelluksessa.

Hands-on beta

Data API on tällä hetkellä kutsuvaiheessa. Puhumme jokaisen ensimmäisen asiakkaan kanssa, ymmärrämme käyttötapaukset ja varmistamme onnistuneen integraation.

Mitä endpoint-pinnasta saa

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

Hae tilinpäätöksiä

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

Semanttinen sisältöhaku

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

Tunnusluvut

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

Tilinpäätökset rivitasolla

Tuloslaskelma, tase, kassavirta — jokainen rivi, jokaisilta 25 viime periodilta.

Vertaile yhtiöitä

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

Seulonta universumissa

Ranking koko yhtiöuniversumissa: kasvulla tai absoluuttisella arvolla, suodatettuna maan, toimialan tai tagien mukaan.

Yhtiöprofiili

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

Liikevaihdon maantiede

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

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"

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öpostia osoitteeseen support@clarifo.com — kerro yrityksesi, käyttötapaus ja arvioitu kutsumää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.

Kutsuvaihe

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