Data API · invite-only beta

Nordic + US filings, behind one REST API.

Helsinki, Stockholm and SEC filings as structured data and full-text RAG search. The same dataset that powers clarifo.com — wired into your application.

POSTapi.clarifo.com
v1
request
POST /api/v1/data/companies/screen
Authorization: Bearer clf_3a7f…

{ "metric": "revenue",
  "mode": "growth",
  "country": "FI",
  "top_n": 5 }
200 OK· 184 ms
response
{ "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 companies

Coverage across Nordic & US markets

Why this

Why the Clarifo Data API

Structured Nordic filings data is hard to come by. This is it, ready to use.

Nordics + US through one interface

Helsinki, Stockholm and the full SEC EDGAR universe from a single API — with unified metric keys across markets.

Audit-grade citations

Every figure ships with a page_id resolvable to a per-page PNG snapshot (Nordic) or EDGAR link (US). Your end users can click through to the source.

Same dataset as clarifo.com

No separate pipeline. The API serves the same key figures, the same statements, and the same profiles you see on the Clarifo web app.

Hands-on beta

The Data API is in invite-only beta. We speak with every early customer, learn the use case, and make sure the integration succeeds.

Endpoints

What the endpoints give you

Nine endpoints covering search, key figures, full statements, profile, geography, comparison, screening and audit-grade snapshots.

GET /filings/search

Search filings

Annual reports, interim reports and stock-exchange releases by company, year, document type, or market.

POST /filings/content/search

Semantic content search

RAG search across the full text of every filing. Returns exact passages plus page-level citations.

GET /companies/{id}/financials

Key financial figures

Revenue, EBITDA, EBIT, net income, EPS, equity, cash flow — annual plus the freshest quarter.

GET /companies/{id}/statement

Full statements

Income statement, balance sheet, cash flow — every line item, up to 25 periods.

POST /companies/compare

Compare companies

Side-by-side KPIs for 2–5 issuers. Mix Nordic and US in a single call.

POST /companies/screen

Screen the universe

Rank across the full universe by growth or absolute value, filtered by country, industry or tag taxonomy.

GET /companies/{id}/profile

Company profile

Structured business context: products, customers, geography, strategy, risks, critical accounting policies.

GET /companies/{id}/revenue-geography

Revenue geography

Country + region revenue split with ISO alpha-2 codes — ready for map visualisations.

GET /filings/snapshot

Filing page snapshot

Resolve a page_id into a per-page PNG snapshot (Nordic) or EDGAR link (US) — audit-grade citation for end users.

Call

What a call looks like

Bearer auth, JSON in, JSON out. No SDK required.

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

How to get a key

Three steps from request to first call. We handle every application personally.

1

Send a request

Email support@clarifo.com — tell us your company, the use case, and your estimated call volume. We reply within 1–2 business days.

2

We enable your plan

We size a plan to your volume and needs. API access activates on your Clarifo account right after payment — no extra config.

3

Create a key and build

Settings → API keys → Create key. Use the clf_ key as a bearer token. Documentation, code samples and example responses live at /docs.

Invite-only beta

Request access to the Clarifo Data API

Email support@clarifo.com — include your company, use case, and estimated monthly call volume. We reply within 1–2 business days.