For Agents
Lets agents pull account-level and top-videos engagement metrics for a JW Player account between two dates, authenticated by the x-api-key header.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the JW Player Analytics Metrics, 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 JW Player Analytics Metrics API.
Pull account-level video engagement metrics for a JW Player account between two dates
Retrieve the top videos by engagement for a JW Player account in a date window
Scope analytics calls by accounttoken so an agency can fetch metrics across multiple JW Player accounts
GET STARTED
Use for: I need to pull JW Player account engagement for the last 30 days, Get the top-performing videos on a JW Player account this week, Retrieve the analytics totals for a specific JW Player accounttoken, Find the top 10 videos for a date range
Not supported: Does not handle video upload, encoding, or playback control — use for JW Player account totals and top-videos analytics only.
JW Player Analytics Metrics is a video-analytics API exposed at analytics-metrics.jwplayer.com. The two GET endpoints return account-level and top-videos engagement metrics for a date window, scoped by an account token in the path. Authentication is via the x-api-key header. Typical consumers are publishers and OTT operators that already use the JW Player video platform and need programmatic access to playback metrics rather than the JW dashboard.
Drive a publisher dashboard with daily account totals and top-content lists
Roll up top-video performance over arbitrary date windows for editorial planning
Patterns agents use JW Player Analytics Metrics API for, with concrete tasks.
★ Publisher Editorial Dashboard
Online publishers using JW Player can build an in-house dashboard that pulls account totals and top-videos lists for the prior 24 hours, week, and month. The two-endpoint surface is enough to render the headline charts most editorial teams care about — total plays, top stories — without paying for a third-party BI integration. Most teams stand it up in a day.
Call GET /v2/accounts/{accounttoken}/topvideos/start_date/2026-05-01/end_date/2026-05-07 and return the top 10 videos by engagement
Agency Client Reporting
Video agencies managing multiple publishers' JW Player accounts can iterate over each accounttoken and pull the account totals plus the top videos for the reporting period. The integration replaces manual exports from the JW dashboard and feeds a templated client report with consistent metrics across accounts.
For each accounttoken in a client list, call GET /v2/accounts/{accounttoken}/start_date/2026-05-01/end_date/2026-05-31 and write the account total to a CSV row
Content Planning by Top Videos
Editorial and content teams can use the topvideos endpoint to identify which formats, talent, or topics drive engagement on JW Player. The agent pulls the top-N list weekly and surfaces titles or tags that consistently outperform, so commissioning decisions are grounded in JW playback data rather than vibes.
Call GET /v2/accounts/{accounttoken}/topvideos/start_date/2026-04-01/end_date/2026-04-30 and return the title and engagement metric for the top five videos
AI Agent Video Performance Lookups
Editorial copilots and exec briefing agents can query JW Player analytics through Jentic without storing the x-api-key in the agent context. The agent searches Jentic for an analytics intent, loads the operation schema, and Jentic injects the key at execution time. Useful for agents that summarise weekly publishing performance for an editor.
Search Jentic for 'get JW Player account totals', execute the operation with accounttoken='abc123' and the prior week's date range, and return the total plays figure
2 endpoints — jw player analytics metrics is a video-analytics api exposed at analytics-metrics.
METHOD
PATH
DESCRIPTION
/v2/accounts/{accounttoken}/start_date/{start_date}/end_date/{end_date}
Account-level engagement metrics for a date range
/v2/accounts/{accounttoken}/topvideos/start_date/{start_date}/end_date/{end_date}
Top videos for an account by engagement
/v2/accounts/{accounttoken}/start_date/{start_date}/end_date/{end_date}
Account-level engagement metrics for a date range
/v2/accounts/{accounttoken}/topvideos/start_date/{start_date}/end_date/{end_date}
Top videos for an account by engagement
Three things that make agents converge on Jentic-routed access.
Credential isolation
The JW Player Analytics x-api-key is stored encrypted in the Jentic vault. Agents receive scoped execution capability — the key never enters the agent's context, prompts, or logs.
Intent-based discovery
Agents search Jentic by intent (e.g. 'get JW Player account totals' or 'list top JW Player videos') and Jentic returns the matching operation with its input schema, so the agent calls the right endpoint without parsing the SwaggerHub spec by hand.
Time to first call
Direct JW Player Analytics integration: 2-3 hours for auth, date-range handling, and per-account loops. Through Jentic: under 15 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using JW Player Analytics Metrics API through Jentic.
What authentication does the JW Player Analytics Metrics API use?
The API uses an API key sent in the x-api-key header on every request. There is no OAuth flow or signed-request scheme. Through Jentic, the x-api-key is stored encrypted in the vault and injected at execution time, so the agent never sees the raw key.
Can I get top videos for a JW Player account through this API?
Yes. GET /v2/accounts/{accounttoken}/topvideos/start_date/{start_date}/end_date/{end_date} returns the top videos for the requested date window, scoped by accounttoken. The response includes the engagement metric the JW dashboard surfaces under the top-content view.
What are the rate limits for the JW Player Analytics Metrics API?
The spec does not document rate limits. JW Player applies them per account, and agencies pulling metrics across many accounttokens have hit per-account caps in practice. Throttle to one request per second per account and back off on HTTP 429.
How do I pull account totals through Jentic?
Search Jentic for 'get JW Player account totals'. Jentic returns the operation backed by GET /v2/accounts/{accounttoken}/start_date/{start_date}/end_date/{end_date}, you load the schema (accounttoken plus a start and end date), and execute. Jentic injects the x-api-key from the vault. Sign up at https://app.jentic.com/sign-up.
Does the Analytics Metrics API expose video upload or playback control?
No. This API is read-only and metrics-only. JW Player ships a separate management and delivery API for uploading, encoding, and serving video — those operations are not in this spec. Use this API only for reporting on JW Player engagement data.
Are the start and end date format strict?
Yes. Both endpoints take start_date and end_date as path parameters and JW Player expects ISO-style YYYY-MM-DD values. Sending a non-standard format returns an HTTP 400. Stick to YYYY-MM-DD across both parameters.