Junction TV API | Related Movies Feed

This API returns a list of related movies.

Resource URL

GET - /metax/2.1/recos/similar/{ASSET_ID}

Header Paramater

Authorization

required

Bearer Access Token

NOTE: Access Token here refers to the access authorization token.

URL Parameter

ASSET_ID

required

Asset ID is the unique ID of an asset.

Form Parameter

subId

optional

Subscriber ID (e.g. user@example.org) If subscriber ID is present, then the details object may contain personalized info like pauseTime, isFavorite etc.

size

optional

Json size will be max or min.

device

optional

Type of the device. (e.g. roku, iphone, ipad, android-mobile, android-tab, web etc.) If this value is present, the MetaX will send the meta-data for that device only. (e.g. thumbnail

Example Request URL

GET - http://__JTV_HOST__/metax/2.1/recos/similar/NVGA1234567/?subid=__SUBSCRIBER__ID__&device=__JTV__DEVICE__CODE__&size=__JTV__JSON__SIZE__

Example Return

[
  {
    id: "NNNN100011111",
    title: "Fly My Kite",
    type: "episode",
    episode: 1,
    subscriber_type: "registered",
    description: "A greedy man trying to get rid of his mother-in-law by putting her in an old folk's home discovers she has a fortune in stock certificates.",
    duration: 1243743,
    cuepoints: "0,1,536,967",
    season: 1,
    metax_added_on: 1458635766647
  },
  {
    id: "CEE10022222",
    title: "Highway to Heaven: Part 1",
    type: "episode",
    episode: 1,
    subscriber_type: "registered",
    description: "In this pilot episode, Jonathan aids the residents of a retirement home being sold.",
    duration: 2944775,
    cuepoints: "0,1,632,1243,1737,2514",
    season: 1,
    metax_added_on: 1458635775584
  },
  {
    id: "GGG10011122",
    title: "Highway to Heaven: Part 2",
    type: "episode",
    episode: 2,
    subscriber_type: "registered",
    description: "In this second-part of the pilot episode, Jonathan aids the residents of a retirement home being sold.",
    duration: 3024863,
    cuepoints: "0,1,458,914,1494,2272",
    season: 1,
    metax_added_on: 1458635775593
  },
  {
    id: "NVVV10334344",
    title: "Hi Neighbor/A Lad and a Lamp",
    type: "episode",
    episode: 2,
    subscriber_type: "registered",
    description: "See the gang take on two adventures as they race down a precarious hill in their homemade fire engine and find Aladdin's magical lamp.",
    duration: 2026893,
    cuepoints: "0,1,475,1012",
    season: 1,
    metax_added_on: 1458635766655
  }
]

[

{

id: "NNNN100011111",

title: "Fly My Kite",

type: "episode",

episode: 1,

subscriber_type: "registered",

description: "A greedy man trying to get rid of his mother-in-law by putting her in an old folk's home discovers she has a fortune in stock certificates.",

duration: 1243743,

cuepoints: "0,1,536,967",

season: 1,

metax_added_on: 1458635766647

{

id: "CEE10022222",

title: "Highway to Heaven: Part 1",

type: "episode",

episode: 1,

subscriber_type: "registered",

description: "In this pilot episode, Jonathan aids the residents of a retirement home being sold.",

duration: 2944775,

cuepoints: "0,1,632,1243,1737,2514",

season: 1,

metax_added_on: 1458635775584

{

id: "GGG10011122",

title: "Highway to Heaven: Part 2",

type: "episode",

episode: 2,

subscriber_type: "registered",

description: "In this second-part of the pilot episode, Jonathan aids the residents of a retirement home being sold.",

duration: 3024863,

cuepoints: "0,1,458,914,1494,2272",

season: 1,

metax_added_on: 1458635775593

{

id: "NVVV10334344",

title: "Hi Neighbor/A Lad and a Lamp",

type: "episode",

episode: 2,

subscriber_type: "registered",

description: "See the gang take on two adventures as they race down a precarious hill in their homemade fire engine and find Aladdin's magical lamp.",

duration: 2026893,

cuepoints: "0,1,475,1012",

season: 1,

metax_added_on: 1458635766655

}

]

The response of a invalid authorization access call ( Status #401) will look as follows:-

{
    result: "error",
    message: "UNAUTHORIZED",
    reason: "No Authorization Token"
}

{

result: "error",

message: "UNAUTHORIZED",

reason: "No Authorization Token"

}

To see how to get access token - (see Getting Access Tokens)

The response of an ERROR in authorization access call ( Status #404) will look as follows:-

HTTP Status 404

Related Movies Feed

Resource URL

Header Paramater

Authorization

URL Parameter

ASSET_ID

Form Parameter

subId

size

device

Example Request URL

Example Return

The response of a invalid authorization access call ( Status #401) will look as follows:-

The response of an ERROR in authorization access call ( Status #404) will look as follows:-

JunctionTV