Skip to content

Content Discovery Overview#

The Seatback SDK provides the Content Discovery module, which allows passengers to browse media content such as movies, tracks, TV series, and more on the seatback monitor. This module enables passengers to search for content based on genre, category, and other criteria. The Content Discovery function is similar to the Metadata module CA SDK.

Content Discovery Overview

The diagram above illustrates the basic structure of media metadata, which may differ based on the specific configuration set by each airline.

1. Get data by categories#

1.1. Get a list of categories by the content scope#

The Content Discovery API provides various types of metadata to cater to different content needs, such as media and marketplace. As a first step, it is essential to select the type of metadata you want to display. This choice determines the scope of content that the API will retrieve and categorize.

For example, if you choose the media metadadata type, the API will return categories specifically related to media content. These categories can include movies, TV shows, music, games, and even some airline-specific content tailored for in-flight entertainment systems.

1.2. Get a list of categories with root category#

A list of subcategories can be retrieved for a specific root category, like Movies. This functionality helps identify and organize the various subcategories within the root, streamlining content classification and display. For example, within the root category Movies, subcategories such as New Releases, Hollywood, Action/Adventure, and others are accessible. This functionality is designed to support a hierarchical structure for content browsing. Organizing content into meaningful groupings allows users to efficiently locate their desired content. For instance, individuals seeking newly released films or action movies can directly access the relevant subcategory, avoiding unrelated content.

2. Get data using Search APIs#

There are two ways to search the metadata in Content Discovery

2.1. Search metadata using the text#

The API provides robust search capabilities that allow users to search for content based on a specific input text across multiple fields. These fields include title, genre, year, artist, actor, and director, ensuring that the input is matched across all relevant metadata. Importantly, all these fields are searched equally, meaning the system does not prioritize one field over another, providing comprehensive search results.

In addition to this general search functionality, the API allows users to refine their search by specifying a content type. For example, by default, the API searches across all content types, such as movies, TV Series, music, and more. However, if the user specifies a particular content type, such as movies, the search results will be restricted to that category only.

Example Use Case:

  • General Search: A user searches for "Inception," and the system searches all content types, returning results like the movie "Inception" and a soundtrack album titled "Inception Soundtrack."

  • Refined Search: The user specifies the content type as movies, and the system filters the results to show only movie-related matches, such as the movie "Inception."

This dual approach ensures flexibility and precision, allowing users to either explore broadly or focus their search on a specific type of content, improving the overall user experience.

2.2. Search metadata using the field#

Search operations can be performed using predefined fields such as title, genre, year, artist, actor, and director. These fields enable querying specific attributes of the content. Additionally, the search functionality supports combining multiple fields for more refined filtering. For example, to retrieve a list of items directed by a specific director (e.g., "XYZ") and released in a particular year (e.g., 2025), a query can be constructed that includes both the director and year fields. This capability allows users to effectively narrow their search results by applying multiple criteria simultaneously.

3. Get data by tag#

To retrieve metadata based on tags, the process involves two key steps:

3.1. Fetch Available Tags#

First, we need to access a list of predefined tags. These tags represent various metadata attributes associated with the content type, such as:

  • Actor

  • Category

  • Channel

  • Critic Score

  • Director

  • Genre

  • Rating, and more.

These tags act as filters that help in organizing and categorizing the content.

3.2. Retrieve Items Associated with a Tag#

After selecting a specific tag, the Content Discovery API provides a list of all items linked to that tag. For instance, if we select the genre tag, the API will return a list of all available genres relevant to the chosen content type.

3.3. Get metadata using a tag#

This tag is useful for retrieving a list of items associated with it, enabling efficient filtering or categorization of content.

4. Get an Item List#

4.1. Get a list of items with a specific category, genre, actor, etc#

A list of items can be retrieved and organized by their categories, which are predefined within the metadata bundle and linked to a specific root category, such as Movies. For example, the Movies root category may include subcategories like New Releases, Hollywood, Action, Biography, and others.

These subcategories enable the presentation of curated lists of items grouped under their respective categories. This structured organization simplifies content management and enhances the user experience by allowing viewers to easily locate their preferred type of content. For instance, users seeking action-packed entertainment can navigate directly to the Action category, while those interested in biographies can explore the Biography section.

4.2. Get a list of items based on the content type#

A list of items can be retrieved based on their content type, enabling the display of all items within a specific root category in the In-Flight Entertainment (IFE) system. For instance, to present a list of all available movies, this functionality can be utilized to load only items categorized as Movies. An API method is available to provide a list of all supported content types within the IFE system. This method allows the identification of relevant content types, facilitating efficient metadata retrieval based on the specified categories.

5. Get item details#

Detailed information about a specific item can be retrieved, including its description, duration, genre, cast (actors and directors), list of subtitles, soundtracks, and additional metadata. This information is typically presented on the synopsis page before the user launches or plays the item. Providing such detailed metadata enhances the user experience by offering context and enabling users to make informed choices about what they want to watch or listen to.

This feature is especially useful for users exploring content, as it offers a comprehensive overview of the selected item. For albums or TV series, the metadata also includes a list of associated content, such as individual songs in an album or episodes within a series, further enriching the content discovery process.

Version 1.0