top

Meta Data Feed Requirements

This guide describes the meta data structure required to enable users to browse and search for your media content using the Universal Guide and Search features on Samsung Smart TVs.

To enable your media content to appear in the Samsung Smart TV Universal Guide and Search features, you must provide meta data in the required format.

The meta data feed consists of 2 types of information:

  • The "programs" parameter stores a list of Program structures.
    Each Program structure contains information related to a media program, such as a TV series episode or sports event.
  • The "persons" parameter stores a list of Person structures.
    Each Person structure contains biographical information about a person appearing in the media content, such as cast and production members.

For an example of a meta data feed containing program and person information, see Sample Feed.

The meta data feed has the following basic formatting and delivery requirements:

  • File format
    The data feed must be defined in JSON or XML format. To enable quicker file transfer, compress the data feed files in GZIP format.

  • File name
    To ensure that the most recent version of the data feed is retrieved, use the following file naming convention:

    • "your_xml_feed_file_name_YYYYMMDD_HHMMSS.xml.gz"
    • "your_json_feed_file_name_YYYYMMDD_HHMMSS.json.gz"
  • Delivery
    The data feed must be delivered through HTTP or the Amazon S3 service. Make the feed publicly available or supply the necessary credentials to access the feed.

  • Update frequency
    Only a pull-based delivery mechanism is supported. It is currently not possible to automatically push the data feed to Samsung nor notify Samsung about feed updates. You must provide a schedule of when and how often the feed must be downloaded in order to obtain the latest data.

  • Feed content
    The data feed file must contain the full feed content, even if you provide multiple feeds each day. Samsung feed ingestion currently does not process change-sets or deltas.

Program Data Structure

The following table describes the Program data structure, which defines information about a media program.

Table 1. Program data structure parameters
Parameter Type Mandatory Description
"ids"
List
True
Unique identifiers for the program
Defined with the ProgramId data structure.
"external_ids"
False
Unique identifiers for the program from other content providers, used to match the program to existing programs in the database
Defined with the ExternalProgramId data structure.
"titles"
True
Program titles for the Smart TV on-screen UI, also used to match the program to existing programs in the database
Defined with the Title data structure.
"descriptions" Program descriptions for the Smart TV on-screen UI.
Defined with the Description data structure.
"images" Program images for the Smart TV on-screen UI.
Defined with the Image data structure.
"parental_ratings" Program content ratings, as assigned by national content rating organizations
Defined with the ParentalRating data structure.
"ratings"
False
Program quality ratings, such as from critics and reviewers
Defined with the Rating data structure.
"type"
String
True
Program type:
  • "episode"
  • "event"
  • "movie"
  • "other"
  • "season"
  • "show"
  • "sport"
"sub_type"
False
Program sub-type:
  • "miniseries"
  • "series"
  • "shortfilm"
  • "special"
  • "sportsevent"
  • "sportsnonevent"
  • "tvmovie"
"genres"
List
True
Program genres for the Smart TV on-screen UI, also used to categorize the program in the database. Define the genres as a list of strings, in decreasing order of importance.
For the complete list of genre strings, see Genre Parameter Strings.
"air_date"
String
False
Original broadcast date for the program in UTC time, in "YYYY-MM-DDThh:mm:ssTZD" format
Example: "2016-12-15T20:30:00Z"
"release_date"
True
Release date for the program, in "YYYY" or YYYY-MM-DD format
Examples: "2016", "2016-12-15"
"running_time"
Integer
False
Program running time, in seconds
"series_related_info"
JSON
Series, season, and episode number
Mandatory for "show", "season", and "episode" program types.
Defined with the SeriesRelatedInfo data structure.
"content_items"
List
True
Media content items available for playback, including playback options and availability
Defined with the ContentItem data structure.
"isExclusive"
String
False
Whether the program is exclusive to a specific content provider:
  • "Yes"
  • "No"
