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"
}
}