---
title: "Find & Compare Film Festivals Around the World"
slug: film-festivals-around-world
url: https://apyhub.com/ryanvinson/service/film-festivals-around-world
provider: Ryan Vinson
categories: [Geolocation, Standard Data, Travel]
tags: [festivals, event-discovery, film-festivals, search, dataset, rosters]
auth: api_key
---

# Find & Compare Film Festivals Around the World

What it does Festival Listings gives you searchable data on festivals, their categories, countries, deadlines, dates, fees, and roster details. Use the list endpoints to browse festivals with filters for q, genre, state, country, feemax, category, deadlineafter, deadlinebefore, eventdatebefore, and…

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `/festival/countries` | What it does Returns a JSON object with a count integer field and a results array field. Each item… | 1 |
| GET | `/categories` | What it does Returns a JSON object containing a total count and a results array of category objects… | 1 |
| GET | `/festivals/list` | What it does Returns a paginated list of festivals filtered by the optional query parameters. The r… | 1 |
| GET | `/festival/detail/:id` | What it does Retrieves the details for a single festival identified by its path id. The response is… | 1 |
| GET | `/top/scored/festivals` | What it does Returns a paginated list of top scored festivals. The response is a JSON object contai… | 1 |
| GET | `/festivals/:id/roster` | What it does Returns a paginated roster of films for the festival identified by id. The response is… | 1 |

## About

## What it does
Festival Listings gives you searchable data on festivals, their categories, countries, deadlines, dates, fees, and roster details.

Use the list endpoints to browse festivals with filters for `q`, `genre`, `state`, `country`, `fee_max`, `category`, `deadline_after`, `deadline_before`, `event_date_before`, and `submission_platform`. You can also sort by `name`, `deadline`, or `event_date`, and page through results with `page` and `per_page`. Each festival summary includes fields such as `id`, `name`, `country`, `categories`, `genres`, plus optional metadata like `city`, `state`, `website`, `event_dates`, `regular_fee`, `deadline_regular`, `deadline_late`, `event_start_date`, `composite_score`, and `submission_platforms`.

If you need a single record, fetch festival detail by `id` to get the full festival object, including `description`, `fees`, `accepts_awards`, `acceptance_rate`, `year_founded`, `deadline_extended`, `notification_date`, `past_winners`, and `programming_directors` when available. For ranking workflows, the top-scored festivals endpoint returns the same festival summary shape ordered by score.

The country and category endpoints help you build filters and navigation from the dataset itself. The festival roster endpoint returns results for a given festival `id`, with film-level fields like `film_title`, `film_year`, `film_award`, `film_genre`, `film_category`, and `film_director`. That makes Festival Listings useful for festival discovery tools, submission trackers, awards research, and content databases.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/ryanvinson/service/film-festivals-around-world