Skip to Content
The new glomex player is released! 🎉View upgrade guide
Content OwnerAutomatic Upload

Automatic Upload

The Automatic Upload feature allows you to efficiently upload videos to the glomex platform with all necessary metadata.

Metadata Requirements

The Automatic Upload process requires metadata for your videos, including:

  1. File Paths: Links to the corresponding video and image files
  2. Descriptive metadata: Title, description, keywords, etc.
  3. Technical metadata: Publishing time window, geolocations, etc.

Metadata Format

The metadata can be provided in two different formats: XML or JSON.

XML (Media RSS)

Media RSS is a web standard for the delivery of video files with metadata. It is based on XML.

<rss xmlns:media="http://search.yahoo.com/mrss/" version="2.0"> <channel> <title>My Channel</title> <image> <url>https://mychannel.com/mychannellogo.png</url> </image> <!-- Video 1 --> <item> <guid>video_0001</guid> <title>Title 1</title> <media:content url="https://mychannel.com/video_0001.mp4" fileSize="28077488" type="video/mp4"/> <media:thumbnail url="https://mychannel.com/video_0001.jpg"/> <media:category>News</media:category> </item> <!-- Next videos... --> </channel> </rss>

XML Item Fields

FieldShort DescriptionDescriptionRequired
<guid></guid>ID of the videoThe unique identifier of the video.
e.g.: "095fac8d39b2cc0asdasd5asd43321s3df1d" or 12345
Yes
<title></title>TitleThe title of the video. Contains titles on different languages.
{"en": "Sample video title", "de": "Beispiel Video-Titel 2"}
Yes
<media:content url="" fileSize="" type=""/>Video File PathThe URL to the video file.
HTTP: http://channel.com/video_1.mp4
(S)FTP: sftp://user:password@example.com:2222/video.mp4
fileSize: size files in bytes
type: typeof video. e.g.: video/mp4
Yes
<media:thumbnail url=""/>Image File PathThe URL to the preview image file.
HTTP: http://channel.com/video_1.jpg
(S)FTP: sftp://user:password@example.com:2222/video1.jpg
Yes
<media:category></media:category>CategoryThe category of the video.
Supported categories: News, Cars & Motor, Food & Drink, Fashion & Beauty, Health & Fitness, Cinema & TV, Lifestyle & Documentation, Social & Fun, Sport, Celebrities, Travel & Adventure, Gaming
Yes
<channel></channel>ChannelThe name of your channel in which the video should be published.
e.g.: "ProSieben"
No
<description></description>DescriptionThe description of the video. The description will be used for the search results and automated recommendations of your video.Recommended
<media:keywords></media:keywords>KeywordsThe keywords of the video. The keywords will be used for the search results and automated recommendations of your video. Keywords can be comma separated,
e.g.: <media:keywords>animals, zoo</media:keywords>
Recommended
<media:subTitle type="text/srt" lang="de-DE" href=""/>Subtitles File PathThe URL to the subtitles file.
HTTP: http://channel.com/video_1.srt
(S)FTP: sftp://user:password@example.com:2222/video1.srt
No
<format></format>ShowThe name of the show or program title.
e.g.: "Germany's Next Top Model"
No
<media:content lang=""/>LanguageThe language of the video content.
glomex supports the two-letter ISO 639-1 language codes. See the full list here .
e.g.: de
No
<media:rating scheme="fsk"></media:rating>Age RatingsThe age ratings of the video content.
Supported age ratings:
FSK0 - Ab 0 freigegeben
FSK6 - Ab 6 freigegeben
FSK12 - Ab 12 freigegeben
FSK16 - Ab 16 freigegeben
FSK18 - Ab 18
e.g.: <media:rating scheme="fsk">FSK12</media:rating>
No
<dcterms:valid></dcterms:valid>Start and end datesThe release and expiration dates of the video.
The video will be activated and deactivated on this date.
Date format: YYYY-MM-DDThh:mm:ss+TIMEZONE (ISO 8601 )
e.g.: <dcterms:valid> start=2020-10-17T17:00+01:00; end=2021-10-17T17:00+01:00; scheme=W3C-DTF</dcterms:valid>
No
<media:restriction relationship="allow" type="country"></media:restriction>Geo LocationsThe countries in which the video should be allowed to play.
e.g.: ["DE","AT","CH"], default ALL
No
<media:copyright url=""></media:copyright>CopyrightThe copyright information of the video.
e.g.: <media:copyright url="http://www.uphe.de/">Universal</media:copyright>
No
<media:status state=""/>StatusDefines whether the video is "active", "locked", "blocked" or "deleted".
The default value is "active".
No
<pubDate></pubDate>Publication DateThe publication date of the video. Format: YYYY-MM-DDThh:mm:ss+TIMEZONENo
<media:transcript></media:transcript>TranscriptAllows the inclusion of a text transcript, closed captioning or lyrics of the media content.No

