For Agents
Read and create extracted metadata records for media stored on JW Platform via two REST endpoints.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Media Metadata API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Media Metadata API.
Read the stored metadata record for a media item ingested into JW Platform
Persist newly extracted metadata for a media item via a POST request
Centralise extracted media attributes alongside the JW Platform ingestion pipeline
GET STARTED
Use for: Retrieve stored metadata for a JW Platform media item, Create a new metadata record for an ingested video, Find the metadata associated with a JW media asset, Save extracted metadata for a video into JW Platform
Not supported: Does not handle media upload, transcoding, playback, or analytics — use for reading and writing extracted media metadata records only.
The JW Platform Media Metadata API stores extracted metadata about media that has been ingested into the JW Platform. The surface is intentionally narrow: a GET endpoint returns the metadata for a media item and a POST endpoint creates a metadata record. It is designed to sit alongside JW Player's broader ingestion pipeline as a dedicated metadata store, so agents can write extracted attributes once and read them back when serving or analysing the media.
Feed downstream players or recommenders with structured metadata for ingested videos
Patterns agents use Media Metadata API for, with concrete tasks.
★ Centralised Media Metadata Store
After a video is ingested into JW Platform and processed by an extraction pipeline (titles, transcripts, thumbnails, technical attributes), the agent persists the extracted attributes via POST /metadata. Downstream players, recommenders, and search indexes then read the same attributes via GET /metadata to keep their views in sync. This gives JW Platform a single source of truth for derived media data.
POST /metadata with the extracted attributes for a freshly ingested video and confirm with a follow-up GET /metadata that the record is present
Pre-Playback Metadata Lookup
Before serving a media item to a player, the agent fetches its metadata to drive UI elements like title, description, runtime, and language. Centralising this in the metadata store means the player does not have to re-derive attributes per session, keeping start-up latency low. This is especially relevant for OTT and educational platforms with large back catalogues.
GET /metadata for the media ID before constructing the player payload and use the response to populate the UI
AI Agent Integration via Jentic
An AI agent uses Jentic to discover the Media Metadata API by intent search ('store media metadata'). Jentic returns the GET and POST operations with their schemas, so the agent persists or fetches a metadata record without browsing JW Platform docs. Any auth required by your JW Platform account is handled inside the Jentic vault.
Use Jentic to search 'store media metadata', load the POST /metadata schema, and execute it to record the extracted attributes for a new ingestion
2 endpoints — the jw platform media metadata api stores extracted metadata about media that has been ingested into the jw platform.
METHOD
PATH
DESCRIPTION
/metadata
Show media metadata
/metadata
Create media metadata
/metadata
Show media metadata
/metadata
Create media metadata
Three things that make agents converge on Jentic-routed access.
Credential isolation
Any JW Platform credentials required in practice are stored encrypted in the Jentic vault (MAXsystem) and injected into the request when needed, even though the public spec does not declare a security scheme.
Intent-based discovery
Agents search by intent (e.g. 'store media metadata') and Jentic returns the GET or POST /metadata operation with its schema, so the agent skips reading the JW Platform docs.
Time to first call
Direct integration: half a day for auth wiring (since the spec is silent on auth) and payload modelling. Through Jentic: under 15 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Media Metadata API through Jentic.
What authentication does the Media Metadata API use?
The OpenAPI spec sourced from SwaggerHub does not declare a security scheme on the operations, but a JW Platform account is required in practice to call the live service. Through Jentic, any required credentials are stored in the MAXsystem vault and injected into the request when present.
Can I read the metadata for a media item I've ingested?
Yes. GET /metadata returns the stored metadata record for an ingested media item. Use this to populate player UIs or downstream search and recommendation indexes.
How do I store extracted metadata for a new video?
POST /metadata with the extracted attributes (title, description, runtime, language, and any custom fields) once your ingestion or extraction pipeline has produced them. The record then becomes available to GET on subsequent requests.
How do I save metadata through Jentic?
Search Jentic for `store media metadata`, load the POST /metadata operation, and execute it with the extracted attribute payload. Jentic returns the structured response from the metadata store.
Is this the same as the JW Player Management API?
No. The Media Metadata API is a focused metadata store tied to ingested media. JW Player exposes broader management APIs for media items, channels, and analytics, which are typically used together with this metadata surface.
Are there published rate limits?
The OpenAPI spec does not declare quantitative rate limits. Coordinate with JW Platform support to confirm the limits applied to your account before high-volume ingestion.