pyventim 1.0.0rc2

A python library to interact with hidden public and private APIs of Eventim.

Pyventim

A Python library for accessing Eventim ticket and event data across multiple markets.

Manifesto

Eventim does not provide a public API like Ticketmaster and other platforms do. This library is an effort to make Eventim data open for public usage by wrapping its hidden public endpoints and falling back to HTML scraping where necessary.

If Eventim publishes official public endpoints, this library will migrate to use them. In the meantime, users are advised to use this library responsibly and to respect Eventim's robots.txt and fair-use expectations.

Due to the nature of web scraping, this library may break without notice. Please open an issue if something stops working.

Installation

Pyventim supports the two most recent stable Python releases, following the Python downloads page. Currently Python 3.13 and 3.14 are supported.

Using pip

pip install pyventim
patchright install chromium

# If needed also install system dependencies
patchright install --with-deps chromium

Using uv

uv add pyventim
uv run patchright install chromium

# If needed also install system dependencies
uv run patchright install --with-deps chromium

Usage

For detailed information and usage refer to the latest documentation!

Getting started

EventimClient supports markets across Europe, Brazil, and Israel. Pass an EventimMarket enum member to select one. See the Markets page in the documentation for the full list.

from pyventim import EventimCategory, EventimClient, EventimMarket

# Initialise a client for Germany
de_client = EventimClient(EventimMarket.GERMANY)

# Search for concerts — product_groups() returns an iterator of events
for product_group in de_client.product_groups(categories=[EventimCategory.CONCERTS], page_limit=2):
    print(product_group.name, product_group.start_date)

    # Fetch individual event dates (tickets, pricing, availability)
    for event in de_client.products(product_group.product_group_id, page_limit=1):
        print("  ", event.name, event.start_date)

# Switch to another market — same API, different catalogue
se_client = EventimClient(EventimMarket.SWEDEN)

for product_group in se_client.product_groups(categories=[EventimCategory.CONCERTS], page_limit=1):
    print(product_group.name)

All methods return typed iterators backed by Pydantic v2 models. Responses are automatically paginated — use page_limit to cap the number of pages fetched.

Contributing

See CONTRIBUTION.md for the full development guide and CODE_OF_CONDUCT.md on how we work together.

Bug reports and feature requests

Open an issue on Codeberg. Templates are provided for bug reports and feature requests.

Development quickstart

Fork the repository on Codeberg, clone your fork, then install all dev dependencies:

uv sync --dev

Then run the quality checks:

# Run tests with coverage
uv run coverage run -m pytest

# Coverage report (must pass 90%)
uv run coverage report -m

# Docstring coverage (must pass 100%)
uv run interrogate -c pyproject.toml src

# Lint and format
uv run ruff check src tests
uv run ruff format src tests

License

This project is licensed under the GPL-3.0. See LICENSE.md for details.

Maintainers

• kggx: [e-mail] / [e-mail]

Acknowledgements

• Contributor Covenant have an awesome code of conduct!
• All contributors and maintainers of open source software that we use. Most notably but not limited to: Python, pypi, Astral (uv, ruff) , pytest, Pydantic, Scrapling, Coverage, Interrogate, genbadge and Zensical.