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
- The name search found Heineken Holding N.V., the listed holding company that owns a majority of Heineken N.V. Both file their own report. When you need one specific company, search by its LEI (
"leis": ["..."]) instead of a name. net_incomeandnet_income_attributable_to_parentdiffer a lot here: 2.14 billion for the whole group against 952 million for the holding's own shareholders, because about half of Heineken N.V. belongs to other shareholders. For earnings per share and valuation, use the attributable figure.sourcesnames the IFRS concept and period behind every reported figure, and marks the ones we calculate (ebitda, the margins,total_liabilities) asderivedwith the formula.viewer_urlopens the tagged report itself, so you can click through to any number.prior_yearholds the same figures for the year before, as filed in this report, sorevenue_growthneeds no second call.
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.