Attributes

Get All Attributes

cURL

curl "https://www.filmmakers.eu/api/v1/attributes/" \
  -H "Authorization: Token token=API_KEY"

JavaScript (Fetch)

fetch('https://www.filmmakers.eu/api/v1/attributes/', {
  method: 'GET',
  headers: {
    'Authorization': 'Token token=API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP (cURL)

<?php
$url = 'https://www.filmmakers.eu/api/v1/attributes/';
$apiKey = 'API_KEY'; // Replace with your actual API key

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Token token=' . $apiKey,
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    echo $response;
    // For further processing, you might want to decode the JSON:
    // $data = json_decode($response, true);
    // var_dump($data);
}

curl_close($ch);
?>

Ruby (Net::HTTP)

require 'net/http'
require 'json'

api_key = 'API_KEY' # Replace with your actual API key
uri = URI('https://www.filmmakers.eu/api/v1/attributes/')

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Token token=#{api_key}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data

Example Response

[
  "accent_skill",
  "accents",
  "contract_types",
  "dances",
  "dialect_skill",
  "dialects",
  "drivers_licenses",
  "qualification",
  ...
]

This endpoint retrieves all possible profile attributes that are closed lists, such as languages or nationalities, as well as attributes for credits (vita entries).

For countries, ISO 3166-1 alpha-2 codes are used (see here). For federal states (states/subdivisions), ISO 3166-2 codes are used, e.g., for Germany: https://en.wikipedia.org/wiki/ISO_3166-2:DE. Since the ISO lists are standardized (and extensive), they are not present in this endpoint for the time being.

Get Key/Value Pairs for Attributes

cURL

curl "https://www.filmmakers.eu/api/v1/attributes/xxx" \
  -H "Authorization: Token token=API_KEY"

JavaScript (Fetch)

// Replace 'xxx' with the specific attribute key, e.g., 'nationalities'
fetch('https://www.filmmakers.eu/api/v1/attributes/xxx', {
  method: 'GET',
  headers: {
    'Authorization': 'Token token=API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP (cURL)

<?php
// Replace 'xxx' with the specific attribute key, e.g., 'nationalities'
$attributeKey = 'xxx';
$url = 'https://www.filmmakers.eu/api/v1/attributes/' . $attributeKey;
$apiKey = 'API_KEY'; // Replace with your actual API key

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Token token=' . $apiKey,
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    echo $response;
    // For further processing, you might want to decode the JSON:
    // $data = json_decode($response, true);
    // var_dump($data);
}

curl_close($ch);
?>

Ruby (Net::HTTP)

require 'net/http'
require 'json'

# Replace 'xxx' with the specific attribute key, e.g., 'nationalities'
attribute_key = 'xxx'
api_key = 'API_KEY' # Replace with your actual API key
uri = URI("https://www.filmmakers.eu/api/v1/attributes/#{attribute_key}")

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Token token=#{api_key}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data

Example Response

{
  "AD": "Andorran",
  "AE": "United Arab Emirates",
  "AF": "Afghan",
  "AG": "Antigua and Barbuda",
  "AL": "Albanian",
  "AM": "Armenian",
  "AO": "Angolan",
  "AR": "Argentinean",
  "AT": "Austrian",
  "AU": "Australian",
  ...
}

This endpoint retrieves all possible key/value pairs for one of the attributes. Pass one of the supported locales (see above) as a parameter to retrieve localized values.

Contract Types Catalogue

Contract types use stable integer identifiers. Retrieve their localized display labels from the contract_types attribute:

GET https://www.filmmakers.eu/api/v1/attributes/contract_types?locale=en

Example Response

{
  "100001": "DE - Theatrical",
  "100002": "DE - ARD",
  "100004": "DE - ZDF",
  "5228": "SAG - AFTRA"
}

The optional locale parameter controls the labels and defaults to English. JSON object keys are always strings; their numeric values correspond to the integer contract_type identifiers returned by the Casting Calls API.

Qualification Catalogue

Qualifications use stable string keys. Retrieve their localized display labels from the qualification attribute:

GET https://www.filmmakers.eu/api/v1/attributes/qualification?locale=en

Example Response

{
  "certification": "Certification",
  "diploma": "Diploma",
  "bachelors_degree": "Bachelor's degree",
  "masters_degree": "Master's degree",
  "magister": "Magister",
  "other": "Other"
}

The optional locale parameter controls the labels and defaults to English. The keys are returned as qualification values for primary and other professional training in the Actor Profiles API.