1. Introduction

Movies Anywhere (MA) is a platform for the Studios to drive movie purchases by engaging movie fans throughout the entire lifecycle of a film via rich, franchise-based interaction across multiple device touch points. This document provides a detailed overview of the OEM Title APIs for providing MA managed data to outside providers.

2. APIs

2.1. Request Header

Authorization

Optional JWT token to retrieve trailer data. Only authorized titles will have trailer data included.

2.2. Get All Titles

Returns all MA eligible titles.

2.2.1. Request

HTTP
GET /v1/title HTTP/1.1
Host: api.moviesanywhere.com
Authorization: {jwt_token}
cURL
$ curl 'https://api.moviesanywhere.com/v1/title' -i -X GET -H 'Authorization: {jwt_token}'
HTTPie
$ http GET 'https://api.moviesanywhere.com/v1/title' Authorization:{jwt_token}

2.3. Get Title by EIDR

Returns the title having the given EIDR.

2.3.1. Parameter

eidr

EIDR of the title

2.3.2. Request

HTTP
GET /v1/title?eidr={eidr} HTTP/1.1
Host: api.moviesanywhere.com
Authorization: {jwt_token}
cURL
$ curl 'https://api.moviesanywhere.com/v1/title?eidr={eidr}' -i -X GET -H 'Authorization: {jwt_token}'
HTTPie
$ http GET 'https://api.moviesanywhere.com/v1/title?eidr={eidr}' Authorization:{jwt_token}

2.4. Get Title by ID

Returns the title having the given ID.

2.4.1. Parameter

id

MA identifier

2.4.2. Request

HTTP
GET /v1/title/{id} HTTP/1.1
Host: api.moviesanywhere.com
cURL
$ curl 'https://api.moviesanywhere.com/v1/title/{id}' -i -X GET
HTTPie
$ http GET 'https://api.moviesanywhere.com/v1/title/{id}'

2.5. Get Title by ID Minified

Returns the title having the given ID.

2.5.1. Request Header

Authorization

Basic authentication.

2.5.2. Parameter

id

MA identifier

2.5.3. Request

HTTP
GET /v1/title/mini/{id} HTTP/1.1
Host: api.moviesanywhere.com
cURL
$ curl 'https://api.moviesanywhere.com/v1/title/mini/{id}' -i -X GET
HTTPie
$ http GET 'https://api.moviesanywhere.com/v1/title/mini/{id}'

2.5.4. Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

{
    "results": [
        {
            "title": "DCU: Batman and Harley Quinn",
            "slug": "/movie/dcu-batman-and-harley-quinn",
            "boxart": "//int-images.moviesanywhere.io/9085572a8cd3e9c1939c1deb680780b6/ccd98761-3487-400d-8ff6-f4ef7e201cf7"
        }
    ],
    "total": 1
}

2.6. Get Titles by Studio

Returns titles from the given studio

2.6.1. Parameter

studio

Studio name. Currently recognized studios are: Disney, Fox, Lionsgate, Sony, Universal, and WB.

2.6.2. Request

HTTP
GET /v1/title/studio/{studio} HTTP/1.1
Host: api.moviesanywhere.com
cURL
$ curl 'https://api.moviesanywhere.com/v1/title/studio/{studio}' -i -X GET'

2.6.3. Response

The response format is the same for all endpoints, unless specified.

HTTP/1.1 200 OK
Pragma: no-cache
X-XSS-Protection: 1; mode=block
Expires: 0
X-Frame-Options: DENY
X-Content-Type-Options: nosniff
Content-Length: 1069
Content-Type: application/json;charset=UTF-8
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
Cache-Control: no-cache, no-store, max-age=0, must-revalidate

