Quickstart

Get up and running with the Filmmakers API in minutes.

Prerequisites

Before you begin, you'll need an API key. Request one through our support page.

Make Your First Request

Once you have your API key, you can make your first API call. Let's retrieve a list of actor profiles:

cURL

curl "https://www.filmmakers.eu/api/v1/actor_profiles?per_page=5" \
  -H "Authorization: Token token=YOUR_API_KEY"

JavaScript (Fetch)

const API_KEY = 'YOUR_API_KEY';

fetch('https://www.filmmakers.eu/api/v1/actor_profiles?per_page=5', {
  headers: {
    'Authorization': `Token token=${API_KEY}`
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP (cURL)

<?php
$apiKey = 'YOUR_API_KEY';
$url = 'https://www.filmmakers.eu/api/v1/actor_profiles?per_page=5';

$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);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Ruby (Net::HTTP)

require 'net/http'
require 'json'

api_key = 'YOUR_API_KEY'
uri = URI('https://www.filmmakers.eu/api/v1/actor_profiles?per_page=5')

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

note

Replace YOUR_API_KEY with your actual API key.

Understanding the Response

A successful response returns a JSON array of actor profiles:

[
  {
    "id": 12345,
    "display_name": "Jane Doe",
    "gender": "female",
    "profile_url": "https://www.filmmakers.eu/actors/jane-doe",
    "thumbnail_url": "https://...",
    ...
  },
  ...
]

Pagination

List endpoints return paginated results. Check the Link header for navigation:

Link: <https://www.filmmakers.eu/api/v1/actor_profiles?page=2>; rel="next"

Use the page and per_page parameters to navigate:

curl "https://www.filmmakers.eu/api/v1/actor_profiles?page=2&per_page=25" \
  -H "Authorization: Token token=YOUR_API_KEY"

See Pagination for more details.

Next Steps

• Browse the API Reference for a complete list of endpoints
• Learn about Authentication options including OAuth
• Explore Actor Profiles and Crew Profiles endpoints
• Check Rate Limits to understand usage limits