Skip to content
Playout API
/
/
Get detailed information...

Media Jay Playout API (2025-09-02)

The playout API of the Media Jay application provides access to the playout data and orchestrates extended queries.

Authentication

To access the endpoints you require a X-API-Key in the header. Partners, please contact Transfermedia support@transfermedia.de to retrieve one.

Versioning

To use a specific implementation version of this API place it to the request header X-API-Version. If the header is missed the latest implementation version 2025-09-02 is used. The response header X-API-Version returns the implementation version the request was processed with.

Further documentation

For further details please visit the documentation or contact Transfermedia support@transfermedia.de.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Production server

https://live.playout.api.jay-metadata.com/v1/

Session Tracking

APIs for managing user tracking sessions. These endpoints allow clients to create, retrieve, and delete tracking sessions which are used for analytics and user behavior tracking.

Operations

Formats

Access to formats metadata (aka movie collections or series).

Operations

Episodes

Access to episode metadata and general information.

Operations

Episode items

Information about episode items.

Operations

Episode timeline

Information about timeline events with complete timing information.

Operations

Episode groups

Information about existing groups.

Operations

Episode scenes

Information about the scenes.

Operations

Episode companies involved

Information about the involved companies.

Operations

Get detailed information about the streaming platform provider

Request

Retrieves comprehensive information about the streaming platform (affiliate) serving this content.

This includes branding assets, website URLs, and other metadata needed to properly attribute and integrate with the streaming service in client applications.

This endpoint provides client applications with the necessary branding assets, URLs, and metadata about the streaming platform to properly attribute content and maintain consistent branding in the user interface.

The affiliate information includes:

  • Platform name and branding assets (logos, colors)
  • Website URLs for the main site, terms of service, and privacy policy
  • Contact information for support or partnership inquiries
  • Other platform-specific metadata

This data should be used to ensure proper attribution and brand consistency in any client applications that integrate with this content.

Args:

request: the complete request. playout_id: The playout identifier (aka tenant identifier) for authentication and affiliate identification. episode_id: The episode identifier, used to access the episode's data.

Returns:

ResultResponse[PlayoutAffiliate]: Result response contains Comprehensive information about the streaming platform, including name, URLs, branding assets, and contact information.

Raises:

ApiHttpException: When the episode data cannot be found or when affiliate information is unavailable or malformed.

Path
playoutIdstring(playout identifier)required

The playout identifier (aka tenant identifier) addressing the correct content of the streaming platform.

episodeIdstring(episode identifier)required

The episode identifier.

Headers
X-API-Keystring(X-Api-Key)required

Required. API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

X-JAY-TRACKINGstring(X-Jay-Tracking)

Tracking session header for user tracking and analytics. This is set by the /playouts/{playout_id}/tracking/session endpoint.

Example: eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9
curl -i -X GET \
  'https://live.playout.api.jay-metadata.com/v1/playouts/{playoutId}/episodes/{episodeId}/companies/affiliate' \
  -H 'X-API-Key: string' \
  -H 'X-JAY-TRACKING: eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9'

Responses

Successfully retrieved complete affiliate information

Bodyapplication/json
dataobject(The response data)

The response data.

Example: {"name":"string","description":"string","url":"string","logoUrl":"string"}
nextTokenstring(Next token)

The token, which can be used to retrieve the next page of data.

errorobject(The error response)

Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

Response
application/json
{
  "data": {
    "name": "string",
    "description": "string",
    "url": "string",
    "logoUrl": "string"
  }
}

List retailer/e-commerce platforms (merchants) involved.

Request

Get information about the retailer/e-commerce platforms (merchants) involved.

Path
playoutIdstring(playout identifier)required

The playout identifier (aka tenant identifier) addressing the correct content of the streaming platform.

episodeIdstring(episode identifier)required

The episode identifier.

Query
next_tokenstring(Next page token)

The token, which can be used to retrieve the next page of data. Check nextToken in response if another call is required to receive all data.
Available since X-API-Version 2025-08-27

Headers
X-API-Keystring(X-Api-Key)required

Required. API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

X-JAY-TRACKINGstring(X-Jay-Tracking)

Tracking session header for user tracking and analytics. This is set by the /playouts/{playout_id}/tracking/session endpoint.

Example: eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9
curl -i -X GET \
  'https://live.playout.api.jay-metadata.com/v1/playouts/{playoutId}/episodes/{episodeId}/companies/merchants?next_token=string' \
  -H 'X-API-Key: string' \
  -H 'X-JAY-TRACKING: eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9'

Responses

Successfully retrieved list of merchants

Bodyapplication/json
dataArray of objects(The response data)

The response data.

Example: [{"id":"string","name":"string","description":"string","url":"string","logoUrl":"string","termsOfUseUrl":"string","privacyStatementUrl":"string"}]
nextTokenstring(Next token)

The token, which can be used to retrieve the next page of data.

errorobject(The error response)

Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

Response
application/json
{
  "data": [
    { … }
  ]
}

Details about a retailer/e-commerce platform (merchant).

Request

Get information about a specific retailer/e-commerce platform (merchant).

Args:

request: the complete request. playout_id: The playout identifier (aka tenant identifier). episode_id: The episode identifier merchant_id: The merchant identifier (shop source).

Returns:

ResultResponse[PlayoutMerchant]: Result response contains the merchant details.

Raises:

ApiHttpException: If the episode, merchant list, or specific merchant are not found (404).

Path
playoutIdstring(playout identifier)required

The playout identifier (aka tenant identifier) addressing the correct content of the streaming platform.

episodeIdstring(episode identifier)required

The episode identifier.

merchantIdstring(shop identifier)required

The shop identifier.

Headers
X-API-Keystring(X-Api-Key)required

Required. API access key for authorized use of the checkout endpoints. Partners, please contact Transfermedia to retrieve a valid key.

X-JAY-TRACKINGstring(X-Jay-Tracking)

Tracking session header for user tracking and analytics. This is set by the /playouts/{playout_id}/tracking/session endpoint.

Example: eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9
curl -i -X GET \
  'https://live.playout.api.jay-metadata.com/v1/playouts/{playoutId}/episodes/{episodeId}/companies/merchants/{merchantId}' \
  -H 'X-API-Key: string' \
  -H 'X-JAY-TRACKING: eyJzZXNzaW9uX2lkIjoiZXhhbXBsZS1zZXNzaW9uLWlkLTEyMzQiLCJzdGFydF90aW1lIjoiMjAyNS0wMS0wMVQxMjowMDowMC4wMDAwMDAiLCJzb3VyY2UiOiJqYXkuYXBpLnBsYXlvdXQuZXhhbXBsZSJ9'

Responses

Successfully retrieved merchant details

Bodyapplication/json
dataobject(The response data)

The response data.

Example: {"id":"string","name":"string","description":"string","url":"string","logoUrl":"string","termsOfUseUrl":"string","privacyStatementUrl":"string"}
nextTokenstring(Next token)

The token, which can be used to retrieve the next page of data.

errorobject(The error response)

Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

Response
application/json
{
  "data": {
    "id": "string",
    "name": "string",
    "description": "string",
    "url": "string",
    "logoUrl": "string",
    "termsOfUseUrl": "string",
    "privacyStatementUrl": "string"
  }
}

API information

Operations