"production_company" Production company name for the program
"members"
JSON
True
Cast and production credits for the program
Defined with the Member data structure.
"broadcast"
False
If the program is a TV broadcast, the broadcaster information
Defined with the Broadcast data structure.
"sport_data" Detailed sports program information
Defined with the SportData data structure.

The Program data structure can contain the following data structures:

  • ProgramId
    The ProgramId structure defines a unique identifier for the program.

    Table 2. ProgramId data structure parameters
    Parameter Type Mandatory Description
    "id"
    String
    True
    Program unique ID
    "id_type"
    False
    If the content provider uses multiple IDs for the same content, the ID type.
    Example:
    {
      "ids": [
        {
          "id": "12335",
          "id_type": "v1"
        }
      ]
    }
    
  • ExternalProgramId
    The ExternalProgramID data structure defines an ID for the program from other content providers, enabling the Samsung database to cross-reference and match it to existing database entries.

    Table 3. ExternalProgramId data structure parameters
    Parameter Type Mandatory Description
    "id"
    String
    True
    Provider's program unique ID
    "id_type"
    False
    If the content provider uses multiple IDs for the same content, the ID type. For example, the Tribune/Gracenote ("tms") service uses the "tmsId" and "rootId" types.
    "provider"
    True
    Content provider name
    Supported values:
    • "facebook"
    • "imdb"
    • "rovi"
    • "twitter"
    • "tms"

    Example:

    {
      "external_ids": [
        {
          "id": "EP123",
          "id_type": "tmsId",
          "provider": "tms"
        }
      ]
    }
    
  • Title
    The Title data structure defines the program title. You can define long and short titles for multiple languages.

    Table 4. Title data structure parameters
    Parameter Type Mandatory Description
    "title"
    String
    True
    Program title
    "language" Title language, in ISO 639-1 format (2-letter language codes with optional 2-letter sub-codes)
    "type" Title type:
    • "main"
    • "short"
    "length"
    Integer
    False
    Title length, in characters

    Example:

    { 
      "titles": [ 
        { 
          "title": "Game of Thrones", 
          "language": "en", 
          "type": "main", 
          "length": 15 
        } 
      ] 
    } 
    
  • Description
    The Description data structure defines the program description. You can define long and short descriptions for multiple languages.

    Table 5. Description data structure parameters
    Parameter Type Mandatory Description
    "description"
    String
    True
    Program description
    "language" Description language, in ISO 639-1 format (2-letter language codes with optional 2-letter sub-codes)
    "type" Description type:
    • "main"
    • "short"
    "length"
    Integer
    False
    Description length, in characters

    Example :

    {
      "descriptions": [
        {
          "description": "Game of Thrones is roughly based on the storylines of A Song of Ice and Fire, set in the fictional Seven Kingdoms of Westeros and the continent of Essos. The series chronicles the violent dynastic struggles among the realm's noble families for the Iron Throne, while other families fight for independence from it.",
          "language": "en",
          "type": "main",
          "length": 313
        }
      ]
    }
    
  • Image
    The Image data structure defines representative images for the program. You can define images for multiple languages.
    For each program, you must provide an image for each of the "banner", "iconic", and "poster" image types:

    • Banner image with text, such as the program title
      16:9 aspect ratio, landscape orientation, minimum 1920x1080 px
    • Iconic image without text
      16:9 aspect ratio, landscape orientation, minimum 1920x1080 px
    • Poster image
      2:3 aspect ratio, portrait orientation, minimum 1000x1500 px
    Table 6. Image data structure parameters
    Parameter Type Mandatory Description
    "url"
    String
    True
    Full public image URL
    "width"
    Integer
    Image width, in pixels
    "height" Image height, in pixels
    "type"
    String
    Image type:
    • "banner"
    • "iconic"
    • "poster"
    "language"
    False
    Image language, in ISO 639-1 format (2-letter language codes with optional 2-letter sub-codes).
    Define the image language if the image contains text, or if you want to show a different image for users with a specific device language setting.

    Example:

    {
      "images": [
        {
          "url": "https://stmed.net/sites/default/files/game-of-thrones-wallpapers-31571-9933778.jpg",
          "width": 1920,
          "height": 1080,
          "type": "Banner",
          "language": "en"
        },
        {
          "url": "https://www.pixelstalk.net/wp-content/uploads/images/emilia_clarke_jon_snow_game_of_thrones_season_7-1920x1080.jpg",
          "width": 1920,
          "height": 1080,
          "type": "Iconic",
          "language": "en"
        },
        {
          "url": "https://images-na.ssl-images-amazon.com/images/I/81IXojwauiL.jpg",
          "width": 600,
          "height": 900,
          "type": "Poster",
          "language": "en"
        }
      ]
    }
    
  • ParentalRating
    The ParentalRating data structure defines the program content rating, as assigned by a national content rating organization.
    You can define ratings for multiple countries and organizations.

    Table 7. ParentalRating data structure parameters
    Parameter Type Mandatory Description
    "country_codes"
    List
    True
    Countries to which the rating applies, in ISO 3166-1 format (2-letter country codes), as a list of strings
    "body"
    String
    Rating organization that issued the rating
    "code" Content rating code issued by the organization

    The following rating organizations and codes are supported:

    Table 8. Content rating organizations and codes
    Country Program type Rating organization Rating codes
    US
    Movie
    Motion Picture Association of America G, PG, PG-13, R, NC-17
    US
    Show
    USA Parental Rating TV-Y, TV-Y7, TV-G, TV-PG, TV-14, TV-MA
    KR
    Movie or show
    Korean TV Rating ALL, 7+, 12+, 15+, 19+
    UK
    BBFC U, PG, 12, 12A, 15, 15A, 18, R18, NR
    FR
    CNC Tous, 10, 12, 16, 18
    DE
    FSK FSK 0, FSK 3, FSK 6, FSK 12, FSK 16, FSK 18
    ES
    MCU 7, 10, 12, 13, 16, 18, iA, A, X
    IT
    MiBAC 10, 12, 14, 16, 18, T
    IN
    CBFC U, U/A, A, S

    Example:

    {
      "parental_ratings": [
        {
          "country_codes": [
            "US",
            "GU"
          ],
          "body": "Motion Picture Association of America",
          "code": "PG-13"
        }
      ]
    }
    
  • Rating
    The Rating data structure defines the program quality, as rated by content critics and reviewers. You can define multiple critical ratings.

    Table 9. Rating data structure parameters
    Parameter Type Mandatory Description
    "body"
    String
    True
    Organization that determined the rating
    "type" Rating score type. Some organizations provide multiple scores based on various criteria.
    "score"
    Float
    Rating score received by the program. The value must use 2 decimal digits.
    Examples: 99.00, 50.55, 100.00
    "num_votes"
    Integer
    Optional
    Number of votes used to calculate the rating score

    Example :

    {
      "ratings": [
        {
          "body": "Metacritic",
          "type": "metascore",
          "score": 96.00,
          "num_votes": 3146
        }
      ]
    }
    
  • SeriesRelatedInfo
    The SeriesRelatedInfo data structure is required if the program type is "show", "season", or "episode", used to organize the content into groups based on series and seasons.

    Table 10. SeriesRelatedInfo data structure parameters
    Parameter Type Mandatory Description
    "series_id"
    String
    True
    Unique ID for the related series program
    "season_id" Unique ID for the related season program
    "season_number"
    Integer
    False
    Season number for the program
    Mandatory if the program type is "season" or "episode".
    "episode_number" Episode number for the program
    Mandatory if the program type is "episode".

    Example:

    {
      "series_related_info": {
        "series_id": "GT29085",
        "season_id": "23456",
        "season_number": 8,
        "episode_number": 1
      }
    }
    
  • ContentItem
    The ContentItem data structure defines a media content item available for playback.

    Table 11. ContentItem data structure parameters
    Parameter Type Mandatory Description
    "id"
    String
    True
    Unique ID for the content item
    The ID is delivered to a Tizen application for a deep link. There are no format restrictions for the ID.
    "type" Content type
    The value must be "video".
    "country_codes"
    List
    Content type
    Countries for which the content is available, in ISO 3166-1 format (2-letter country codes), as a list of strings
    "url"
    String
    False
    Full URL for a web page containing this content item
    "audio_languages"
    List
    Audio languages, in ISO 639-1 format (2-letter language codes with optional 2-letter sub-codes), as a list of strings
    "subtitle_languages" Subtitle languages, in ISO 639-1 format (2-letter language codes with optional 2-letter sub-codes), as a list of strings
    "playback_options"
    List
    True
    Ways the user can access the content item
    Defined with the PlaybackOption data structure.
    The ContentItem data structure can contain the following data structure:
    • PlaybackOption
      The PlaybackOption data structure defines how a content item can be accessed on Samsung Smart TV.

      Table 12. PlaybackOption data structure parameters
      Parameter Type Mandatory Description
      "license"
      String
      True
      License type:
      • "free"
      • "rental"
      • "subscription"
      • "authentication"
      • "purchase"
      "price"
      Decimal
      False
      Item price, with 2 decimal digits
      Mandatory if the license type is "purchase" or "rental".
      "currency"
      String
      False
      Currency for the item price, in ISO 4217 format (3-letter currency codes)
      Mandatory if the license type is "purchase" or "rental".
      "quality"
      True
      Playback quality:
      • "SD"
      • "HD"
      • "HD+"
      • "UHD"
      • "4K"
      "available_starting" Content availability start time, in UTC time in "YYYY-MM-DD HH:MM:SS" format
      "available_ending" Content availability end time, in UTC time in "YYYY-MM-DD HH:MM:SS" format

    Example :

    {
      "content_items": [
        {
          "id": "12335",
          "type": "video",
          "country_codes": [
            "US",
            "GU"
          ],
          "audio_languages": [
            "en"
          ],
          "subtitle_languages": [
            "en",
            "fr",
            "kr",
            "es",
            "kr",
            "it"
          ]
          "playback_options": [
            {
              "license": "purchase",
              "price": 10.99,
              "currency": "USD",
              "quality": "HD+",
              "available_starting": "2019-04-14 00:00:00",
              "available_ending": "2020-04-14 16:00:00"
            }
          ]        
        }
      ]
    }
    
  • Member
    The Member data structure defines cast and production credits in the program.

    Table 13. Member data structure parameters
    Parameter Type Mandatory Description
    "casts"
    List
    True
    Performers in the program
    Defined with the Cast data structure.
    "credits"
    False
    Production credits for the program
    Defined with the Credit data structure.
    The Member data structure can contain the following data structures:
    • Cast
      The Cast data structure identifies a cast member and their role.

      Table 14. Cast data structure parameters
      Parameter Type Mandatory Description
      "person_id"
      String
      True
      Person unique ID
      Defined with the Person data structure.
      "character_name" Character portrayed
    • Credit
      The Credit data structure identifies a production crew member and their role.

      Table 15. Credit data structure parameters
      Parameter Type Mandatory Description
      "person_id"
      String
      True
      Person unique ID
      Defined with the Person data structure.
      "role" Production role

    Example :

    {
      "members": {
        "casts": [
          {
            "person_id": "567",
            "character_name": [
              "Jon Snow"
            ]
          }
        ],
        "credits": [
          {
            "person_id": "435364",
            "role": "Writer"
          }
        ]
      }
    }
    
  • Broadcast
    The Broadcast data structure defines the broadcaster information for TV broadcast programs.

    Table 16. Broadcast data structure parameters
    Parameter Type Mandatory Description
    "channel_name"
    String
    True
    Channel name the program aired on during the time defined in the "air_date" parameter
    "call_sign"
    False
    Channel call sign
    "channel_logos"
    List
    Channel logos
    Defined with the Image data structure.
    "blocked_dma"
    String
    DMA codes where the program is blocked, as a comma-separated string.
    Example: "501,506,53"

    Example:

    {
      "broadcast": {
        "channel_name": "rovi channel",
        "call_sign": "ABC",
        "channel_logos": [
          {
            "url": "https://vignette.wikia.nocookie.net/abcchannel/images/a/a5/ABC_Logo.png/revision/latest?cb=20160215062135",
            "width": 600,
            "height": 800,
            "type": "Banner",
            "language": "en"
          }
        ],
      "blocked_dma": "501"
      }
    }
    
  • SportData
    The SportData data structure defines additional information for sports programs, such as a televised football match.

    Table 17. SportData data structure parameters
    Parameter Type Mandatory Description
    "sport_type"
    String
    True
    Sports discipline in the program
    "league"
    False
    Sports league, such as NBA or NFL
    Mandatory if the program is related to a specific league.
    "game_original_time" Game start time in UTC time, in "YYYY-MM-DDThh:mm:ssTZD" format
    Example: "2016-12-15T20:30:00Z"
    Mandatory if the program is a sports match.
    "game_season" Season year
    Examples: "2016" or "2016-2017"
    "game_number" Season game number
    "game_venue" Venue name
    Example: "Pepsi Center"
    "playoff_round" Playoff round or series name
    Examples: "Divisional Playoff", "Conference Championship", "Conference Final"
    Mandatory if the program is a sports match.
    "participants"
    List
    False
    Particpants in the program, such as players or teams
    Mandatory if the program has named participants.
    Defined with the Participant data structure.
    The SportData data structure can contain the following data structure:
    • Participant
      Table 18. Participant data structure parameters
      Parameter Type Mandatory Description
      "id"
      String
      True
      Unique ID for the participant
      "type" Participant type:
      • "person"
      • "team"
      "person_first_name"
      False
      First name
      Mandatory if the participant type is "person".
      "person_middle_name" Middle name
      "person_last_name" Last name
      "team_fullname" Team name
      Example: "New York Knicks"
      Mandatory if the participant type is "team".
      "team_nickname" Team nickname
      Example: "Knicks"
      "team_acronym" Team name abbreviation
      Examples: "NYK", "LAL", "SEA", "NE"
      "is_home"
      Integer
      Whether the team is home or away:
      • 1: Home
      • 2: Away
      Mandatory if the participant type is "team".
      "images"
      List
      Participant images
      Defined with the Image data structure.

