festivalapi 0.2.1

Python client for the Festival API — film festival data for developers

Festival API — Python Client

Client library for the Festival API.

pip install festivalapi

Usage

from festivalapi import FestivalAPI

client = FestivalAPI("fes_your_api_key")

# Search festivals
festivals = client.festivals.list(category="short_film")

# Get festival detail
festival = client.festivals.get(1)

# Get festival roster
roster = client.festivals.roster(1)

# Get scored festivals
scored = client.festivals.scored(min_score=70)

# List categories (no auth required)
categories = client.categories()

# Health check (no auth)
client.health()

API Key

Sign up at festivalapi.com to get your API key. You can also set the FESTIVALAPI_KEY environment variable.

Error Handling

from festivalapi import FestivalAPI, NotFoundError, InsufficientCreditsError

client = FestivalAPI("fes_your_api_key")

try:
    festival = client.festivals.get(999999)
except NotFoundError:
    print("Festival not found")
except InsufficientCreditsError as e:
    print(f"Need more credits: {e}")

Requirements

• Python 3.9+
• Zero dependencies (uses only stdlib urllib)

License

MIT