Bosco Labs

Blog › Annual report figures of EU listed companies as JSON

Annual report figures of EU listed companies as JSON

Bosco Labs ·

Every company listed on a regulated market in the EU files its annual report in ESEF: an XHTML document with the financial statements tagged in XBRL. The tags are what make it machine-readable, but reading them yourself means unpacking a report package, resolving contexts and picking the right IFRS concept out of a few thousand facts. Our EU Annual Reports API on Apify does that and returns the main figures as one row per company per year.

One company, latest year

The input for Heineken's latest annual report:

{"companyName": "heineken", "maxFilings": 1}

What came back on 17 November 2026, trimmed:

{
  "company_name": "Heineken Holding N.V.",
  "lei": "724500M1WJLFM9TYBS04",
  "country": "NL",
  "period_end": "2025-12-31",
  "currency": "EUR",
  "revenue": 34257000000,
  "operating_profit": 3406000000,
  "net_income": 2138000000,
  "net_income_attributable_to_parent": 952000000,
  "eps_basic": 3.39,
  "operating_cash_flow": 5012000000,
  "total_assets": 53474000000,
  "total_equity": 20335000000,
  "ebitda": 6015000000,
  "operating_margin": 0.0994,
  "revenue_growth": -0.0472,
  "prior_year": {"period_end": "2024-12-31", "revenue": 35955000000, "net_income": 1161000000},
  "sources": {
    "revenue": {"concept": "ifrs-full:Revenue", "period": "2025-01-01T00:00:00/2026-01-01T00:00:00", "unit": "iso4217:EUR"},
    "ebitda": {"derived": "operating_profit + depreciation_amortisation"}
  },
  "viewer_url": "https://filings.xbrl.org/724500M1WJLFM9TYBS04/2025-12-31/ESEF/NL/0/heiho-2025-12-31-1-en/reports/ixbrlviewer.html"
}

Reading the row

More than one company

countries takes ISO codes (["NL", "BE", "FR"]) and periodFrom/periodTo limit the fiscal years; leave the name out to list every report in that range, newest first. The reports come from filings.xbrl.org, which collects ESEF filings from the national storage mechanisms. Set includeRawFacts to also get every tagged fact of a report as its own row, and onlyNewSinceLastRun on a schedule to pay only for reports you haven't seen.

Run it

On the Store page, click Try for free, paste the input and press Start. From Python, with Apify's official client (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("bosco_labs/esef-annual-reports").call(run_input={
    "companyName": "heineken",
    "maxFilings": 1,
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["company_name"], row["period_end"], row["revenue"], row["net_income"])

From an AI agent, add this server URL to your MCP client (Claude, Cursor, VS Code):

https://mcp.apify.com?tools=bosco_labs/esef-annual-reports

Price

$0.05 per annual report processed, and $0.0005 per raw fact row if you ask for them, through Apify's pay per event. The same data is on our own HTTP API if you'd rather not use Apify.

Bosco Labs: official-source data for AI agents, as an HTTP API, MCP server and Apify Actors. API docs.