oEmbed Integration
The glomex Video Player supports oEmbed  integration through our JSON endpoint at https://embed.mes.glomex.cloud/oembed.json.
If you use WordPress as your CMS, you can use our WordPress glomex oEmbed plugin .
Need to generate embed code with your specific Integration ID and Playlist ID? Use our Embed Code Generator tool, which utilizes the oEmbed service to create ready-to-use embed codes.
Overview
The oEmbed response contains everything needed to generate glomex player embed codes for both HTML5 and AMP.
SEO Metadata: The new glomex player can automatically add structured data (JSON-LD) to your page for better SEO. This can be enabled via the player configuration settings.
Request Parameters
To generate proper embed codes, you need to provide the following query parameters:
| Parameter | Type | Description |
|---|---|---|
url | mandatory | URL-encoded URL matching a supported embed scheme (see Supported Schema) |
integrationId | mandatory only if not in url | If the url parameter doesn’t include the integrationId, it can be supplied with this parameter. This overrides any integrationId provided in the url parameter. |
Supported Schema
Currently, only the following URL schema is supported:
https://exchange.glomex.com/[video|videos|playlist|playlists]/VIDEO_OR_PLAYLIST_ID?integrationId=INTEGRATION_IDIf the URL schema does not contain an integrationId, it must be passed as a separate parameter (see Request Parameters).
Response Structure
The service responds with a JSON object containing the following fields. View an example response .
Core Fields
| Field | Type | Description | Example |
|---|---|---|---|
version | String | oEmbed response version | 1.0 |
type | String | Type of embed (always video) | video |
provider_name | String | oEmbed provider name (always glomex) | glomex |
provider_url | String | oEmbed provider URL (always https://www.glomex.com) | https://www.glomex.com |
cache_age | Number | Suggested cache lifetime for this resource, in seconds | 600 |
width | Number | Minimum pixel width required for the player embed | 300 |
height | Number | Minimum pixel height required for the player embed | 180 |
integration_id | String | The glomex integrationId | 40599v14k373ncc1 |
playlist_id | String | The glomex playlistId | cl-bbq3dnwtac01 |
Embed Code Fields
| Field | Type | Description |
|---|---|---|
html | String | HTML code needed to embed the glomex player, including the <script> tag |
html_head | String | Additional resources that should be added to the HTML document’s <head>. Not present if no dependencies need to be added. |
amphtml | String | AMPHTML code needed to embed the glomex player. |
amphtml_head | String | Additional resources that should be added to the AMP document’s <head>. Note: Since AMP component dependencies must be declared in the <head>, these are mandatory if not already included. |
scripthtml | String | HTML code using <script> tags for loading the integration. Used for ad server integrations and allows passback/ready function names. |
Metadata Fields
| Field | Type | Description | Example |
|---|---|---|---|
title | String | Video title | Herbstschuh-Trends 2021: Die Must-Haves der Saison |
description | String | Video description | Ob Disco Boots, Chunky Loafers oder Cowboystiefel - wir zeigen euch, auf welche Schuhmodelle wir dieses Jahr nicht verzichten können und verraten euch, zu welchem Outfit man sie am besten kombiniert. |
upload_date | String | Unix timestamp in milliseconds when this content was uploaded | 1634224066000 |
expires | String | Unix timestamp in milliseconds (absolute) after which this content will not be available | 9999999999000 |
duration | Number | Length of the content in milliseconds | 72206 |
thumbnail_url | String | URL for the teaser/poster image. Note: Please link to this URL rather than downloading the image. | https://i1thumbs.glomex.com/... |
thumbnail_width | Number | Width of the poster image in pixels | 960 |
thumbnail_height | Number | Height of the poster image in pixels | 540 |
regions_allowed | String | Comma-separated ISO country codes where this content can be shown. Not present if there are no geo restrictions. | DE,AT,CH |
metadata_status | String | Optional. If looking up metadata times out or fails, this field is populated with a status message indicating the possible reason. | timeout |
Live Example
For a complete example response, visit: