Eurostat

Import national supply-use or input-output tables through the supported Eurostat datasets.

Download notebook

This call retrieves source data. For IOTs, select the product or industry system explicitly; availability varies by country and year.

Import#

import mario

db = mario.parse_eurostat(country="IT", year=2022, table="SUT")

Result · A MARIO database. Inspect db, db.get_index("all") and db.units before selecting quantities for your analysis.

Inputs and options#

Key arguments

The key public arguments are:

country: Eurostat geo code such as IT or DE
year: reference year to parse
table: choose "SUT" or "IOT"
iot_mode: IOT-only selector, either "product" or "industry"
unit: choose "MIO_EUR" or "MIO_NAC"
path: optional local cache directory for raw SDMX CSV files
download: when True, MARIO stores the raw CSV locally before parsing it

Available years

Year availability depends on the country and on the table family.

Official Eurostat metadata states that national SUT annual tables are published from 2010 onward.
Official Eurostat metadata also states that national IOT tables are published from 2010 onward, but mandatory transmission is only for years ending in 0 or 5.
Additional IOT years depend on voluntary country transmission.

On the live official API, checked on 18 April 2026 with Italy (``IT``) as one concrete example, MARIO currently finds:

SUT: 2010 to 2022
IOT: 2010 and then 2015 to 2022

So for SUT you should expect a broadly annual series, while for IOT you should treat 2010, 2015, and 2020 as the core mandatory years and any extra years as country-specific.

Relevant source pages and local cache

Relevant official pages:

ESA supply, use and input-output tables
Eurostat metadata for ``naio_10_n` <https://ec.europa.eu/eurostat/cache/metadata/en/naio_10_n_esms.htm>`__
Eurostat API introduction

path is optional and, when provided, acts as a raw SDMX cache:

EUROSTAT/
└── cache/
    ├── NAIO_10_CP15_*.csv
    ├── NAIO_10_CP16_*.csv
    ├── NAIO_10_CP1700_*.csv
    └── NAIO_10_CP1750_*.csv

If download=False, MARIO reads directly from the API. If download=True, MARIO stores the raw slices under path before building the database.

import mario

Parse a SUT directly from the API

db = mario.parse_eurostat(
    country="IT",
    year=2022,
    table="SUT",
)

db

Parse an IOT

db = mario.parse_eurostat(
    country="IT",
    year=2022,
    table="IOT",
    iot_mode="product",
)

db

Optional raw download and cache

mario.download_eurostat(
    path="/path/to/SUT",
    country="IT",
    year=2022,
    table="SUT",
)

Continue with Inspect and query a database or Calculate matrices.