nexxOMNIA API
Search…
Usage
The Media API offers a variety of additional Parameters for querying Purposes.

General Parameters

Parameter
Values
Description
createdAfter
UNIX Timestamp
restrict Result to Elements, created after the given Time
modifiedAfter
UNIX Timestamp
restrict Result to Elements, modified after the given Time
publishedAfter
UNIX Timestamp
restrict Result to Elements, published after the given Time
channel
int
restrict Result Set to Items in this Channel
respectChannelHierarchy
[0, 1]
If the target Channel is a Main Channel, and the Contents of its Subchannels shall also be included, set this Parameter to 1.
format
int
restrict Result Set to Items in this Format
category
int
restrict Result Set to Items in this Category
genre
int
restrict Result Set to Items in this Genre (only for Video, Playlist, Series, Audio and Audio Album)
type
String
many Media Items have certain "Types" to define their Purpose. If necessary, you can filter by this Enum.
contentType
[video, comic, cgi] for videos or [foto, drawing, clipart] for images
many Media Items have a certain "contentType" that defines some Characteristics. If necessary, you can filter by this Enum.
country
2-Letter Code
restricts the Result to Media from the given Country
noExplicit
[0, 1]
restrict Result Set to Items with defined Age Level < 13 AND without Content Moderation Aspects
noContentModerationHints
[0, 1]
restrict Result Set to Items without Content Moderation Aspects
maxAge
[0, 6, 12 ,16 ,18]
restrict Result Set to Items with maximally the given Age Level
minAge
[0, 6, 12, 16, 18]
restrict Result Set to Items with at least the given Age Level
dimension
[hd, fullhd, 2K, 4K]
restrict the Result to Media with the given Height (alternatively, this Parameter also accepts a numeric Value, which will be mapped to the Media Height)
excludeItems
comma seperated Item IDs
the given Items wont be included into the Result Set
includeUGC
[0, 1]
add Items, uploaded by the Community, to the Result Set
onlyUGC
[0, 1]
restrict Result Set to Items, uploaded by the Community
includeRemote
[0, 1]
also include Files, that originate not by nexxOMNIA, but a Partner Provider
onlyRemote
[0, 1]
only include Files, that originate not by nexxOMNIA, but a Partner Provider
includeNotListables
[0, 1]
also include Media Items, that are marked as "not listable". This Parameter should be used only in very specific Usecases.
includePremieres
[0, 1]
also include Media, that are not valid YET, but will be in the near Future and allow Premiere Functionality
onlyPay
[0, 1]
restrict Result Set to Items with Payment Attributes
onlyPremiumPay
[0, 1]
restrict Result Set to Items with Payment Attributes AND Premium Payment Attributes
onlyStandardPay
[0, 1]
restrict Result Set to Items with Payment Attributes AND Standard Payment Attributes
onlyPlanned
[0, 1]
only possible if addPublishingDetails is active. If set to 1, only planned Elements will be returned.
onlyInactive
[0, 1]
only possible, if addPublishingDetails is active. If set to 1, only unpublished Elements will be returned.
forUserID
int
restrict Result Set to Items, that matches the given User (only valid for User-targeting Calls, that shall not match the currently loggedin User)
forceResults
[0, 1]
if the API Call wont find enough Items, fill the Result Set with random Items to the given Limit
connectedMediaDetails
[full, default, ID, GID]
If the Output Modifier addConnectedMedia is used, this Parameter defines the Detail Level for each connected Item.

Output Modifiers

