Python client for the Festival API — film festival data for developers
Project description
Festival API — Python Client
Client library for the Festival API.
pip install festivalapi
Usage
from festivalapi import FestivalAPI
client = FestivalAPI("fda_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("fda_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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
festivalapi-0.2.0.tar.gz
(4.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file festivalapi-0.2.0.tar.gz.
File metadata
- Download URL: festivalapi-0.2.0.tar.gz
- Upload date:
- Size: 4.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d26c4685076cbf48d3f627b26c9e0102b440750b7d9a4793218294d5a7d96714
|
|
| MD5 |
3c4f7eb3d3852768123c5c63a3373d06
|
|
| BLAKE2b-256 |
1e7acfd218aaebafb2b0e9b238408a183caa07cc8b7123239f807dbb2932924c
|
File details
Details for the file festivalapi-0.2.0-py3-none-any.whl.
File metadata
- Download URL: festivalapi-0.2.0-py3-none-any.whl
- Upload date:
- Size: 4.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2f28707c1851924971ea3c7d39d5b7e640806b4b3c6e4608c809b0930d447e8c
|
|
| MD5 |
2d12b3884a7e75f9b57b6c21d18adc8b
|
|
| BLAKE2b-256 |
256d749276967eb29552778309ede7999d814297a10ed3e409758f6b3f6a3946
|