Example:

{
  "sport_data": {
    "sport_type": "basketball",
    "league": "NBA",
    "game_original_time": "2016-12-15T20:30:00Z",
    "playoff_round": "NBA Finals", 
    "participants": [
      {
        "id": "123",
        "type": "person",
        "person_first_name": "Stephen",
        "person_last_name": "Curry",
        "images": [
          {
            "url": "https://s-i.huffpost.com/gen/4626120/thumbs/o-STEPHEN-CURRY-570.jpg?7",
            "width": 600,
            "height": 800,
            "type": "Banner",
            "language": "en"
          }
        ]
      }
    ]
  }
}   

Person Data Structure

The following table describes the Person data structure, which defines information about a person.

Table 19. Person data structure parameters
Parameter Type Mandatory Description
"person_id"
String
True
Unique ID for the person
"names"
List
Names for the person
Defined with the Name data structure.
"images" Images of the person
Defined with the PersonImage data structure.
"gender"
String
False
Gender:
  • "female"
  • "male"
"date_of_birth" Date of birth, in "YYYY-MM-DD" format
"place_of_birth" Place of birth, in "city, state, country" or "city, country" format
"prizes"
List
Awards and recognitions
Defined with the Prize data structure.
"external_ids" Unique identifiers for the person from other content providers, used to match the person to existing persons in the database
Defined with the ExternalPersonId data structure.