Parameter
Values
Description
addGeoDetails
[0, 1]
add Details of a connected Location with all Location Attributes to each Item
addInteractionOptions
[0, 1]
add Information about Social Interactions (canBeRated, canBeFavourite, canBeLike, canBeWatchlist etc) to each Item
addConnectedMedia
[persons, shows, places, files, products, links, videos, audio, event, poll, album, article, trailerFor, bonusFor]
add the connected Item Details to each Item. This Modifier take "all" to include all possible Items or any combination of the given Enums, comma-seperated.
addComments
[all, own]
add (the last 25) Comments to each Item. It set to "own", only the Comments of the currently loggedin User are returned.
addAnnotations
[0, 1]
add (the last 25) Annotations (i.e. Comments within nexxOMNIA) to each Item
addCaptions
[data, auto, languages, vtt, srt, ttml, ebuttde]
return the Captions on the given Format ("languages" will return only a List of available Languages and "auto" will decide based on Media Duration, which Format is optimal)
addPaymentData
[0, 1]
add Information to the Payment State to each Item
addEmbedDetails
[0, 1]
add Embed Code, oEmbed Link and JSON-LD to each Item (if embeddable)
addStatusDetails
[0, 1]
add a list of allowance Rules to each Item
addParentReferences
[0, 1]
add Details about parent Elements to each Item
addRestrictionDetails
[0, 1]
add an Object of active Restrictions to each Item.
addTranslations
[0, 1]
add an Object of available MultiLanguage Metadata to each Item.
addItemData
[0, 1]
in case of Container Elements, include a list of the Child Items for each Item.
addItemDetails
[0, 1]
only necessary on Multi-Streamtype Containers (like Collections). The API will return all Details including Streamtype Hints for all Child Items of the Container.
addReferencingMedia
[0, 1]
add a list of other Media Items, the current Item is referenced in (for example, if calling for Person - list all Videos, that Person is referenced in)
addCustomAttributes
[0, 1]
add an Object of domain specific Custom Attributes to each Item.
addAwards
[0, 1]
add an Object of Awards, given to the current Media Item
addAuthorDetails
[0, 1]
add Details of the Author of an Item (only valid in UGC Media Items)
addExportDetails
[0, 1]
add a List of active Exports of the current Item
addPreviewLinks
[0, 1]
add a List of active PreviewLinks of the current Item
addBroadcastLinks
[0, 1]
add a List of active BroadcastLinks to the current Item
addFileURLs
[0, 1]
add a List of File Details of the current Item (for example - the URL to the Source Material).
This Modifier only works with the eternal Session.
addStreamingURLs
[0, 1]
add a List of Streaming URLs of the current Item (only valid on streamable Streamtypes)
This Modifier only works with the eternal Session.
addRenditionDetails
[0, 1]
add a List of all available Renditions of the current Item (only valid for transcodable Streamtypes)
addTranscodingDetails
[0, 1]
add a List of all available Transcoding Steps of the current Item (only valid for transcodable Streamtypes)
addFeatures
[0, 1]
add an Object of technical Features (Resolution, Filesize etc) to each Item
addInsights
[keyframes, structure, ocr, topics, keywords, brands, atmosphere, emotions, entities, faces]
add AI generated Analysis Metadata to each Item. This Modifier take "all" to include all possible Items or any combination of the given Enums, comma-seperated.
addFaceDetails
[0, 1]
add a List of detected Persons (via AI, based on Face Detection) to each Media Item
addPodcastDetails
[0, 1]
if the current Item is the Source for a Podcast, add the Podcast Details.

Streamtype specific Parameters

Video

Parameter
Values
Description
includeTrailers
[0, 1]
also include Trailers in the Result Set
onlyTrailers
[0, 1]
only include Trailers in the Result Set
includeBonus
[0, 1]
also include Bonus Material in the Result Set
onlyBonus
[0, 1]
only include Bonus Material in the Result Set
onlyForSessionLanguage
[0, 1]
don’t include Videos, that have a different Audio Language than the current Session Language
audioLanguage
2-Letter Code
restricts the Result to Media with an Audio Track of the given Language
includeEpisodes
[0, 1]
also include Episodes in the Result Set
onlyEpisodes
[0, 1]
only include Episodes in the Result Set
includeStoryParts
[0, 1]
also include Videos, that are Part of a Story, in the Result Set
onlyStoryParts
[0, 1]
only include Videos, that are Part of a Story, in the Result Set
includeLiveRepresentations
[0, 1]
also include Videos, that are Representations of a LiveStream, in the Result Set
onlyLiveRepresentations
[0, 1]
only include Videos, that are Representations of a LiveStream, in the Result Set
onlyUnsecured
[0, 1]
only include Videos without DRM/AES Security
onlyPanorama
[0, 1]
only include Panorama Video
onlyWithSurroundSound
[0, 1]
only include Videos with Surround Sound
minDuration
int
only return Videos with the given minimal Duration (in Seconds)
maxDuration
int
only return Videos with the given maximal Duration (in Seconds)
onlyDownloadable
[0, 1]
only include Videos, that can be watched offline
addScenes
[0, 1]
add a list of included Scenes to each Item in the Result Set.
(this Parameter is an Output Modifier)
addHotSpots
[0, 1]
add a List of all available HotSpots to each Item (also automatically created by Auto HotSpot Rules)
(this Parameter is an Output Modifier)
addBumpers
[0, 1]
if the Call is a single Call, optionally expand the Item with appropriate Pre/Post Bumpers (so the Single Item Call will become a Item List Call)
(this Parameter is an Output Modifier)
addVariantDetails
[0, 1]
add a List of all available Variants to each Item
(this Parameter is an Output Modifier)

