All Media Data
Last updated
Last updated
The Media API also exposes an Endpoint "allmedia", that is able to handle Results from multiple Streamtypes at once. Above all, it is very usefull for Union Queries, where multiple Streamtype Results should be ordered. It is also heavily connected to the "GlobalID" System, which gives every Media Element a global, unique ID, without the need for a Streamtype.
The All Media Endpoint accepts (mostly) all Parameters of the Standard Media Endpoints - streamtype specific Parameters and Output Modifiers are not supported.
Each All Media API Endpoint supports the special Query Parameter "selectedStreamtypes". With this Parameter, the calling Domain can control, what kind of Media shall be returned. It it is omitted, all possible Media Items will be returned.
The All Media API supports most of the default Media API Endpoints in exactly the same Way with the same Parameters - except the Need for a Streamtype.
This API Calls will return only one the referenced Item (if available and accessible with the calling Domain). The Result Set Format will be an Object.
GET https://api.nexx.cloud/v3.1/allmedia/byglobalid/:globalid
| Name | Type | Description |
|---|---|---|
GET https://api.nexx.cloud/v3.1/allmedia/all
GET https://api.nexx.cloud/v3.1/allmedia/latest
returns "all" Items, sorted by Creation Date (ignores the "order" Parameters).
GET https://api.nexx.cloud/v3.1/allmedia/picked
returns all "picked" Items (ignores the "order" Parameter).
GET https://api.nexx.cloud/v3.1/allmedia/evergreens
returns all "Evergreen" Items.
GET https://api.nexx.cloud/v3.1/allmedia/forkids
returns all Items, marked as "created for Kids". This is NOT connected to any Age Restriction.
GET https://api.nexx.cloud/v3.1/allmedia/withawards
returns all Items, thave have been added Awards to
GET https://api.nexx.cloud/v3.1/allmedia/byquery/:query
performs a regular Query on all Items. The "order" Parameters are ignored, if querymode is set to "fulltext".
GET https://api.nexx.cloud/v3.1/allmedia/random
GET https://api.nexx.cloud/v3.1/allmnedia/topslider
returns all Items, currently in the TopSlider of a nexxNEON Domain.
GET https://api.nexx.cloud/v3.1/allmedia/mostactive
"mostactive" refers to the Number of "Views" of each Media Item. The "order" Parameters will be ignored.
GET https://api.nexx.cloud/v3.1/allmedia/mostactiveexternal
"mostactive" refers to the Number of "Views" of each Media Item (on external Platforms). The "order" Parameters will be ignored.
GET https://api.nexx.cloud/v3.1/allmedia/bytag/:tag
GET https://api.nexx.cloud/v3.1/allmedia/byperson/:person
GET https://api.nexx.cloud/v3.1/allmedia/bypersonid/:personid
GET https://api.nexx.cloud/v3.1/allmedia/byshow/:show
GET https://api.nexx.cloud/v3.1/allmedia/byshowid/:showid
GET https://api.nexx.cloud/v3.1/allmedia/byplace/:place
GET https://api.nexx.cloud/v3.1/allmedia/byplaceid/:placeid
GET https://api.nexx.cloud/v3.1/allmedia/byproduct/:product
GET https://api.nexx.cloud/v3.1/allmedia/byproductid/:productid
GET https://api.nexx.cloud/v3.1/allmedia/byfile/:file
GET https://api.nexx.cloud/v3.1/allmedia/byfileid/:fileid
GET https://api.nexx.cloud/v3.1/allmedia/bystudio/:studioid
only available for Videos, Playlists and Sereis
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
globalid
number
The GlobalID of the target Media Item
streamtype
string
the Media Streamtype
query
string
the targetthe Item Slug
queryMode
string
[classicwithand, classicwithor, fulltext] defines the Way, the Query is executed. Fore more results, "classicwithor" is optiomal. For a Lucense Search with Relevance, use "fulltext"
queryFields
string
a comma seperated List of Attributes, to search within. If omitted, the Search will use all available Text Attributes.
minimalQueryScore
integer
skip Results with a Query Score lower than the given Value. Only usefull for querymode "fulltext".
includeSubstringMatches
boolean
By default, the Query will only return REsults on full Words. If also Subsctring Matches shall be returned, set this Parameter to 1. Only usefull, if querymode is not "fulltext".
skipReporting
boolean
if set to 0 or omitted, the Call will implictily report this Query to the nexxOMIA Reporting System.
timeframe
integer
[1, 5, 10, 30] the Amount of Days, that will be included in the Computation of the Result Set.
timeframe
integer
[1, 5, 10, 30] the Amount of Days, that will be included in the Computation of the Result Set.
tag
string
the Tag to query for
person
string
the Name of the Person to query for
personid
integer
the ID of the Person to query for
show
string
the Name of the Show to query for
showid
number
the ID of the Show to query for
place
string
the Name of the Place to query for
placeid
number
the ID of the Place to query for
product*
string
the Name of the Product to query for
productid*
number
the ID of the Product to query for
file*
string
the Name of the File to query for
fileid*
number
the ID of the File to query for
studioid
number
the ID of the Studio to query for