The Person data structure can contain the following data structures:

  • Name
    The Name data structure defines a name for the person.

    Table 20. Name data structure parameters
    Parameter Type Mandatory Description
    "first_name"
    String
    True
    First name
    "middle_name"
    False
    Middle name
    "last_name"
    True
    Last name
    "language" Name language, in ISO 639-1 format (2-letter language codes with optional 2-letter sub-codes)

    Example:

    {
      "names": [
        {
          "first_name": "Kit",
          "middle_name": "",
          "last_name": "Harington",
          "language": "en"
        }
      ]
    }
    
  • PersonImage
    The PersonImage data structure defines an image of the person.

    Table 21. PersonImage data structure parameters
    Parameter Type Mandatory Description
    "url"
    String
    True
    Full public image URL
    "width"
    Integer
    Image width, in pixels
    "height" Image height, in pixels

    Example:

    {
      "images": [
        {
          "url": "https://akm-img-a-in.tosshub.com/indiatoday/images/story/201903/kit.jpeg?lpOiussrW2pB6TdhoGSjS_PBn7OQE6zD",
          "width": 770,
          "height": 433
        }
      ]
    }
    
  • Prize
    The Prize data structure defines an award or recognition the person has earned.

    Table 22. Prize data structure parameters
    Parameter Type Mandatory Description
    "program_id"
    String
    True
    Related program that the award or recognition was given for
    Defined with the Program data structure.
    "organization" Organization granting the award
    "award_title" Award title
    "year"
    Integer
    Award year
    "type"
    String
    Award or recognition type:
    • "winner"
    • "nominated"

    Example:

    {
      "awards": [
        {
          "program_id": "12335",
          "organization": "Gold Derby",
          "award_title": "Drama Supporting Actor",
          "year": 2011,
          "type": "winner"
        }
      ]
    }
    
  • ExternalPersonId
    The ExternalPersonId data structure defines an ID for the person from other content providers, enabling the Samsung database to cross-reference and match it to existing database entries.

    Table 23. ExternalPersonId data structure parameters
    Parameter Type Mandatory Description
    "id"
    String
    True
    Provider's person unique ID
    "id_type"
    False
    If the content provider uses multiple IDs for the same content, the ID type. For example, the Tribune/Gracenote ("tms") service uses the "tmsId" and "rootId" types.
    "provider"
    True
    Content provider name
    Supported values:
    • "facebook"
    • "imdb"
    • "rovi"
    • "twitter"
    • "tms"

    Example:

    {
      "external_ids": [
        {
          "id": "TMS34908",
          "id_type": "tmsId"
          "provider": "TMS"         
        }
      ]
    }
    
  • Sample Feed

    The following example feed defines a program and multiple related persons:

    {
      "programs": [
        {
          "ids": [
            {
              "id": "12335",
              "id_type": "v1"
            }
          ],
          "external_ids": [
            {
              "id": "EP123",
              "id_type": "tmsId",
              "provider": "tms"
            }
          ],
          "titles": [
            {
              "title": "Game of Thrones",
              "language": "en",
              "type": "main",
              "length": 15
            }
          ],
          "descriptions": [
            {
              "description": "Game of Thrones is roughly based on the storylines of A Song of Ice and Fire, set in the fictional Seven Kingdoms of Westeros and the continent of Essos. The series chronicles the violent dynastic struggles among the realm's noble families for the Iron Throne, while other families fight for independence from it.",
              "language": "en",
              "type": "main",
              "length": 313
            }
          ],
          "images": [
            {
              "url": "https://stmed.net/sites/default/files/game-of-thrones-wallpapers-31571-9933778.jpg",
              "width": 1920,
              "height": 1080,
              "type": "Banner",
              "language": "en"
            },
            {
              "url": "https://www.pixelstalk.net/wp-content/uploads/images1/emilia_clarke_jon_snow_game_of_thrones_season_7-1920x1080.jpg",
              "width": 1920,
              "height": 1080,
              "type": "Iconic",
              "language": "en"
            },
            {
              "url": "https://images-na.ssl-images-amazon.com/images/I/81IXojwauiL.jpg",
              "width": 600,
              "height": 900,
              "type": "Poster",
              "language": "en"
            }
          ],
          "parental_ratings": [
            {
              "country_codes": [
                "US",
                "GU"
              ],
              "body": "Motion Picture Association of America",
              "code": "PG-13"
            }
          ],
          "ratings": [
            {
              "body": "Metacritic",
              "type": "metascore",
              "score": 96,
              "num_votes": 3146
            }
          ],
          "type": "episode",      
          "genres": [
            "Action",
            "Adventure",
            "Fantasy"
          ],
          "air_date": "2010-11-25T20:30:00Z",
          "release_date": "2019-04-14",
          "running_time": 4524,
          "series_related_info": {
            "series_id": "GT29085",
            "season_id": "23456",
            "season_number": 8,
            "episode_number": 1
          },
          "content_items": [
            {
              "id": "12335",
              "type": "video",
              "country_codes": [
                "US",
                "GU"
              ],
              "playback_options": [
                {
                  "license": "purchase",
                  "price": 10.99,
                  "currency": "USD",
                  "quality": "HD+",
                  "available_starting": "2019-04-14 00:00:00",
                  "available_ending": "2020-04-14 16:00:00"
                }
              ],
              "audio_languages": [
                "en"
              ],
              "subtitle_languages": [
                "en",
                "fr",
                "kr",
                "es",
                "kr",
                "it"
              ]
            }
          ],
          "isExclusive": "yes",
          "production_company": "HBO",
          "members": {
            "casts": [
              {
                "person_id": "567",
                "character_name": [
                  "Jon Snow"
                ]
              }
            ],
            "credits": [
              {
                "person_id": "435364",
                "role": "Writer"
              }
            ]
          }
        }
      ],
      "persons": [
        {
          "person_id": "567",
          "names": [
            {
              "first_name": "Kit",
              "middle_name": "",
              "last_name": "Harington",
              "language": "en"
            }
          ],
          "gender": "male",
          "date_of_birth": "1986-12-26",
          "place_of_birth": "Acton, London, England, UK",
          "images": [
            {
              "url": "https://akm-img-a-in.tosshub.com/indiatoday/images/story/201903/kit.jpeg?lpOiussrW2pB6TdhoGSjS_PBn7OQE6zD",
              "width": 770,
              "height": 433
            }
          ],
          "awards": [
            {
              "program_id": "12335",
              "organization": "Gold Derby",
              "award_title": "Drama Supporting Actor",
              "year": "2011",
              "type": "winner"
            }
          ],
          "external_ids": [
            {
              "id": "TMS34908",
              "provider": "TMS",
              "id_type": ""
            }
          ]
        },
        {
          "person_id": "435364",
          "names": [
            {
              "first_name": "David",
              "middle_name": "",
              "last_name": "Benioff",
              "language": "en"
            }
          ],
          "gender": "male",
          "date_of_birth": "1970-09-25",
          "place_of_birth": "New York City, New York, USA",
          "images": [
            {
              "url": "https://m.media-amazon.com/images/M/MV5BMTAzNjQzMTEzMzJeQTJeQWpwZ15BbWU3MDkxNjA4NDc@._V1_.jpg",
              "width": 1385,
              "height": 2048
            }
          ],
          "awards": [
            {
              "program_id": "12335",
              "organization": "British Academy Television Award",
              "award_title": "Best International Programme",
              "year": "2013",
              "type": "nominated"
            }
          ],
          "external_ids": [
            {
              "id": "TMS20925",
              "provider": "TMS",
              "id_type": "rootId"
            }
          ]
        }
      ]
    }
    

    Genre Parameter Strings

    The following table lists the available values for the "genre" parameter.

    Table 24. Genre parameter values
    Genre
    ActionClassical musicGardeningMotorcycle racingSkiing
    Action sportsClassicsGay/lesbianMotoringSnooker
    AdolescenceClimbingGeriatricMotorsportsSnowboarding
    Adults onlyCollectiblesGolfMountain bikingSnowmobile
    AdventureComedyGothicMovie reviewsSoap
    AerobicsComedy dramaGugakMusicSoap special
    AgricultureComedy-dramaGymnasticsMusic specialSoap talk
    AnimalsComicsHalloweenMusic talkSoccer
    AnimatedCommunityHandballMusicalSoftball
    AnimecompilationHealthMusical comedySoundtracks
    AnthologyComputersHidden cameraMysterySpanish
    ArcheryConstructionhighlightsNatureSpecial
    Arm wrestlingConsumerHip-hop and RapNewsSpecial Interest
    ArtCookingHispanic OriginNewsmagazineSpeed skating
    Arts/craftsCricketHistorical dramaOlympicsSports
    Asian GamesCrimeHistoryOperaSports event
    AuctionCrime dramaHobbiesOutdoorsSports non-event
    AudioCritical ReviewHockeyOuter SpaceSports related
    Australian FootballCultHolidayOutside-KoreaSports talk
    AutoCurlingHoliday musicParadeSquash
    Auto racingCurrent AffairsHoliday music specialParanormalStandup
    AviationDanceHoliday specialParanormalSumo wrestling
    AwardsDark comedyHoliday-childrenParentingSurfing
    BadmintonDartsHomagePerforming artsSuspense
    BadukDebateHome improvementPetsSwimming
    BalletDetectivesHome ShoppingPlayoff sportsTable tennis
    BaseballDisastersHome videosPokerTaekwondo
    BasketballDivingHorrorPoliticsTalent show
    Beach soccerDocudramaHorsePoloTalk
    Beach volleyballDocumentaryHorse racingPoolTechnology
    BeautyDog racingHouse/gardenPop classicsTeleroman
    Behind the scenesDog showHow-toPopular musicTennis
    BiathlonDog sledHuntingPremiereTheater
    BicycleDrag racingHurlingPro wrestlingThriller
    Bicycle racingDramaHydroplane racingPublic affairsTrack/field
    BilliardsEducationalIndependentPublic informationTravel
    BiographyEntertainmentIndoor soccerRacquetTravelog
    BlackjackEnvironmentInternetRealityTriathlon
    BluesEquestrianInterviewRegional NewsTrue Stories
    BoatEroticIntl soccerReligiousVariety
    Boat racingEspionageJazzRinguetteVolleyball
    BobsledEventJudoRodeoVolunteering
    BodybuildingExerciseKayakingRoller derbyWar
    BollywoodFamilyKorean wrestlingRomanceWater polo
    BowlingFantasyLacrosseRomantic comedyWater skiing
    BoxingFashionLawRowingWatersports
    BullfightingFeminismLotteryRugbyWeather
    Bus./financialFencingLugeRunningWeightlifting
    CanoeFestivalsLuminariesSailingWestern
    Card gamesField hockeyMagicScienceWinter Olympics
    CelebrityFigure skatingMarathonScience fictionWinter Sports
    Chart showFishingMartial artsSelf improvementWorld Cup
    CheerleadingFolkMedicalShootingWorld News
    ChessFootballMelodramaShoppingWrestling
    ChildrenFrenchMilitaryShort FilmsYacht racing
    Children-musicFundraiserMiniseriesSitcom-
    Children-specialGaelic footballMixed martial artSkateboarding
    Children-talkGame showModern InterpretationSkating
    CircusGamingMotorcycleSkeleton