GET filmsComingSoon

Description

Return the top N films coming soon ordered by release date and number of showtimes in database (where available)

Example request

filmsComingSoon/?n=10

Required headers

Sent headerDescriptionData typeOptional / Mandatory
NoneNoneNoneNone

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
nLimit the number of returned results. Default is 10, System max is 15.IntegerOptional

Caching

The returned data can be cached.

Returned Data

Returned KeyDescription
filmsArray – Containing details of films coming soon
film_idThe MovieGlu numeric internal film ID
film_nameThe film name
release_dateThe release date of the film in format YYYY-MM-DD
age_ratingAge rating for film
age_rating_imageAge rating image location
imagesLocation and details of primary images for film.
Please refer to the GET Images for format.
NOTE: Only the film poster and one still will be returned.
film_trailerLocation of latest trailer released for film
synopsis_longLong version of film synopsis (Usually 600 chars or less in most cases, but sometimes more)

Example response


{
  "films": [
    {
      "film_id": 191861,
      "film_name": "Guardians of the Galaxy Vol. 2",
      "release_date": "2017-04-28",
      "age_rating": null,
      "age_rating_image": "https://d2z9fe5yu2p0av.cloudfront.net/age_rating_logos/uk/uc.png",
      "film_trailer": "https://dzm1iom8kpoas.cloudfront.net/191861_high_V3.mp4",
      "synopsis_long": "Peter Quill and his team search for his long-lost father in this sequel to the hit 2014 sci-fi adventure film.",
      "images": {
        "poster": {
          "1": {
            "image_orientation": "portrait",
            "region": "US",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/191861/191861h1.jpg",
              "width": 200,
              "height": 300
            }
          }
        },
        "still": {
          "2": {
            "image_orientation": "landscape",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/191861/191861h2.jpg",
              "width": 300,
              "height": 200
            }
          }
        }
      }
    },
    {
      "film_id": 237175,
      "film_name": "The Sense of an Ending",
      "release_date": "2017-04-14",
      "age_rating": "15 ",
      "age_rating_image": "https://d2z9fe5yu2p0av.cloudfront.net/age_rating_logos/uk/15.png",
      "film_trailer": "https://dzm1iom8kpoas.cloudfront.net/237175_high.mp4",
      "synopsis_long": "Tony Webster leads a reclusive and quiet existence until long buried secrets from his past force him to face the flawed recollections of his younger self, the truth about his first love and the devastating consequences of decisions made a lifetime ago.",
      "images": {
        "poster": {
          "1": {
            "image_orientation": "portrait",
            "region": "US",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/237175/237175h1.jpg",
              "width": 200,
              "height": 300
            }
          }
        },
        "still": {
          "2": {
            "image_orientation": "landscape",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/237175/237175h2.jpg",
              "width": 300,
              "height": 200
            }
          }
        }
      }
    }
  ],
  "count": 2,
  "status": {
    "state": "OK",
    "code": 1,
    "method": "filmsComingSoon",
    "message": null,
    "request_method": "GET",
    "version": "MGv102",
    "auth_type": "d"
  }
}