GET filmsNowShowing

Description

Returns the top N films now showing, ordered by number of showtimes in database.

Example request

filmsNowShowing/?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 25. Typically there are around 10-15 films on general release at the same time.IntegerOptional

Caching

The returned data can be cached.

Returned data

Returned keyDescription
filmsArray – Containing details of films now showing
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": 209338,
      "film_name": "Fast & Furious 8",
      "release_date": "2017-04-12",
      "age_rating": "12A ",
      "age_rating_image": "https://d2z9fe5yu2p0av.cloudfront.net/age_rating_logos/uk/12a.png",
      "film_trailer": "https://dzm1iom8kpoas.cloudfront.net/209338_high_V2.mp4",
      "synopsis_long": "Now that Dom and Letty are on their honeymoon and Brian and Mia have retired from the game-and the rest of the crew has been exonerated-the globetrotting team has found a semblance of a normal life.  But when a mysterious woman seduces Dom into the world of crime he can't seem to escape and a betrayal of those closest to him, they will face trials that will test them as never before.   \n\nFrom the shores of Cuba and the streets of New York City to the icy plains off the arctic Barents Sea, our elite force will crisscross the globe to stop an anarchist from unleashing chaos on the world's stage... and to bring home the man who made them a family.",
      "images": {
        "poster": {
          "1": {
            "image_orientation": "portrait",
            "region": "US",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/209338/209338h1.jpg",
              "width": 200,
              "height": 300
            }
          }
        },
        "still": {
          "2": {
            "image_orientation": "landscape",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/209338/209338h2.jpg",
              "width": 300,
              "height": 200
            }
          }
        }
      }
    },
    {
      "film_id": 206627,
      "film_name": "Beauty and the Beast",
      "release_date": "2017-03-15",
      "age_rating": "PG ",
      "age_rating_image": "https://d2z9fe5yu2p0av.cloudfront.net/age_rating_logos/uk/pg.png",
      "film_trailer": "https://dzm1iom8kpoas.cloudfront.net/206627_high_V3.mp4",
      "synopsis_long": "The fantastic journey of Belle, a bright, beautiful and independent young woman who is taken prisoner by a beast in his castle. Despite her fears, she befriends the castle's enchanted staff and learns to look beyond the Beast's hideous exterior and realize the kind heart and soul of the true Prince within.",
      "images": {
        "poster": {
          "1": {
            "image_orientation": "portrait",
            "region": "US",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/206627/206627h1.jpg",
              "width": 200,
              "height": 300
            }
          }
        },
        "still": {
          "2": {
            "image_orientation": "landscape",
            "medium": {
              "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/206627/206627h2.jpg",
              "width": 300,
              "height": 200
            }
          }
        }
      }
    }
  ],
  "count": 2,
  "status": {
    "state": "OK",
    "code": 1,
    "method": "filmsNowShowing",
    "message": null,
    "request_method": "GET",
    "version": "MGv102",
    "auth_type": "d"
  }
}