TV API
Welcome to the API Reference Docs page for the Press Association TV API (v2).
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Welcome to the API Reference Docs page for the Press Association TV API (v2).
Endpoints 18
Asset
- GETAsset Collection
/asset?updatedAfter=2015-05-05T00:00:00.000Z&limit=100&aliases=trueReturn a collection of Assets. - GETAsset Detail
/asset/:assetId?aliases=trueReturn the content of the selected asset. - GETAsset Contributors
/asset/:assetId/contributor?aliases=trueReturn the contributors of the selected asset.
Catalogue
- GETCatalogue Collection
/catalogueReturn a collection of Catalogues. - GETCatalogue Detail
/catalogue/:catalogueIdReturn the content of the selected catalogue. - GETCatalogue Asset Collection
/catalogue/:catalogueId/asset?title=string&start=2015-05-05T00:00:00&end=2015-05-06T00:00:00&updatedAfter=2015-05-06T00:00:00&limit=500&aliases=trueReturn the content of the selected catalogue. - GETCatalogue Asset Detail
/catalogue/:catalogueId/asset/:assetIdReturn the content of the selected catalogue asset.
Channel
- GETChannel Collection
/channel?platformId=d3b26caa-8c7d-5f97-9eff-40fcf1a6f8d3®ionId=afa4f624-da9b-54ce-b514-570345dbbdce&aliases=true&date=2018-09-15&scheduleStart=2015-05-05T00:00:00&scheduleEnd=2015-05-06T00:00:00&scheduleUpdatedSince=2015-05-05T00:00:00If you are interested in a list of channels that have had there schedule updated you can filter by the following query params. scheduleStart scheduleEnd… - GETChannel Detail
/channel/:channelId?aliases=trueReturn the content of the selected channel.
Contributor
- GETContributor Collection
/contributor?updatedAfter=2015-05-05T00:00:00.000Z&limit=100&aliases=trueReturn a collection of Contributors. - GETContributor Detail
/contributor/:contributorId?aliases=trueReturn the content of the selected contributor.
Feature
- GETFeature Collection
/feature?type=netflix-monthly&date=2018-09-15&start=2018-09-15&end=2018-10-15Return a collection of Feature. - GETFeature Type Collection
/feature-typeReturn a collection of Feature Types. - GETFeature Detail
/feature/:featureIdReturn the content of the selected feature.
Platform
- GETPlatform Collection
/platform?aliases=trueReturn a list of available platforms. - GETPlatform Detail
/platform/:platformIdReturn the content of the selected platform. - GETPlatform Region Collection
/platform/:platformId/region?aliases=trueReturn a list of regions for a platform.
Schedule
- GETSchedule Collection
/schedule?channelId=string&start=2015-05-05T00:00:00&end=2015-05-06T00:00:00&aliases=trueThe schedule endpoint produces a linear TV schedule for a given channel and date range. The date range supplied must be no larger than 21 days. If no end data…
API details
- Base URL
https://tv.api.pressassociation.io/v2http://tv.api.pressassociation.io/v2- Authentication
- An API key in the apikey header
- Operations
- 18 operations on 18 pathsGET 18
- Main resources
- Catalogue 4Asset 3Feature 3Platform 3Channel 2Contributor 2Schedule 1
- Response formats
application/json- Description format
- OpenAPI 3.0.0, API version
2.0 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the TV API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the TV API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the apikey header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Asset Collection” (GET /asset?updatedAfter=2015-05-05T00:00:00.000Z&limit=100&aliases=true), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the TV API?
Welcome to the API Reference Docs page for the Press Association TV API (v2). It is listed under Media & content and has 18 endpoints.
Who publishes the TV API?
It is listed from Pressassociation's public API description (an OpenAPI document), not published by Pressassociation on Swastik Codes. Anyone who controls pressassociation.io can claim the profile by adding a DNS TXT record.
What is the base URL of the TV API?
Its description lists 2 base URLs: https://tv.api.pressassociation.io/v2, http://tv.api.pressassociation.io/v2. The first is the usual one; the others are typically sandbox or regional servers.
How do I authenticate with the TV API?
With an API key in the apikey header.
How many endpoints does the TV API have?
18 operations on 18 paths (18 GET). The largest groups are Catalogue, Asset, Feature, Platform.
Is forking the TV API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.