/ 
WWW-Bund-0.002
River stage zero No dependents
/ bund

NAME

bund - CLI client for German Federal Government APIs (bund.dev)

VERSION

version 0.002

SYNOPSIS

# List all available APIs
bund list

# Get help for a specific API
bund info autobahn
bund autobahn

# Call API endpoints
bund autobahn roads
bund autobahn roadworks A5
bund pegel stations
bund tagesschau search Ukraine
bund nina warnings 091620000000
bund bundestag conferences

# Change output format
bund -o json autobahn roads
bund -o yaml pegel stations

# Use custom template
bund -t my_template.yaml autobahn roads

# Change language at runtime
bund --lang en autobahn roads

DESCRIPTION

bund is a command-line client for German Federal Government APIs (bund.dev). It provides unified access to 16 public APIs with over 75 endpoints, including:

  • Autobahn - Traffic data, roadworks, webcams

  • Pegel Online - Water level measurements

  • Tagesschau - News from ARD Tagesschau

  • NINA - Emergency warnings and disaster alerts

  • Bundestag - Parliamentary data and videos

  • DWD - Weather warnings from German Weather Service

  • Bundesrat - Federal Council data

  • Feiertage - German public holidays

  • And 8 more APIs...

By default, bund outputs data in German using human-readable templates. All responses are cached locally (XDG-compliant) with appropriate TTLs.

COMMANDS

list

Show all available APIs with descriptions

info api

Show detailed information and available endpoints for a specific API

<api> [action] [args...]

Call an API endpoint. Each API has its own subcommands (actions). Run bund <api> without arguments to see available actions.

OPTIONS

-o, --output format

Output format: template (default), json, yaml

--lang language

Override language: de (default), en, fr, es, it, nl, pl

-t, --template file

Use custom template file instead of built-in templates

-h, --help

Show help message

EXAMPLES

Traffic Information

# List all Autobahns
bund autobahn roads

# Get roadworks on A5
bund autobahn roadworks A5

# Get warnings for A1
bund autobahn warnings A1

Water Levels

# List all measurement stations
bund pegel stations

# Get specific station details
bund pegel station MAINZ

# Get current measurements
bund pegel measurements MAINZ W

News and Weather

# Tagesschau homepage
bund tagesschau homepage

# Search news
bund tagesschau search "Bundestag"

# DWD weather warnings for municipalities
bund dwd municipality-warnings

Emergency Warnings

# NINA warnings for a specific region (ARS code)
bund nina warnings 091620000000

# Get all MOWAS warnings
bund nina mapdata-mowas

Parliamentary Data

# List Bundestag conferences
bund bundestag conferences

# List committees
bund bundestag ausschuesse

# Bundesrat members
bund bundesrat mitglieder renderXml

Other Languages

# Use English output (or use 'bunden' command)
bund --lang en autobahn roads

# French
bund --lang fr autobahn roads

# Get JSON output
bund -o json autobahn roads

CACHE

GET responses are cached in $XDG_CACHE_HOME/www-bund/ (default: ~/.cache/www-bund/).

Cache TTLs vary by endpoint type:

  • 120s - Emergency warnings (NINA, DWD)

  • 300s - Real-time data (traffic, news)

  • 1800s - Moderate updates (webcams, search)

  • 86400s - Static data (station lists, metadata)

LANGUAGE VARIANTS

bund

German interface (default language: de)

bunden

English interface (default language: en)

bundfr

French interface (default language: fr)

bundes

Spanish interface (default language: es)

bundit

Italian interface (default language: it)

bundnl

Dutch interface (default language: nl)

bundpl

Polish interface (default language: pl)

SEE ALSO

WWW::Bund, https://bund.dev

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-www-bund/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.