Film Festival Data API

Search and retrieve structured data on 900+ film festivals worldwide — submission deadlines, fees, categories, genres, composite scores, acceptance rates, submission platforms, and past programming rosters.

Powered by Festival API.

---

🎯 What you can do with this Actor

Use Case	How
Find festivals with upcoming deadlines	Run Search Festivals filtered by deadline date
Get full details on a specific festival	Run Get Festival Detail with a Festival ID
Discover top-ranked festivals by score	Run Get Top Scored Festivals
See what films screened at a festival	Run Get Festival Roster with a Festival ID
Explore available categories	Run Get Categories
See festival coverage by country	Run Get Countries
Feed an AI agent with film festival data	This Actor is compatible with Apify's MCP server for AI-agent tool calling

---

🗺️ Coverage

900+ film festivals across 80+ countries worldwide, from major international film festivals (Cannes, Sundance, TIFF, Berlin, Venice) to niche regional events. Data includes:

• Festival names, locations, and edition years
• Submission deadlines (regular, late, extended)
• Fees and submission platforms (FilmFreeway, Festival, Festhome, Direct)
• Categories (short film, feature, documentary, animation, horror, etc.)
• Genres (drama, comedy, horror, thriller, sci-fi, etc.)
• Festival scores, acceptance rates, and year founded
• Past winners and programming directors
• Historical programming rosters (films that screened)

Data is regularly refreshed from publicly available festival sources.

---

🚀 How to use it

1. Select an Operation

Operation	Description	Input Needed
🔍 Search Festivals	Search and filter festivals by name, country, category, genre, deadline, fee	Search query, country, category, genre, deadline, fee
🎬 Get Festival Detail	Full detail on one festival — deadlines, fees, description, past winners	Festival ID
🏆 Get Top Scored Festivals	Festivals ranked by composite Festival Score	Category (optional)
📜 Get Festival Roster	Films that screened at a specific festival	Festival ID
📂 Get Categories	List all festival categories with counts	None
🌍 Get Countries	List all countries with festival counts	None

2. Configure Filters

• Festival ID — numeric ID from Search Festivals results
• Country — filter by country name (e.g. United States, Canada, Australia)
• Category — filter by category (e.g. short_film, feature, documentary)
• Genre — filter by genre (e.g. drama, comedy, horror)
• Deadline Before — filter by submission deadline date (YYYY-MM-DD)
• Max Fee — maximum submission fee in USD
• Sort — sort by deadline or event_date
• Max Results — max items to return (up to 100)

3. Run and Export

Once the Actor finishes, you can:

• View results as a table in the Apify Console
• Export as JSON, CSV, Excel, XML, or RSS
• Schedule recurring runs (daily, weekly)
• Connect via webhook to push results into your own system

---

📊 Sample Output

Each result row includes:

Field	Type	Example
operation	string	search_festivals
id	integer	372
name	string	"Sundance Film Festival"
city	string	"Park City"
state	string	"UT"
country	string	"United States"
year	integer	2025
categories	string	"feature, documentary, short_film"
genres	string	"drama, comedy, horror"
deadline_regular	string	"2025-08-15"
event_dates	string	"January 22 - February 1, 2025"
regular_fee	number	45.0
composite_score	number	85.0
acceptance_rate	number	0.02
submission_platforms	string	"filmfreeway, direct"
website	string	"https://festival.com"
_raw	object	Full API response data

---

🤖 AI Agent Usage

This Actor is compatible with Apify's MCP server, making it callable by AI agents and applications. An agent can:

• Find festivals with upcoming deadlines in a specific country or category
• Get full details on a festival before recommending submission
• Compare festival scores across multiple festivals
• Look up past programming to understand what films a festival has selected

This makes the Actor a natural tool for filmmaker assistants, film festival directories, educational tools about the festival circuit, and content discovery applications.

---

💰 Pricing

This Actor uses pay-per-event pricing based on the operation type:

Tier	Operations	Price per result
Light	Search Festivals, Get Categories, Get Countries	$0.005
Heavy	Festival Detail, Top Scored Festivals, Festival Roster	$0.01

Results are counted per row pushed to the dataset. A search returning 25 festivals = 25 result charges. A single festival detail = 1 result charge.

---

📝 Notes

• Data is as-is from publicly available festival sources. Always verify critical details (deadlines, fees, dates) on the festival's official website before submitting.
• Festival Scores range from 0 to 100. Higher scores = more established/prestigious festivals.
• Deadlines are subject to change by festival organizers. The API tracks regular, late, and extended deadlines when available.
• Coverage is continuously expanding — new festivals and countries are added regularly.

---

🔗 Links

• Festival API Website
• API Documentation
• Terms of Service
• Contact Support