JSON Format

The JSON format provides an alternative to XML for specifying video metadata.

[ { "id": "video_0001", "title": { "de": "Title 1" }, "uri": "sftp://user:password@upload.glomex.com:2222/videos/video_0001.mp4", "image_uri": "sftp://user:password@upload.glomex.com:2222/images/video_0001.png", "categories": [ "Sport" ], "channel": "My Channel" }, { "id": "video_0002", "title": { "de": "Title 2" }, "uri": "sftp://user:password@upload.glomex.com:2222/videos/video_0002.mp4", "image_uri": "sftp://user:password@upload.glomex.com:2222/images/video_0002.png", "categories": [ "Sport" ], "channel": "My Channel" } ]

JSON Fields

FieldDescriptionTypeRequired
idThe unique identifier of the videostring|intYes
uriThe URL to the video filestringYes
image_uriThe URL to the preview image filestringYes
titleThe title of the video in different languagesObjectYes
categoriesThe categories of the video[string]Yes
channelThe name of your channelstringYes
descriptionThe description of the video in different languagesObjectRecommended
keywordsThe keywords of the video[string]Recommended
subtitle_uriThe URL to the subtitles filestringNo
formatThe name of the show or program titlestringNo
languagesThe language of the video[string]No
product_placementDescribes if the video contains product placementsboolNo
age_ratingsThe age ratings of the video content[Object]No
release_dateThe release date of the videostringNo
expiration_dateThe expiration date of the videostringNo
update_dateThe date of the last video updatestringNo
geo_locationsThe countries in which the video should be allowed to play[string]No
statusThe status of the videostringNo
transcriptAllows the inclusion of a text transcript, closed captioning or lyrics of the media contentstringNo
license_profilesThe license profile id, that should be assigned to this video[string]No

Metadata Transfer

đź’ˇ

For information about how to deliver your metadata and content files to glomex, please contact your account manager or send an email to service@glomex.com.

To transfer your videos, images and the metadata to the glomex Exchange, you can choose between HTTP(S) Feed or FTP Upload.

HTTP(S) Feed

The content owner provides an URL which contains either a XML or JSON file. The XML or JSON file contains URL paths to your videos and images hosted on a HTTP(S) server.

(S)FTP Upload

You can upload your videos, images and metadata to a glomex (S)FTP Server. The video/image paths in your XML/JSON must also point to this FTP Server.

It is possible to use one JSON/XML to describe all videos (e.g. all-videos.json) - or to use one JSON/XML file per video (e.g. video-01.json, video-02.json).

glomex (S)FTP Server

FieldDescription
Hostupload.glomex.com
ProtocolSFTP
Port2222
Username/PasswordPlease contact your glomex partner for credentials.

glomex Fetcher

Every 5 minutes or less, glomex fetches your XML/JSON feed and checks if new media files are provided or were changed.

If any new media files are provided, glomex imports and transcodes them. The content will be available for the Exchange Publishers within minutes.

Last updated on