l2calendar (Python)

Minimal, dependency-free Python client for the public L2 Calendar API — a free, read-only JSON feed of Lineage 2 private server openings by chronicle.

• Standard library only (urllib) — no requests, no dependencies.
• No API key, no auth. The API sends Access-Control-Allow-Origin: *.
• Python 3.8+, ships with py.typed.

Install

pip install l2calendar

Quick start

from l2calendar import get_servers, get_chronicles

servers = get_servers(chronicle="interlude", only_upcoming=True, limit=10)
for server in servers:
    print(server["name"], server["rate"], server["opening_date"], server["website_url"])

chronicles = get_chronicles()  # [{"id": 1, "name": "Interlude", "slug": "interlude", ...}, ...]

API

Errors raise L2CalendarError with an optional .status.

Server shape

{
    "name": str,
    "website_url": str,
    "rate": str,                  # "x5", "x1000", "GvE"
    "opening_date": str,          # "2026-02-28"
    "opening_time": str | None,
    "opening_datetime_utc": str | None,
    "description": str | None,
    "is_vip": bool,
    "vip_level": int,
    "multiproff": bool,
    "multicraft": bool,
    "is_new": bool,
    "chronicle": {"name": str, "slug": str} | None,
    "labels": [{"name": str, "slug": str, "color": str}],
}

Note: the public API returns a single page of up to 50 servers (VIP first, then soonest opening). limit, rate and upcoming filters run client-side over that page — narrow with chronicle for precision.

Data source

• GET https://l2calendar.com/api/servers — optional ?chronicle=<slug>.
• GET https://l2calendar.com/api/chronicles.

About L2 Calendar

A multilingual (EN/ES/PT/RU) calendar and tracker of Lineage 2 private server openings by chronicle — l2calendar.com.

License

MIT © Dreiev