{ "openapi": "3.0.1", "info": { "title": "FilmFreeway Festival Scraper", "description": "FilmFreeway Festival Scraper extracts public film-festival listings, submission deadlines, category-specific entry fees, event dates, venues, ratings, and qualification badges from FilmFreeway.", "version": "0.0", "x-build-id": "aTatfqL7OKieF0l5e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hypebridge~filmfreeway-festival-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hypebridge-filmfreeway-festival-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/hypebridge~filmfreeway-festival-scraper/runs": { "post": { "operationId": "runs-sync-hypebridge-filmfreeway-festival-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/hypebridge~filmfreeway-festival-scraper/run-sync": { "post": { "operationId": "run-sync-hypebridge-filmfreeway-festival-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "FilmFreeway directory, curated collection, or festival profile URLs. Direct profile URLs always receive full detail extraction.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxFestivals": { "title": "Maximum festivals", "minimum": 1, "maximum": 15000, "type": "integer", "description": "Hard cap on returned festivals.", "default": 100 }, "getFestivalDetails": { "title": "Get deadlines and entry fees", "type": "boolean", "description": "Visit each profile for full dates, categories, and fee tiers. Direct profile URLs ignore this toggle.", "default": false }, "openSubmissionsOnly": { "title": "Open submissions only", "type": "boolean", "description": "Restrict generated searches to festivals currently accepting entries.", "default": true }, "searchQuery": { "title": "Search keyword", "type": "string", "description": "Free-text festival search." }, "deadlineBefore": { "title": "Entry deadline before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Return festivals with an entry deadline before this date." }, "deadlineAfter": { "title": "Entry deadline after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Return festivals with an entry deadline after this date." }, "eventDateBefore": { "title": "Event date before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Return festivals taking place before this date." }, "eventDateAfter": { "title": "Event date after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Return festivals taking place after this date." }, "projectCategories": { "title": "Project categories", "type": "array", "description": "Project types accepted by the festival.", "items": { "type": "string", "enum": [ "1", "3", "30", "5", "7", "9", "26", "11", "31", "25", "13", "15", "17", "19" ], "enumTitles": [ "Animation", "Documentary", "Experimental", "Feature", "Music Video", "Short", "Student", "Television", "Virtual Reality", "Web / New Media", "Screenplay", "Short Script", "Stage Play", "Television Script" ] }, "default": [] }, "niches": { "title": "Genres and niches", "type": "array", "description": "Festival genre filters.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16" ], "enumTitles": [ "Action / Adventure", "Asian", "Black / African", "Children", "Comedy", "Dance", "Environmental / Outdoor", "Horror", "Human Rights", "Indigenous / Native Peoples", "Latino / Hispanic", "LGBTQ", "Religious", "Sci-fi / Fantasy / Thriller", "Sports", "Women" ] }, "default": [] }, "maxEntryFee": { "title": "Maximum entry fee", "minimum": 0, "maximum": 100, "type": "integer", "description": "Approximate FilmFreeway server-side fee filter." }, "academyAwardQualifyingOnly": { "title": "Academy Award qualifying only", "type": "boolean", "description": "Only Academy Award qualifying festivals.", "default": false }, "goldDiscountOnly": { "title": "FilmFreeway Gold discount only", "type": "boolean", "description": "Only festivals with Gold discounts.", "default": false }, "countries": { "title": "Countries", "type": "array", "description": "Country names matched against listing locations.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "all_deadlines", "final_deadline", "first_deadline", "popular", "rating", "recent", "price_low", "price_high", "years", "event_date", "tickets_available" ], "type": "string", "description": "FilmFreeway directory sort order.", "default": "all_deadlines" }, "curatedCollection": { "title": "Curated collection", "enum": [ "academy-award-qualifying-festivals", "top-100-best-reviewed-festivals", "most-popular", "trending-now", "gold", "filmfestivalalliance", "short-film", "documentary", "horror", "sci-fi", "screenwriting", "visionaries", "luminaries", "in-the-spotlight", "tickets-available" ], "type": "string", "description": "Use one verified FilmFreeway curated collection when Start URLs is empty." }, "enumerateFromSitemap": { "title": "Enumerate from sitemap", "type": "boolean", "description": "Enumerate the corpus directly, still capped by Maximum festivals.", "default": false }, "maxConcurrency": { "title": "Maximum sticky sessions", "minimum": 1, "maximum": 3, "type": "integer", "description": "One worker is bound to each validated residential identity. Capped at three to bound memory, proxy churn, and request rate.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Untargeted Apify Residential proxy is the tested default. Each validated session retains one IP, cookie jar, and Chrome wire fingerprint.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Save at most 20 failing HTML and metadata artifacts.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }