Channel 4 API

Name: Channel 4 API
Brand: Channel 4 API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaVideo ProcessingapiKey68 EndpointsREST

For Agents

Look up Channel 4 brands, series, episodes, on-demand availability, and category-filtered listings as Atom feeds. Useful for building EPG features, TV recommendation tools, and programme search agents.

Install Jentic One Beta

Connect the Channel 4 API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Channel 4 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 | sh

Step 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 instance

Jentic 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.

Capabilities

What an agent can do with Channel 4 API.

Browse the full Channel 4 brand catalog by popularity, category, or A-Z index via /brands and /atoz endpoints

Fetch episode lists for a given calendar date through /4od/episode-list/date/{yyyy}/{mm}/{dd}.atom

Retrieve recently-added on-demand titles using /4od/recently-added/videos.atom

GET STARTED

Start building with Channel 4 API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Channel 4 API for, with concrete tasks.

★ TV Listings and EPG Apps

TV guide apps and smart-TV interfaces use the Channel 4 API to surface what is on the broadcaster's linear channels and the 4oD on-demand catalog. Endpoints like /4od/episode-list/date/{yyyy}/{mm}/{dd}.atom return everything that aired or was added on a given day, while /categories/{category}/channel/{channel}.atom narrows by genre and channel for grid-style listings.

Fetch /4od/episode-list/date/2026/06/10.atom and parse the returned Atom feed into a structured listings array

Programme Discovery and Recommendation

Recommendation engines surface relevant Channel 4 programmes by combining popularity feeds, category filters, and A-Z navigation. Calls to /brands/popular.atom and /categories/{category}.atom give a baseline of trending and topical content, while /atoz/{start_letter}.atom supports A-Z browsing experiences in second-screen apps.

Pull /brands/popular.atom for the top 10 brands and cross-reference each against /categories/drama.atom to surface popular dramas

Catalog Sync for Smart TV and Set-Top Boxes

Smart-TV vendors and set-top box integrators sync the Channel 4 catalog into their own metadata stores so they can present unified search and watch-now interfaces. Paged feeds like /brands/4od/page-{pageno}.atom let the integrator chunk through the catalog reliably, while /4od/recently-added/videos.atom keeps incremental syncs lightweight.

Iterate /brands/4od/page-1.atom through /brands/4od/page-{n}.atom until exhausted, then fetch /4od/recently-added/videos.atom for the daily delta

Conversational TV Discovery via Jentic

An AI agent can answer questions like 'what comedies are on Channel 4 tonight' by selecting the right Atom feed through Jentic. The agent searches Jentic for the listings operation, loads the relevant categories or date endpoint, and parses the response, all without holding the API key directly.

Search Jentic for 'list channel 4 episodes on a date', call /4od/episode-list/date/2026/06/10.atom, and summarise the comedy entries

Key Endpoints

68 endpoints — the channel 4 programme metadata lookup service data (pmlsd) api exposes the broadcaster's programme catalog as atom feeds covering brands, series, episodes, recently-added content, a-z indexes, categories, and on-demand availability.

METHOD

PATH

DESCRIPTION

GET

/4od/episode-list/date/{yyyy}/{mm}/{dd}.atom

Episodes available on a specific date

GET

/4od/recently-added/videos.atom

Most recently added 4oD titles

GET

/brands/popular.atom

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Channel 4 API uses a query-string apikey, which is easy to leak in logs and referrers. Jentic keeps the apikey in the MAXsystem vault and appends it server-side at execution, so the agent never sees the raw key in URLs or logs.

Intent-based discovery

Agents search Jentic with intents like 'list channel 4 episodes by date' or 'browse popular channel 4 brands', and Jentic surfaces the matching Atom-feed endpoint with its path parameters resolved.

Time to first call

Direct integration: 2-4 days to handle Atom parsing, paging, and category routing. Through Jentic: under an hour — the agent calls the relevant endpoint and parses the returned feed.

FAQs

Specific to using Channel 4 API through Jentic.

What authentication does the Channel 4 API use?

The Channel 4 PMLSD API uses an apikey passed as a query string parameter on every request. When called through Jentic, the apikey is held encrypted in the MAXsystem vault and injected only at execution time.

Can I get a list of episodes that aired on a specific day with the Channel 4 API?

Yes. Call GET /4od/episode-list/date/{yyyy}/{mm}/{dd}.atom with the date in the URL path. The response is an Atom feed listing every episode tied to that broadcast or publish date.

What format does the Channel 4 API return?

Every endpoint returns Atom XML, not JSON. Plan your parser around the Atom 1.0 schema with Channel 4's namespace extensions for series, brand, and on-demand availability fields.

What are the rate limits for the Channel 4 API?

Channel 4 does not publish a public rate limit for PMLSD. Treat it as a metadata API and cache responses where possible: brand and category lists change daily at most, while /4od/recently-added/videos.atom is the right poll target for fresh content.

How do I browse Channel 4 dramas through Jentic?

Install jentic with pip install jentic, search for 'list channel 4 programmes by category', load the schema for /categories/drama.atom, and execute. Sign up at https://app.jentic.com/sign-up to get an agent API key.

Does the Channel 4 API support paging for long lists?

Yes. Most browsable endpoints have a /page-{pageno}.atom variant — for example /brands/4od/page-2.atom — so callers can iterate through the full catalog without overrunning a single response.