Method name
GET trailers
Description
Returns URL’s for the trailers for a single specific film.
Example request
trailers/?film_id=12345
Required headers
Sent header | Description | Data type | Optional / Mandatory |
---|---|---|---|
None | None | None | None |
Sent Arguments
Sent argument | Description | Data type | Optional / Mandatory |
---|---|---|---|
film_id | The MovieGlu numeric internal film ID | Integer | Mandatory |
Caching
The returned data can be cached.
Returned data
trailers | Object – Containing trailer information |
quality | Name varies depending on quality displayed (e.g. High or Medium) |
film_trailer | Location of latest trailer released for film |
trailer_image | Location of suggested image for trailer overlay |
version | Version number (where multiple trailers have been released, highest number being the most recent trailer version) |
quality | High (Default), others if available |
region | Local trailer, eg UK. If not availble then a default trailer from the US is provided. |
Example response
{
"trailers": {
"high": [
{
"film_trailer": "https://dzm1iom8kpoas.cloudfront.net/227902_uk_high.mp4",
"trailer_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h3.jpg",
"version": 1,
"quality": "high",
"region": "UK"
}
],
"med": [
{
"film_trailer": "https://dzm1iom8kpoas.cloudfront.net/227902_uk_med.mp4",
"trailer_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h3.jpg",
"version": 1,
"quality": "med",
"region": "UK"
}
]
},
"status": {
"count": 2,
"state": "OK",
"method": "trailers",
"message": null,
"request_method": "GET",
"version": "MGv200",
"territory": "UK",
"device_datetime_sent": "2018-09-14T14:56:20.695Z",
"device_datetime_used": "2018-09-14 14:56:20"
}
}