Skip to main content

Talent Agencies

Get Talent Agency Data

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

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

Example Response
{
"id": 1,
"name": "Example agency",
"short_name": "Agency",
"homepage_url": "https://www.example.com",
"filmmakers_url": "https://www.filmmakers.eu/agents/example-agency",
"imdb_link": "https://pro.imdb.com/company/co0000001",
"imdb_id": "co0000001",
"showreel_url": "https://www.example.com/showreel",
"facebook_page": "my-facebook-page",
"instagram_username": "myinstaprofile",
"public_email": "info@example.com",
"picture_url": "https://imgproxy.filmmakers.eu/bf042068-c6ac-11ee-b970-a34dadd10171.jpg",
"address": {
"city": "Mainz",
"country": "DE",
"fax": null,
"line1": "Wallstr. 11",
"line2": "",
"phone": "49613163691950",
"zipcode": "55122"
},
"employees": [
{
"id": 1,
"first_name": "John",
"last_name": "Doe",
"phone": "49613163691950",
"email": "agent@example.com",
"role": "agent",
"function": null,
"instagram_username": "mypersonalprofile",
"imdb_link": "https://www.imdb.com/name/nm1234567",
"picture_url": "https://imgproxy.filmmakers.eu/bfa9eb4c-c6ac-11ee-9015-f30db07efa43.jpg",
"about_me": "This is a text about me"
}
],
"associations": [
"vda"
],
"about_me": "A text about our agency."
}

This endpoint retrieves a specific talent agency.

HTTP Request

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

URL Parameters

ParameterDescription
IDThe ID of the talent agency to retrieve

Response Fields

FieldTypeDescription
associationsarray of stringsPossible values are: pma, sfaal, vda
about_mestringReturned as plain text (stripped of any rich text formatting). This field is localized. If the locale query parameter is not provided, the API attempts to return the English (en) version of about_me. To request the about_me text in a specific language, use the locale query parameter (e.g., ?locale=de). If the about_me content for the requested locale is not available, it will return null.
employees[].about_mestringReturned as plain text (stripped of any rich text formatting). This field is localized. If the locale query parameter is not provided, the API attempts to return the English (en) version of about_me. To request the about_me text in a specific language, use the locale query parameter (e.g., ?locale=de). If the about_me content for the requested locale is not available, it will return null.

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