Scene

Parameter
Values
Description
purpose
string
[opening, recap,chapter, credits] only include Scenes of the given Purpose

Live

Parameter
Values
Description
includeReLive
[0, 1]
if set to 1, the Result Set will also contain not-live LiveStreams, which have a ReLive Recording and can therefore still be played back.
addIngestDetails
[0, 1]
add the Ingest URLs and Tokens for Publishing to the Live Event.
This Modifier only works with the eternal Session.
(this Parameter is an Output Modifier)

Playlist

Parameter
Values
Description
includeSeasons
[0, 1]
also include Seasons in the Result Set
onlySeasons
[0, 1]
only include Seasons in the Result Set

Audio

Parameter
Values
Description
includeTrailers
[0, 1]
also include Trailers in the Result Set
onlyTrailers
[0, 1]
only include Trailers in the Result Set
includeBonus
[0, 1]
also include Bonus Material in the Result Set
onlyBonus
[0, 1]
only include Bonus Material in the Result Set
audioLanguage
2-Letter Code
restricts the Result to Media with an Audio Track of the given Language
includeEpisodes
[0, 1]
also include Episodes in the Result Set
onlyEpisodes
[0, 1]
only include Episodes in the Result Set
minDuration
int
only return Audio Files with the given minimal Duration (in Seconds)
maxDuration
int
only return Audio Files with the given maximal Duration (in Seconds)
addChapters
[0, 1]
add a List of Chapters to each Item
(this Parameter is an Output Modifier)

Image

Parameter
Values
Description
onlyPanorama
[0, 1]
only include Panorama Images
onlyAnimations
[0, 1]
only include animated Images
includeStoryParts
[0, 1]
also include Images, that are Part of a Story, in the Result Set
onlyStoryParts
[0, 1]
only include Images, that are Part of a Story, in the Result Set
onlyBW
[0, 1]
only include Black/White Images

Collection

Parameter
Values
Description
includeStories
[0, 1]
also include Collections, that serve as Story in the Result Set
onlyStories
[0, 1]
only include Collections, that serve as Story in the Result Set
selectedStreamtypes
comma seperated List of valid Streamtypes
only return Collections, that are created by Child Items of the given Streamtypes

Series

Parameter
Values
Description
addSeasonList
[0, 1]
add a list of Seasons (this is identical to addItemData, but skips the underlying Episode Lists)
(this Parameter is an Output Modifier)
addEpisodesForSeason
int
add the Episode List of the given Season (referenced by Season Number (1-X), not Playlist ID. Optionally set to "latest" to automatically add the Episode List of just the latest Season
(this Parameter is an Output Modifier)

File

Parameter
Values
Description
fileType
string
only include Files of the given Filetype (e.g. "pdf")
Parameter
Values
Description
purpose
string
[link, reference] only include Links of the given Purpose

Studio

Parameter
Values
Description
forStreamtype
[video, audio]
only return Studios for the given Streamtype

Person

Parameter
Values
Description
addTaggedImages
[0, 1]
add a list of Images, where the current Item has been found on (and additionally a list of potential matches without manual confirmation)
(this Parameter is an Output Modifier)
addTaggedVideos
[0, 1]
add a list of Videos, where the current Item has been found on (and additionally a list of potential matches without manual confirmation)
(this Parameter is an Output Modifier)

Post

Parameter
Values
Description
platform
[facebook, instagram, twitter]
only include Posts, that were created on the given Platform
account
int
only include Posts, that were created within the given Account
Last modified 9d ago