AuthorizationOnline RecommendationRecommendation EngineSubscription Management SystemMetaX

Junction TV API

Authorization

This section explains how to access auth token to access JTV API

Resource

Method

Description

POST

  In this section we explain how to get access authentication tokens and implement the API in your apps. Getting a token Authentication tokens is obtained from the JunctionTV OAuth […]

Online Recommendation

APIs to retrieve pre-computed Recommendation data

Resource

Method

Description

GET

This API returns the recommendation weight for a single item for a subscriber. Replace SUBSCRIBER_ID with the subscriber’s unique id and ASSET_ID with the asset’s unique id in order to […]

GET

This API returns a list of subscribers to whom an item should be recommended. Replace ASSET_ID with the unique id of the item to get the recommendations. The return values […]

GET

This API returns a list of recommended items for a subscriber. Replace SUBSCRIBER_ID with the unique id of the subscriber to get the recommendations. The return values are sorted in […]

Recommendation Engine

APIs for invoking the offline recommendation engine services

Resource

Method

Description

POST

This API is called to invoke the recommendation rating computation process in the recommendation engine. The goal is to input a CSV file containing the known ratings for various items […]

GET

This API is used to get the current status of a recommendation computation request. The Request_Id provided as part of the “Compute/Run” response is used as parameter to get the […]

POST

This API is used to stop a running computation process. The Request_Id provided as part of the “Compute/Run” response is POST as the following JSON to this API to stop […]

POST

This API is called to invoke the encoding process in the recommendation engine. The goal is to input a CSV file containing the asset viewing information of the users and […]

GET

This API is used to get the current status of an encoding request. The Request_Id provided as part of the “Encode/Run” response is used as parameter to get the current […]

Subscription Management System

This section explains how to access the JTV APIs related to the Subscription Management System.
Click For Detail Flow

Resource

Method

Description

GET

This API is used to validate the linked Device with the respective user.

GET

This API is used to whether the user exists. basically this API verifies for existing Email ID or Subscriber ID.

GET

This API gets the profile of the User.

POST

This API is used for in app subscription for Android devices.

POST

This API is used for in app subscription in iOS Devices.

Metadata Ingestion APIs

The following APIs are used for ingestion, upsert bulk or single item / title. Metadata can also be pulled from feed provided and can be synced with MetaX.

Resource

Method

Description

PUT

This API is used to upsert (Update/insert) multiple item/ title at a time. If the item already exists it will overwrite the existing item or will insert as a new […]

DELETE

The following API will delete a title/item from the system.

GET

This API will work in Asynchronous manner . It will immediately return “Success” if items are ingested properly. It may take some time to sync with our MetaX system based […]

PUT

This API is used to upsert (Update/insert) a single item/ title. If the item/title already exists it will overwrite the existing item or will insert as a new item.

Shelf and Feed APIs

Feed and feed filter related APIs

Resource

Method

Description

GET

This API returns the Shelves/Strips for the apps to display. The shelves are returned in the order that they should appear on the screen (vertically). If SUBSCRIBER_ID is provided in […]

GET

The API returns a JSON object containing metadata for a particular item as determined by the value of ASSET_ID.

POST

This API is used to filter out a subset of all the items (VoDs or Series) based on the values of multiple tags. It returns an array of JSON objects […]

GET

This API is used to filter out a subset of all the items (VoDs or Series) based on the value of a specific tag. It returns an array of JSON […]

GET

This API provides the capability to create an arbitrary number of recommended shelves for a user. Replace {SUBSCRIBER_ID} by the unique id of the user to get shelves for the […]

Subscriber Activity APIs

Subscribers’ activity related APIs

Resource

Method

Description

GET

Get the list of items that a subscriber has watched partially. Replace SUBSCRIBER_ID with the unique id of the subscriber to get the items that the user has not yet […]

PUT

This API is used to add items to a subscriber’s favorites list. Replace SUBSCRIBER_ID with the unique id of the subscriber and ASSET_ID with the unique id of the item […]

DELETE

This API is called to delete an item from a user’s favorite list. Replace SUBSCRIBER_ID with the subscriber’s unique id and ASSET_ID with the asset’s unique id in order to […]

GET

Get the list of favorite items of a subscriber. Replace SUBSCRIBER_ID with the unique id of the subscriber to get the items that the user has favorited.

PUT

This API is used to bulk-ingest user activity history (favorites-list/watchlist, view details, ratings etc.) of a user. Multiple assets’ activity can be ingested at a time. It accepts a JSON […]

MetaX

Meta-data Exchanger. Version 2.1
The list of APIs provided in this doc are exclusively used for client APP side integration.

Resource

Method

Description

GET

This API returns the Shelves/Strips for the apps to display. The shelves are returned in the order that they should appear on the screen (vertically). If SUBSCRIBER_ID is provided in […]

GET

Get the list of items that a subscriber has watched partially. Replace SUBSCRIBER_ID with the unique id of the subscriber to get the items that the user has not yet […]

PUT

This API is used to add items to a subscriber’s favorites list. Replace SUBSCRIBER_ID with the unique id of the subscriber and ASSET_ID with the unique id of the item […]

DELETE

This API is called to delete an item from a user’s favorite list. Replace SUBSCRIBER_ID with the subscriber’s unique id and ASSET_ID with the asset’s unique id in order to […]

GET

Get the list of favorite items of a subscriber. Replace SUBSCRIBER_ID with the unique id of the subscriber to get the items that the user has favorited.