Integration

Festival API Python Client

Install the official Python client from PyPI and work with festivals, scores, categories, countries, and roster data in a few lines of code.

Best for backend services, notebooks, recurring research jobs, and internal tools in Python.

View on PyPI View Docs

Why use the Python client

The Python client removes repetitive request plumbing so you can focus on discovery workflows, shortlist logic, and reporting. It wraps authentication and common endpoints into a clean interface that works well for product backends, analyst notebooks, cron jobs, and internal film-industry tooling.

What you can do with this client

Clean Python interface
Search festivals, pull scored results, and retrieve roster or category data through one lightweight client.
Fast setup
Install from PyPI and start calling Festival API in minutes with your existing Python stack.
Good fit for research workflows
Use it inside submission tools, enrichment jobs, notebooks, and recurring reports without custom boilerplate.

Popular Python workflows

  • ✓Festival shortlist generators for consultants and agencies
  • ✓Backend services for filmmaker platforms and discovery tools
  • ✓Editorial enrichment jobs for directory and guide pages
  • ✓Notebook-based analysis of festival coverage and Festival Score

Typical Python setup

  1. Install the package from PyPI.
  2. Create a FestivalAPI client with your API key.
  3. Call list, scored, roster, countries, or categories methods.
  4. Use the response inside your app, notebook, scheduled job, or internal dashboard.

Quick start

Python
from festivalapi import FestivalAPI

client = FestivalAPI("fes_your_api_key")

festivals = client.festivals.list(category="short_film")
scored = client.festivals.scored(min_score=70)
roster = client.festivals.roster(301)
countries = client.countries()

Why use the client instead of raw requests?

The client is faster to adopt, easier to read, and less error-prone for teams already working in Python. You still keep full API flexibility, but with cleaner code and less setup friction.

Useful supporting assets

Ship Festival API faster in Python

The official Python client is the fastest path from API interest to working code in scripts, services, and data workflows.

View on PyPI View Docs

Prefer a hand with the build? Our team can implement it for you.

Explore more integrations

Festival API Node.js Client

View page

Festival API for Apify

View page

Festival API on RapidAPI

View page

Festival API on APIDog

View page

Festival API on Apyhub

View page

Festival API for Zapier

View page

Festival API for n8n

View page

Festival API on API.market

View page