OEM Title API

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

Either basic auth or JWT token is now required to use the service endpoints. Only authorized users (based on JWT token) and titles will have trailer data included.

If you have a way to obtain MA JWT tokens please continue to use them, but if you need a basic auth login please contact the MA development team .
Example requests below only show the use of JWT tokens.

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
Authorization: {jwt_token}

cURL

$ curl 'https://api.moviesanywhere.com/v1/title/{id}' -i -X GET -H 'Authorization:{jwt_token}'

HTTPie

$ http GET https://api.moviesanywhere.com/v1/title/{id} Authorization:{jwt_token}

2.5. Get Title by ID Minified

Returns the title having the given ID.

2.5.1. Parameter

`id`	MA identifier

2.5.2. Request

HTTP

GET /v1/title/mini/{id} HTTP/1.1
Host: api.moviesanywhere.com
Authorization: {jwt_token}

cURL

$ curl 'https://api.moviesanywhere.com/v1/title/mini/{id}' -i -X GET -H 'Authorization:{jwt_token}'

HTTPie

$ http GET https://api.moviesanywhere.com/v1/title/mini/{id} Authorization:{jwt_token}

2.5.3. Sample 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 IDs Minified

Returns the titles having the given IDs.

2.6.1. Parameter

ids

Comma separated list of title IDs

2.6.2. Request

HTTP

GET /v1/title/mini?ids={id1,id2, ...}
Host: api.moviesanywhere.com
Authorization: {jwt_token}

cURL

$ curl 'https://api.moviesanywhere.com/v1/title/mini?ids={id1,id2, ...}' -i -X GET -H 'Authorization:{jwt_token}'

HTTPie

$ http GET https://api.moviesanywhere.com/title/mini?ids={id1,id2, ...} Authorization:{jwt_token}

2.6.3. Sample response

{
  "results": [
    {
      "title": "Shrek",
      "slug": "/movie/shrek",
      "boxart": "//images.moviesanywhere.com/5948f139cd669fb5984d2c782e7678be/99cedd1f-ae78-4026-a3e8-b79840b71cbc"
    },
    {
      "title": "Shrek 2",
      "slug": "/movie/shrek-2",
      "boxart": "//images.moviesanywhere.com/c00ca7fef488c1183492c241f24fd06d/182eae84-827d-4330-8222-688fe77e516d"
    }
  ],
  "total": 2
}

2.7. Get Titles by Studio

Returns titles from the given studio

2.7.1. Parameter

studio

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

2.7.2. Request

HTTP

GET /v1/title/studio/{studio} HTTP/1.1
Host: api.moviesanywhere.com
Authorization: {jwt_token}

cURL

$ curl 'https://api.moviesanywhere.com/v1/title/studio/{studio}' -i -X GET -H 'Authorization:{jwt_token}'

HTTPie

$ http GET https://api.moviesanywhere.com/v1/title/studio/{studio} Authorization:{jwt_token}

2.8. Response format

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

2.8.1. Sample

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

2.8.2. Response Fields

Path Type Description

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

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.8.3. Response Errors

400	Bad request
401	Unauthorized
500	Unexpected error
503	Service not available

2.9. 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.9.1. Example

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

2.9.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.9.3. Working Examples:

https://images.moviesanywhere.com/d46c387e7eaf87c99dbfdbcc13ff7a47/93f54094-8c0a-4b45-a914-4175fd8df238.png?r=2x3&w=200

https://images.moviesanywhere.com/8bdf984901192bea8bd076067a8c4a73/75cc4615-bab5-4d1a-9950-383f8e2d2398.jpg?r=3x1&w=750

https://images.moviesanywhere.com/8bdf984901192bea8bd076067a8c4a73/75cc4615-bab5-4d1a-9950-383f8e2d2398.webp?r=1x1&h=300

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.