# Filmfreeway — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover film festivals worldwide with detailed information including deadlines, submission categories, fees, rules, and organizer contacts. Access comprehensive festival profiles, photos, and grant opportunities listed on FilmFreeway.

**Category:** Entertainment | **Website:** [filmfreeway.com/](https://filmfreeway.com/) | **Docs:** [parse.bot/marketplace/d5bde951-45a0-4792-86f2-3b816d9eb99c/filmfreeway-com-api](https://parse.bot/marketplace/d5bde951-45a0-4792-86f2-3b816d9eb99c/filmfreeway-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_festival_categories_and_fees

Fetch submission categories and their associated fee schedules for a festival by its slug. Each category lists fees per deadline tier (early, regular, final, extended) with standard and Gold Member pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Festival URL slug (e.g. 'NantucketFilmFestival'). Obtainable from search_festivals results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/get_festival_categories_and_fees \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_festival_details

Fetch comprehensive details for one festival by its slug. Returns description, deadlines, submission categories with fees, rules, awards, organizers, and contact info. The slug is available from search_festivals or search_festivals_by_category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Festival URL slug (e.g. 'NantucketFilmFestival'). Obtainable from search_festivals results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/get_festival_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_festival_photos

Fetch the photo gallery for a festival. Returns an array of photo objects with dimensions and captions. May be empty if the festival has no uploaded photos.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Festival URL slug (e.g. 'NantucketFilmFestival'). Obtainable from search_festivals results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/get_festival_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_festival_rules

Fetch only the Rules & Terms text for a festival by its slug. Returns null if the festival has no published rules. Lighter than get_festival_details when only rules are needed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Festival URL slug (e.g. 'NantucketFilmFestival'). Obtainable from search_festivals results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/get_festival_rules \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_festivals

Full-text search over film festivals. Returns paginated summaries (up to 50 per page). Omitting the query returns all festivals ordered by relevance. Each summary carries the slug needed to fetch full details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword (e.g. 'grant', 'documentary'). Omitting returns all festivals. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/search_festivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### search_festivals_by_category

Filter festivals by film submission category. Returns paginated summaries of festivals that accept submissions in the specified categories. Categories can be combined (comma-separated) for broader results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `categories` | string | Yes | Comma-separated list of category names to filter by. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-filmfreeway-com-api-d5bde951/search_festivals_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categories":"<string>","page":"<integer>"}'
```