statbridge 0.1.0

Python client for the StatBridge API — official statistics from ISTAT, Eurostat, OECD, and ECB

StatBridge

Python client for the StatBridge API — official statistics from ISTAT, Eurostat, OECD, and ECB in one unified interface.

Install

pip install statbridge

Quick start

from statbridge_sdk import StatBridge

sb = StatBridge("sb_live_xxxxxxxxxxxx")

# Search for topics
sb.search("unemployment")

# Get data
data = sb.get("unemployment_rate")
print(data["data"])       # list of records
print(data["citation"])   # proper source attribution

# Filter by dimension
data = sb.get("unemployment_rate", SESSO=2, CLASSE_ETA="Y15-24", year=2023)

# Get a pandas DataFrame instead
df = sb.get("gdp_growth", as_dataframe=True)

# Discover available filters
sb.dimensions("unemployment_rate")

# List all topics
sb.topics()

Environment variable

Instead of passing the key directly, set STATBRIDGE_API_KEY:

export STATBRIDGE_API_KEY="sb_live_xxxxxxxxxxxx"

sb = StatBridge()  # picks up the env var

Optional dependencies

pip install "statbridge[pandas]"   # enables as_dataframe=True

Available topics

25 topics across labour, economy, society, and energy — covering Italy (regional), EU, and OECD countries.

See the full list at statbridge.net/docs/datasets.

Links

• Documentation
• API reference
• Dashboard & API keys