Markets¶

What is a market?¶

Eventim operates separate regional platforms for each country it serves. Each platform has its own:

• Domain (e.g. eventim.de, eventim.se, lippu.fi)
• Event catalogue — most events are listed only in the country where they take place
• Currency and pricing
• Language (the metadata returned in API responses reflects the local language)

pyventim calls these platforms markets.

The EventimMarket enum¶

Every EventimClient is initialised with an EventimMarket enum member that identifies the market:

from pyventim import EventimClient, EventimMarket

de_client = EventimClient(EventimMarket.GERMANY)   # Germany
se_client = EventimClient(EventimMarket.SWEDEN)    # Sweden

Each EventimMarket member carries two attributes:

• web_id — the internal Eventim identifier used by the public API
• base_url — the root domain of the market's website, used by the private API

You rarely need to access these directly; they are passed automatically to the underlying fetchers when the client is constructed.

Markets¶

One client per market¶

There is no single "global" client. To query multiple markets you create one EventimClient instance for each:

from pyventim import EventimClient, EventimMarket, EventimCategory

clients = {
    "de": EventimClient(EventimMarket.GERMANY),
    "se": EventimClient(EventimMarket.SWEDEN),
}

for market, client in clients.items():
    for pg in client.product_groups(categories=[EventimCategory.CONCERTS], page_limit=1):
        print(market, pg.name)