Showreels

Get a Specific Showreel

cURL

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

JavaScript (Fetch)

fetch('https://www.filmmakers.eu/api/v1/showreels/{id}', {
  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
$showreelId = '{id}'; // Replace with the actual showreel ID
$apiKey = 'API_KEY'; // Replace with your actual API key
$url = "https://www.filmmakers.eu/api/v1/showreels/" . $showreelId;

$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'

showreel_id = '{id}' # Replace with the actual showreel ID
api_key = 'API_KEY' # Replace with your actual API key
uri = URI("https://www.filmmakers.eu/api/v1/showreels/#{showreel_id}")

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

Replace {id} with the ID of the showreel you want to retrieve.

Example Response

{
  "id": 100,
  "showreel_type": "video",
  "name": "Showreel 2024",
  "position": 1,
  "poster_copyright": "Photographer XYZ",
  "download": true,
  "showreel_medium_ids": [
    123456,
    123457,
    123458,
    123459,
    123460
  ],
  "poster": "https://imgproxy.filmmakers.eu/8f7c74be-c696-11ee-85a8-4781e0bae8b1.jpg"
}

This endpoint retrieves a specific showreel.

HTTP Request

GET https://www.filmmakers.eu/api/v1/showreels/<ID>

URL Parameters

Parameter	Description
ID	The ID of the showreel to retrieve (refer to the showreel_ids array field from the actor profiles endpoint to obtain these IDs)

Response Fields

See the example response above for an overview of included fields.

Field	Type	Description
id	integer	ID of the showreel
showreel_type	string	Either video or audio
name	string	Name of the showreel
position	integer	The position of the showreel on Filmmakers
poster	string	Image URL to the showreel poster/thumbnail
poster_copyright	string	Copyright for the showreel poster/thumbnail
download	boolean	Whether the download option is active on Filmmakers
showreel_medium_ids	array	IDs of showreel media contained in the showreel (see showreel_media endpoint below)