Back to projects
May 04, 2026
2 min read

Kaufland Discounts - Store Offers CLI & API Client

An unofficial Python client and CLI tool for searching local Kaufland physical stores and querying current promotional offers

An unofficial Python client and CLI utility for retrieving current in-store offers and loyalty discounts from physical Kaufland supermarkets.

Key Capabilities

  • Store Search: Find local Kaufland locations by city name or geographic coordinates.
  • Store Information: Inspect store amenities, payment options, loyalty program support, and opening hours.
  • Promotional Offers: Query all active discounts, standard prices, loyalty card special pricing, and validity periods.
  • Modular Design: Usable either as a standalone command-line tool or as an importable Python library in other automation scripts.

Usage Example

# Search stores and list top 10 current offers
uv run main.py Frankfurt --limit 10