DOCSEARCHbyAlgolia
Submit Docs

Filmmakers API

website·Indexed 40 days ago

https://api.filmmakers.eu

A RESTful JSON API for accessing filmmaker data, including actor and crew profiles, showreels, casting calls, and talent agency information. Features OAuth and token-based authentication, RFC-8288 standard pagination, and CORS support.

Tokens
11K
Snippets
52
Records
80
Agent score
62%

What's inside Filmmakers

  1. Overview of Filmmakers Webhooks

    Filmmakers webhooks notify your server about actor profile events. To use webhooks, you must provide a publicly accessible HTTPS endpoint that allows unauthenticated POST requests. Note: Webhooks are currently in a limited availability phase; contact support to enable them.

  2. Overview of filmmakers.eu API endpoints

    The API provides access to various resources including actor and crew profiles, talent agencies, blog posts, showreels, messages, and casting calls.
    - GET /attributes             -> List all available attributes
- GET /attributes/{key}       -> Get key/value pairs for a specific attribute
- GET /actor_profiles         -> List all actor profiles
- GET /actor_profiles/{id}    -> Get a specific actor profile
- GET /crew_profiles          -> List all crew profiles
- GET /crew_profiles/{id}      -> Get a specific crew profile
- GET /talent_agencies/{id}    -> Get talent agency information
- GET /blog_posts             -> List all blog posts
- GET /blog_posts/{id}        -> Get a specific blog post
- GET /showreels/{id}          -> Get a specific showreel
- GET /showreel_media/{id}     -> Get specific showreel media
- GET /messages               -> List all messages (Beta)
- GET /messages/{id}           -> Get a specific message (Beta)
- GET /casting_calls           -> List all casting calls (Beta)
- GET /casting_calls/{id}      -> Get a specific casting call (Beta)

  3. Casting Call response object schema

    The Casting Call object contains details about a specific casting call, including its visibility, production format, and associated roles. Note: The Casting Calls API is currently in beta/early preview and may undergo changes.
    {
  "id": "integer",
  "name": "string",
  "description": "string",
  "deadline": "datetime",
  "visibility": "string (public or private)",
  "deadline_visible": "boolean",
  "production_format": "string or null",
  "casting_type": "string (breakdown, ecasting, or studio_casting)",
  "production_id": "integer",
  "working_permits": "array",
  "regions": "array",
  "casting_director": "object",
  "production_locations": "array",
  "filmmakers_url": "string",
  "created_at": "datetime",
  "updated_at": "datetime",
  "roles": "array"
}

  4. Understand the response fields for Showreel Media

    When retrieving specific showreel media via the API, the response contains details about the video or audio asset. Key fields include id, type (either ShowreelVideo or ShowreelAudio), name, and duration (in seconds).

    For ShowreelVideo types, the proxies array provides MP4 (H.264) transcoded links in various qualities: sd (480p), hd (720p), and full_hd (1080p). Legacy proxies web_quality and portrait may also be present.

    For ShowreelAudio types, the asset field contains the audio file link (typically AAC or MP3 codecs).

    Note: The skill field is deprecated; use the skills array instead, which follows the NAME#VALUE format (e.g., languages#deutsch).

    {
  "id": 12345,
  "type": "ShowreelVideo",
  "name": "Demo Reel 2023",
  "director": "Jane Doe",
  "role": "Lead Actor",
  "year": 2023,
  "download": true,
  "duration": 120.5,
  "skills": ["languages#deutsch", "dialects#berlinerisch"],
  "vita_entry_id": 6789,
  "picture": "https://example.com/thumb.jpg",
  "proxies": [
    { "quality": "sd", "url": "..." },
    { "quality": "hd", "url": "..." },
    { "quality": "full_hd", "url": "..." }
  ]
}

  5. Understand Actor Profile response fields

    The Actor Profile API response includes detailed information about the actor's representation, visibility, and professional history.

    Talent Agency Connections

    Agency details are provided in the talent_agency_connections array. Each entry contains:

    • talent_agency_id (integer): ID of the agency.
    • talent_agency_employee_id (integer): ID of the specific employee.
    • agency_profile_url (string): The actor's profile URL on the agency's own website.
    • talent_agency_name (string): Name of the agency.
    • categories (Array): Representation areas (e.g., acting_agency, advertising, artist_management, model_agency, people_agency, pr, voice_agency, young_talent_agency).
    • regions (Array): Geographical regions of representation. Valid values are available via the /attributes endpoint.
    • connection_type (string): Either primary_agency or secondary_agency.

    Visibility and Media

    • attribute_visibility (hash): Specifies if attributes like age, acting_age, gender, ethnic_appearances, figures, and working_permits are public or private (visible only to verified casting professionals).
    • profile_visibility (string): Overall profile visibility (public or private).
    • showreel_ids (Array): IDs of associated showreels.
    • showreel_medium_ids (Array): IDs of showreel media connected to showreels, credits, or skills.

    Professional History

    • vita (hash): A collection of structured credits grouped by type (e.g., education, television, theatre). Entries are sorted by in_development status, date range (year_to/year_from descending), user-defined position, and ID.

    Deprecation Notices

    Avoid using the following top-level fields; use the talent_agency_connections array instead:

    • agency_profile_url $ ightarrow$ use talent_agency_connections[].agency_profile_url
    • talent_agency_id $ ightarrow$ use talent_agency_connections[].talent_agency_id
    • representative.id $ ightarrow$ use talent_agency_connections[].talent_agency_employee_id
    • representative.name $ ightarrow$ use the talent_agency#employees endpoint for first/last names.

  6. Showreel media response schema

    The response for a specific showreel media request returns an object containing metadata about the asset, including the director, role, year, duration, and available video proxies (SD, HD, and Full HD).
    {
  "id": 123456,
  "type": "ShowreelVideo",
  "name": "Faking Bullshit",
  "director": "Alexander Schubert",
  "role": "Rocky",
  "year": 2019,
  "download": true,
  "duration": "171.6",
  "skills": [
    "languages/deutsch"
  ],
  "vita_entry_id": 300,
  "skill": "languages/deutsch",
  "picture": "https://imgproxy.filmmakers.eu/8f7c74be-c696-11ee-85a8-4781e0bae8b1.jpg",
  "asset": null,
  "proxies": {
    "sd": "https://static.filmmakers.eu/production/0fd099dc-c698-11ee-93cb-cb381089a4e7.mp4",
    "hd": "https://static.filmmakers.eu/production/107a9e6e-c698-11ee-8895-f34d7095f1f5.mp4",
    "full_hd": "https://static.filmmakers.eu/production/109d0832-c698-11ee-b7b8-fb95fd1a375c.mp4"
  }
}

  7. Retrieve localized 'About Me' text for actor profiles

    The about_me field is localized. By default, the API returns the English (en) version. To retrieve the text in a different language, use the locale query parameter (e.g., ?locale=de). If the requested locale is unavailable, the field returns null. For rich text, use about_me_html, which returns sanitized HTML (supporting tags like <a>, <b>, <div>, <img>, etc.).
    GET /actor-profiles?locale=de

  8. Retrieve a specific casting call by ID

    Retrieve detailed information about a specific casting call, including production details, casting director, locations, and associated roles.

    Note: The filmmakers_url returned in the response points to the web page for the casting call. This URL requires the user to be authenticated and authorized on the Filmmakers platform to be accessed; it can be used as a redirect_to payload in an SSO login flow.

    curl "https://www.filmmakers.eu/api/v1/casting_calls/{id}" \
  -H "Authorization: Token token=API_KEY"

  9. Retrieve specific showreel media by ID

    Use the GET /api/v1/showreel_media/{id} endpoint to retrieve detailed information about a specific showreel media asset. The required {id} can be obtained from the showreel_medium_ids array field returned by the showreels endpoint. Authentication requires a Token in the Authorization header.
    curl "https://www.filmmakers.eu/api/v1/showreel_media/{id}" \
  -H "Authorization: Token token=API_KEY"

  11. Obtain an OAuth Access Token via Client Credentials

    For clients with OAuth Authorization enabled, you can fetch an access token by sending a POST request to the token endpoint. This requires a CLIENT_ID and CLIENT_SECRET. The grant_type must be set to client_credentials.
    export CLIENT_ID="your-client-id-goes-here"
export CLIENT_SECRET="your-client-secret-goes-here"

curl -s -X POST "https://www.filmmakers.eu/oauth/token" \
           -H "Content-Type: application/x-www-form-urlencoded" \
           --data-urlencode "grant_type=client_credentials" \
           --data-urlencode "client_id=$CLIENT_ID" \
           --data-urlencode "client_secret=$CLIENT_SECRET" \
           --data-urlencode "scope=public"

  12. Handle actor profile picture ordering and display

    The pictures array in an actor profile is returned in desktop/landscape order. To display pictures for mobile/portrait contexts, sort the array by the portrait_position field.

    Key picture fields:

    • position: Base gallery order before display-specific adjustments.
    • landscape_position: Position in desktop order (the default API return order).
    • portrait_position: Position in mobile/portrait order.
    • main_picture: Boolean; true if this is the primary picture for desktop (landscape_position: 1).
    • main_picture_portrait: Boolean; true if this is the primary picture for mobile (portrait_position: 1).

    To access the image, use the url field or an entry from the versions array on the selected picture object.