{
  "results": [
    {
      "title": "Jumanji: Welcome To The Jungle",
      "id": "2253906a-7af2-4bed-b7e2-beb7e58de7cc",
      "eidr": "10.5240/9933-893D-EB42-5E88-0474-4",
      "adamid": "1315255745",
      "profile": "UHD",
      "rating": "PG-13",
      "runtime": "119",
      "genres": [ "Action", "Sci-Fi", "Adventure", "Franchise", "Blockbuster" ],
      "slug": "/movie/jumanji-welcome-to-the-jungle",
      "releaseDate": "2017-12-04",
      "boxart": "//stage-images.moviesanywhere.io/26e32cd9770bf2ec963bdf7eeb594d0a/291cf54f-1798-48a1-b4e3-fc05f56230fd",
      "heroImage": "//stage-images.moviesanywhere.io/0913d6a70858dc919553eb024bb97c94/31e91dfa-6160-4ed5-aefb-e9e871761513",
      "hasPromoContent": true,
      "hasBonusContent": true,
      "description": "In this fun comedic adventure, 4 teens get sucked into the video game world of Jumanji and have to finish the dangerous game to escape.",
      "shortSynopsis": "In this fun comedic adventure, 4 teens get sucked into the video game world of Jumanji and have to finish the dangerous game to escape.",
      "mediumSynopsis": "Four teenagers in detention discover an old video console with a game they’ve never heard of. When they decide to play, they are immediately sucked into the jungle world of Jumanji in the bodies of their avatars (Dwayne Johnson, Jack Black, Kevin Hart, and Karen Gillan). They’ll have to complete the adventure of their lives filled with fun, thrills and danger or be stuck in the game forever!",
      "longSynopsis": "Four teenagers in detention discover an old video console with a game they’ve never heard of. When they decide to play, they are immediately sucked into the jungle world of Jumanji in the bodies of their avatars (Dwayne Johnson, Jack Black, Kevin Hart, and Karen Gillan). They’ll have to complete the adventure of their lives filled with fun, thrills and danger or be stuck in the game forever!",
      "copyrightInfo": "© 2017 Columbia Pictures Industries , Inc.  All Rights Reserved.",
      "credits": [
        { "name": "Dwayne Johnson", "creditType": "Cast" },
        { "name": "Jack Black", "creditType": "Cast" },
        { "name": "Kevin Hart", "creditType": "Cast" },
        { "name": "Karen Gillan", "creditType": "Cast" }
      ],
      "trailers": [
        {
          "id": "fa6fab76-89b0-46e7-a539-ae6e3868f26b",
          "title": "Jumanji: Welcome To The Jungle Trailer",
          "window": null,
          "assets": [
            {
              "id": "fd11a41f-ecfa-43c7-9561-09d8484c1998",
              "type": "Biff",
              "url": "https://media-ma-sony.akamaized.net/bif/6b/fa6fab76-89b0-46e7-a539-ae6e3868f26b/1518137351609/fa6fab76-89b0-46e7-a539-ae6e3868f26b_1518137351609_3.bif",
              "tags": [ "high-res" ]
            },
            {
              "id": "18632a15-cfef-4412-8035-4cb3246b882d",
              "type": "Video",
              "url": "https://media-ma-sony.akamaized.net/hls/6b/fa6fab76-89b0-46e7-a539-ae6e3868f26b/presentation.m3u8?v=1541545933295&r=hdp",
              "tags": [ "fairplay", "hdp", "hls" ]
            }
          ]
        }
      ],
      "studios": [
        { "name": "Sony" }
      ]
    }
  ],
  "total": 1
}
Response Fields
Path Type Description

total

Number

Total title count

results[].title

String

Movie Title

results[].id

String

MA Identifier

results[].eidr

String

EIDR Edit

results[].adamid

String

Apple ADAMID

results[].profile

String

highest playable profile in MA - SD, HD, UHD

results[].rating

String

MPAA rating

results[].runtime

String

Movie length

results[].genres

Array

list of genres

results[].slug

String

link for a movie into the app or web

results[].releaseDate

String

Theatrical release date

results[].boxart

String

see 2.4 for info on image urls

results[].heroImage

String

see 2.4 for info on image urls

results[].hasPromoContent

Boolean

has associated promotional content in MA

results[].hasBonusContent

Boolean

has bonus content in MA

results[].description

String

Deprecated use shortSynopsis

results[].shortSynopsis

String

Movie description (max 190 characters)

results[].mediumSynopsis

String

Movie description (max 400 characters)

results[].longSynopsis

String

Movie description (max 4000 characters)

results[].copyrightInfo

String

Legal / copyright information

results[].credits

Array

List of cast and crew

results[].credits[].name

String

Name of the credited person

results[].credits[].creditType

String

Type of credit - Cast, Writers, Directors, Producers

results[].trailers

Array

List of trailers

results[].trailers[].id

String

MA identifier

results[].trailers[].title

String

Trailer title

results[].trailers[].window

String

Availability window

results[].trailers[].assets

Array

List of trailer assets

results[].trailers[].assets[].id

String

MA identifier

results[].trailers[].assets[].type

String

Asset type

results[].trailers[].assets[].url

String

Asset URL

results[].trailers[].assets[].tags

String

Asset metadata

results[].studios

Array

List of studios

results[].studios[].name

String

Studio name

2.6.4. Response Errors

400

Bad request

500

Unexpected error

503

Service not available

2.7. Image URLs

The image URL is returned as a base URL and will need information appended to get the image in the format and size you need.

2.7.1. Example

//images.moviesanywhere.com/d46c387e7eaf87c99dbfdbcc13ff7a47/93f54094-8c0a-4b45-a914-4175fd8df238

2.7.2. Format

[protocol]//[base_url].[format] ? r=[aspect_ratio] & w=[width]|h=[height]

format

jpg, png, webp

aspect_ratio

2x3 for boxart; 16x9, 3x1, 1x1 for thumbnails

2.7.3. Working Examples:

Images are bucketed on our CDN, so you will get the closest (larger) size match at the correct aspect ratio. For example, the first example above gives the expected 200x300 image, but the second gives a bucketed 800x266 instead of the expected 750x250.