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 headerDescriptionData typeOptional / Mandatory
NoneNoneNoneNone

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
film_idThe MovieGlu numeric internal film IDIntegerMandatory

Caching

The returned data can be cached.

Returned data

trailersObject – Containing trailer information
qualityName varies depending on quality displayed (e.g. High or Medium)
film_trailerLocation of latest trailer released for film
trailer_imageLocation of suggested image for trailer overlay
versionVersion number (where multiple trailers have been released, highest number being the most recent trailer version)
qualityHigh (Default), others if available
regionLocal 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"
    }
}