Pressassociation TV API
✓ Official Vendor SpecMediaVideo ProcessingapiKey18 EndpointsREST
For Agents
Query TV schedules, browse channel listings, retrieve programme metadata with contributor credits, and filter content by platform and region.
Use for: I need to get the TV schedule for a specific channel and date, Find all programmes featuring a specific contributor, List available channels on a given platform, Retrieve detailed metadata for a specific programme asset
Not supported: Does not handle video streaming, content delivery, or programme recording — use for schedule metadata and programme information lookup only.
The Press Association TV API provides structured access to television programming metadata including schedules, channels, assets, catalogues, contributors, features, and platform-specific regional data. It serves 18 endpoints for browsing and querying UK and international TV listings, retrieving programme details with contributor credits, and filtering content by platform and region. The API is designed for media applications that need authoritative broadcast schedule data.
Install Jentic One Beta
Connect the TV API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the TV 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.
1
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 | sh2
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 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.
Capabilities
What an agent can do with TV API.
Retrieve broadcast schedules with programme slots for specific channels and dates
Browse catalogues of programme assets with filtering by genre and category
Look up contributor credits including actors, directors, and presenters per programme
Query channel metadata across platforms and regional availability
Filter programme assets by feature type for targeted content discovery
Access platform-specific regional channel lineups
Use Cases
Patterns agents use TV API for, with concrete tasks.
★ Electronic Programme Guide
Build electronic programme guides (EPGs) by querying the schedule endpoint for specific channels and date ranges. The TV API returns time-slotted programme entries with titles, descriptions, and broadcast metadata. This powers TV guide applications, set-top box interfaces, and second-screen companion apps that display what is currently airing and upcoming across hundreds of channels.
Query the /schedule endpoint for BBC One channel listings for today's date and parse the returned time slots with programme titles
Programme Metadata Enrichment
Enrich content catalogues with detailed programme metadata including cast and crew credits, genre classifications, and feature attributes. The TV API links assets to contributors with role information, enabling rich programme detail pages. Media companies use this to populate content management systems with authoritative metadata sourced from Press Association's editorial team.
Retrieve asset details via GET /asset/{assetId} and then fetch contributor credits via GET /asset/{assetId}/contributor for a specific programme
Multi-Platform Channel Discovery
Discover which channels are available on specific platforms (Freeview, Sky, Virgin Media) and in which regions. The platform and region endpoints provide the data needed to show users only the channels they can actually receive, avoiding confusion from irrelevant listings. This is essential for personalised TV guide experiences that adapt to the viewer's actual platform and location.
List all platforms via GET /platform, select a platform ID, then query GET /platform/{platformId}/region to see regional channel availability
AI Agent TV Data Integration
AI agents use the TV API through Jentic to answer questions about broadcast schedules, look up programme details, and build content recommendation features. The agent searches for schedule or programme operations, loads the endpoint schema with required parameters like channel ID and date, and retrieves structured TV data for further processing or user display.
Search Jentic for 'get TV schedule for channel', load the schedule operation schema, and execute with a channel ID and date parameter to retrieve today's listings
Key Endpoints
18 endpoints — the press association tv api provides structured access to television programming metadata including schedules, channels, assets, catalogues, contributors, features, and platform-specific regional data.
METHOD
PATH
DESCRIPTION
GET
/schedule
Get broadcast schedule for channels and dates
GET
/asset/{assetId}
Get detailed programme asset information
GET
/asset/{assetId}/contributor
Get contributors for a programme
GET
/channel
List all available channels
GET
/catalogue
List programme catalogues
GET
/platform
List available TV platforms
GET
/platform/{platformId}/region
Get regions for a platform
GET
/contributor/{contributorId}
Get contributor details
GET
/schedule
Get broadcast schedule for channels and dates
GET
/asset/{assetId}
Get detailed programme asset information
GET
/asset/{assetId}/contributor
Get contributors for a programme
GET
/channel
List all available channels
GET
/catalogue
List programme catalogues
GET
/platform
List available TV platforms
GET
/platform/{platformId}/region
Get regions for a platform
GET
/contributor/{contributorId}
Get contributor details
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Press Association API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive requests with the apikey header pre-populated, so the raw key never enters agent context.
Intent-based discovery
Agents search by intent (e.g., 'get TV schedule for channel') and Jentic returns matching TV API operations with their input schemas including required channel and date parameters.
Time to first call
Direct TV API integration: 1-2 days for auth setup, parameter discovery, and response parsing. Through Jentic: under 1 hour — search for schedule or programme operations, load schemas, and execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using TV API through Jentic.
What authentication does the TV API use?
The TV API uses API key authentication passed in the apikey header. Through Jentic, your Press Association API key is stored encrypted in the MAXsystem vault and agents receive requests with the apikey header pre-configured.
Can I get TV schedules for a specific channel and date?
Yes. The GET /schedule endpoint accepts channel and date parameters to return broadcast schedule entries with programme titles, descriptions, start times, and durations for that specific channel and date combination.
What are the rate limits for the TV API?
The specification does not document explicit rate limits. Contact Press Association for your plan's throughput allowance. For high-volume schedule polling, cache responses locally and refresh on a schedule rather than querying in real time for every user request.
How do I retrieve programme cast and crew information through Jentic?
Search Jentic for 'get programme contributors', load the asset contributor operation schema, and execute with an asset ID. The response includes contributor names, roles, and identifiers. Install the SDK with pip install jentic and set JENTIC_AGENT_API_KEY to get started.
Does the TV API cover international channels or only UK?
The API primarily covers UK broadcast content through Press Association's editorial team. Channel availability varies by platform — query GET /platform to see available platforms and GET /platform/{platformId}/region to check regional coverage for each.
Can I filter programmes by genre or feature type?
Yes. The GET /feature-type endpoint lists available feature classifications, and GET /feature/{featureId} retrieves details for a specific feature. Assets within catalogues can be filtered using the catalogue and feature endpoints to narrow results by content type.
GET STARTED