gov-data-api-suite 0.2.0

Async adapters for free/open government and public data APIs

gov-data-api-suite

Async Python adapters for free/open government and public data APIs.

Built on async-rest-adapter — every adapter handles retry, rate-limit, attribution injection, and typed error responses automatically.

Installation

pip install gov-data-api-suite

Quick start

from backend import KoladaAdapter, KoladaConfig, SMHIAdapter, SMHIConfig

# Swedish municipality KPIs (Kolada)
async with KoladaAdapter(config=KoladaConfig()) as adapter:
    result = await adapter.search_kpis("befolkning")
    print(result.data)

# Weather forecasts (SMHI)
async with SMHIAdapter(config=SMHIConfig()) as adapter:
    forecast = await adapter.get_point_forecast(59.33, 18.07)
    print(forecast.data)

Providers

Swedish government

Adapter	Description
ArbetsformedlingenAdapter	Swedish Public Employment Service
BolagsverketAdapter	Swedish Companies Registration Office
BoverketAdapter	Swedish National Board of Housing
HavochvattenAdapter	Swedish Agency for Marine and Water Management
KoladaAdapter	Municipal KPI database
NaturvardsverketAdapter	Swedish Environmental Protection Agency
PolisenAdapter	Swedish Police — public events
RiksbankenAdapter	Swedish central bank — interest rates, exchange rates
RiksdagAdapter	Swedish Parliament — members, votes, documents
SCBAdapter	Statistics Sweden
SGUAdapter	Geological Survey of Sweden
SkatteverketAdapter	Swedish Tax Agency
SkolverketAdapter	Swedish National Agency for Education
SMHIAdapter	Swedish weather and hydrology institute
ValmyndighetenAdapter	Swedish Election Authority

International

Adapter	Description
ECBAdapter	European Central Bank
EurostatAdapter	EU statistics
IMFAdapter	International Monetary Fund
WorldBankAdapter	World Bank open data

Search / Geo

Adapter	Description
DuckDuckGoAdapter	DuckDuckGo Instant Answer API
OpenStreetMapAdapter	Nominatim geocoding

Attribution

All adapters inject metadata["attribution"] into every successful response with the correct license, source text, and URL for the provider.

Requirements

• Python 3.12+
• async-rest-adapter ≥ 0.1.0
• httpx ≥ 0.27
• pydantic ≥ 2.0

License

MIT