Asset - Video (Create)
Note: This page describes video assets that appear in the Create product.
For the videos that appear in the Now product please see Asset - Video
Definition
Name | Value | Description |
---|---|---|
Profile | Asset | An individual piece of content. |
Type | Video | A video. |
Important Metadata
Name | Description |
---|---|
Id | The unique id of the content item |
First Created | The timestamp of when the first version of this content item was published. |
Version Created | The timestamp of when the most recent version of this content item was published. |
Content | The main content of the item. In the case of a video item this is a fragment of HTML that contains an embed video player that will play this video. This can be used on client applications to render the video. |
Topic | PA Specific metadata to define an event or story. For more information please see Subject FAQs. |
Keyword | PA Specific metadata to define an event or story. For more information please see Subject FAQs. |
Service | The service that this content is part of inside of a product. For more information please see Service FAQ. |
Thumbnail | The URL to retrieve the Video's Image thumbnial from. The thumbnail is useful for displaying before a user has pressed to play the video. |
Usage Terms | A description on how this video can be used. |
Expiry | Certain video are only visible and useable for a set period of time. This field will give the Datetime that the video will expire and disappear from Content API responses. |
Production Download | The URL to retrieve the production Video file from. Please see the Download section below. |
Ninjs (JSON)
Request
curl \
-H "Accept: application/json" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813?product=paproduct:create
Response
{
"uri": "c8f0d013-9cde-4c71-bc4a-f4486ffd4813",
"type": "video",
"profile": "asset",
"version": "1",
"firstcreated": "2021-02-02T18:08:02Z",
"versioncreated": "2021-02-02T18:08:02Z",
"issued": "2021-02-02T18:08:02Z",
"urgency": 6,
"pubstatus": "usable",
"copyrightholder": "PA",
"copyrightnotice": "PA",
"language": "en",
"byline": "Matt King",
"headline": "Tributes paid to Captain Sir Tom Moore",
"description_text": "The Queen, The Prime Minister and former England cricket captain Michael Vaughan are among the scores of people paying tribute to Captain Sir Tom Moore.",
"body_text": "The Queen, The Prime Minister and former England cricket captain Michael Vaughan are among the scores of people paying tribute to Captain Sir Tom Moore.",
"body_html": "<!-- EMBED START StreamAMG --><div id=\"streamamg_player_1612289412205\" style=\"width: 100%; height: 360px\" data-player-config='{\"partner\": \"3001090\",\"uiConf\": \"30024158\",\"entryId\": \"0_101v492i\"}'></div><script type=\"text/javascript\" src=\"https://pa.streamamg.com/player-embed/loader.js\"></script><!-- EMBED END StreamAMG -->",
"subject": [
{
"code": "patopic:death",
"name": "Death",
"profile": "patopic",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:captaintom",
"name": "CaptainTom",
"profile": "pakeyword",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "pavideotype:consumer-ready",
"name": "Consumer Ready",
"profile": "pavideotype:consumer",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "classifiedAs"
},
{
"code": "paservice:news",
"name": "News",
"profile": "paservice",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "partOf"
},
{
"code": "tag:na",
"name": "NA",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:captain-sir-tom-moore",
"name": "Captain sir tom moore",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:queen",
"name": "Queen",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:pm",
"name": "Pm",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:prime-minister",
"name": "Prime minister",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:michael-vaughan",
"name": "Michael vaughan",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:priti-patel",
"name": "Priti patel",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:nicola-sturgeon",
"name": "Nicola sturgeon",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:gary-lineker",
"name": "Gary lineker",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:death",
"name": "Death",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:nhs",
"name": "Nhs",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:coronavirus",
"name": "Coronavirus",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:michael-ball",
"name": "Michael ball",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:eddie-izzard",
"name": "Eddie izzard",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:archbishop-of-canterbury",
"name": "Archbishop of canterbury",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "tag:royal-family",
"name": "Royal family",
"profile": "tag",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "about"
},
{
"code": "contributor:pa",
"name": "PA",
"profile": "contributor",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "contributedBy"
},
{
"code": "contributor:streamamg",
"name": "StreamAMG",
"profile": "contributor",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "contributedBy"
},
{
"code": "provider:streamamg",
"name": "StreamAMG",
"profile": "provider",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "providedBy"
},
{
"code": "paservice:news:uk",
"name": "UK",
"profile": "paservice",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/subject",
"rel": "partOf"
}
],
"event": [
{
"code": "paevent:7b91f2b66bad94d98e336a590ae25a224051b499843c3b5454629862ec5fdf77",
"name": "Death CaptainTom 02/02/2021",
"profile": "paevent",
"scheme": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/event",
"rel": "partOf"
}
],
"renditions": {
"thumbnail": {
"width": 1920,
"mimetype": "image/jpeg",
"href": "https://cont-img-pxy.pamedia.io/1aHR0cDovL29wZW4uaHR0cC5tcC5zdHJlYW1hbWcuY29tL3AvMzAwMTA5MC9zcC8zMDAxMDkwMDAvdGh1bWJuYWlsL2VudHJ5X2lkLzBfMTAxdjQ5Mmkvd2lkdGgvMTkyMA==4hLVNYP5Z/6ZKzsmfAuZLg==ZMgdRS5KG/w=",
"title": "Video Thumbnail",
"height": 1080
},
"original": {
"width": 1920,
"mimetype": "video/mp4",
"href": "https://content-cont-vid-pxy.pamedia.io/2ZDg3ZTAxY2ItY2UzZC00OTY1LWI2YmQtMzMzM2U3MGU3NDM0wK6rWPHT/8Bguucw7GSlVA==jayKYSGXv2o=",
"title": "Production Video",
"height": 1080
}
},
"links": [
{
"rel": "self",
"href": "https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813"
}
]
}
Important Metadata Mappings
Name | JSON Path |
---|---|
Id | uri |
First Created | firstcreated |
Version Created | versioncreated |
Content | body_html |
Topic | subject[?(@.profile == 'patopic')] |
Keyword | subject[?(@.profile == 'pakeyword')] |
Service | subject[?(@.profile == 'paservice')] |
Thumbnail | renditions.thumbnail.href |
Usage Terms | usageterms |
Expiry | description_expires |
Production Download | renditions.original.href |
ATOM
Request
curl \
-H "Accept: application/atom+xml" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813?product=paproduct:create
Response
<?xml version="1.0" encoding="utf-8" ?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:pa="http://api.pressassociation.io/mrss/" xmlns:snf="http://www.smartnews.be/snf/">
<id>https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813</id>
<title>Press Association: Content API</title>
<updated>2021-02-03T17:08:43.375Z</updated>
<link href="https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813" rel="self"/>
<opensearch:itemsPerPage>1</opensearch:itemsPerPage>
<opensearch:totalResults>1</opensearch:totalResults>
<opensearch:startIndex>0</opensearch:startIndex>
<snf:logo>
<url>http://logo.static.press.net/pa-logo-smartnews.png</url>
</snf:logo>
<entry>
<id>https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813</id>
<author>
<name>Matt King</name>
</author>
<title>
<![CDATA[Tributes paid to Captain Sir Tom Moore]]>
</title>
<link rel="self" href="https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813"/>
<link rel="alternate" href="https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813"/>
<link rel="related" href="https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813/more-like-this"/>
<published>2021-02-02T18:08:02.000Z</published>
<updated>2021-02-02T18:08:02.000Z</updated>
<dcterms:valid>2021-03-15T00:01:00Z</dcterms:valid>
<rights>Please credit: LBC. Up to 3 minutes of footage is cleared for editorial use only on television and online – no social media.</rights>
<summary type="text">
<![CDATA[The Queen, The Prime Minister and former England cricket captain Michael Vaughan are among the scores of people paying tribute to Captain Sir Tom Moore.]]>
</summary>
<content type="html">
<![CDATA[
<!-- EMBED START StreamAMG -->
<div id="streamamg_player_1612289412205" style="width: 100%; height: 360px" data-player-config='{"partner": "3001090","uiConf": "30024158","entryId": "0_101v492i"}'></div>
<script type="text/javascript" src="https://pa.streamamg.com/player-embed/loader.js"></script>
<!-- EMBED END StreamAMG -->]]>
</content>
<category term="patopic:death" scheme="urn:pa:subject:patopic" label="Death"/>
<category term="pakeyword:captaintom" scheme="urn:pa:subject:pakeyword" label="CaptainTom"/>
<category term="pavideotype:consumer-ready" scheme="urn:pa:subject:pavideotype:consumer" label="Consumer Ready"/>
<category term="paservice:news" scheme="urn:pa:subject:paservice" label="News"/>
<category term="tag:na" scheme="urn:pa:subject:tag" label="NA"/>
<category term="tag:captain-sir-tom-moore" scheme="urn:pa:subject:tag" label="Captain sir tom moore"/>
<category term="tag:queen" scheme="urn:pa:subject:tag" label="Queen"/>
<category term="tag:pm" scheme="urn:pa:subject:tag" label="Pm"/>
<category term="tag:prime-minister" scheme="urn:pa:subject:tag" label="Prime minister"/>
<category term="tag:michael-vaughan" scheme="urn:pa:subject:tag" label="Michael vaughan"/>
<category term="tag:priti-patel" scheme="urn:pa:subject:tag" label="Priti patel"/>
<category term="tag:nicola-sturgeon" scheme="urn:pa:subject:tag" label="Nicola sturgeon"/>
<category term="tag:gary-lineker" scheme="urn:pa:subject:tag" label="Gary lineker"/>
<category term="tag:death" scheme="urn:pa:subject:tag" label="Death"/>
<category term="tag:nhs" scheme="urn:pa:subject:tag" label="Nhs"/>
<category term="tag:coronavirus" scheme="urn:pa:subject:tag" label="Coronavirus"/>
<category term="tag:michael-ball" scheme="urn:pa:subject:tag" label="Michael ball"/>
<category term="tag:eddie-izzard" scheme="urn:pa:subject:tag" label="Eddie izzard"/>
<category term="tag:archbishop-of-canterbury" scheme="urn:pa:subject:tag" label="Archbishop of canterbury"/>
<category term="tag:royal-family" scheme="urn:pa:subject:tag" label="Royal family"/>
<category term="contributor:pa" scheme="urn:pa:subject:contributor" label="PA"/>
<category term="contributor:streamamg" scheme="urn:pa:subject:contributor" label="StreamAMG"/>
<category term="provider:streamamg" scheme="urn:pa:subject:provider" label="StreamAMG"/>
<category term="paservice:news:uk" scheme="urn:pa:subject:paservice" label="UK"/>
<category term="profile:asset" scheme="urn:pa:content:profile" label="asset"/>
<category term="type:video" scheme="urn:pa:content:type" label="video"/>
<media:content url="https://content-staging-cont-vid-pxy.pamedia.io/2OGIyYTk4MjAtZGJmYi00ZDQwLWJiYmMtOWI2NTE1MDIwMDI3dWLaZTOU+qEHuf8EM7jGKw==DpsshCo+VMQ=" type="video/mp4" width="1920" height="1080">
<media:category scheme="urn:pa:media:rendition">original</media:category>
</media:content>
<media:thumbnail url="https://cont-img-pxy-staging.pamedia.io/1aHR0cDovL29wZW4uaHR0cC5tcC5zdHJlYW1hbWcuY29tL3AvMzAwMTA5MC9zcC8zMDAxMDkwMDAvdGh1bWJuYWlsL2VudHJ5X2lkLzBfMTAxdjQ5Mmkvd2lkdGgvMTkyMA==4hLVNYP5Z/6ZKzsmfAuZLg==ZMgdRS5KG/w=" width="1920" height="1080"/>
</entry>
</feed>
Important Metadata Mappings
Name | JSON Path |
---|---|
Id | //feed/entry/id |
First Created | //feed/entry/published |
Version Created | //feed/entry/updated |
Content | //feed/entry/content[@scheme="urn:pa:subject:patopic"] |
Topic | //feed/entry/content[@type="html"] |
Keyword | //feed/entry/category[@scheme="urn:pa:subject:pakeyword"] |
Service | //feed/entry/category[@scheme="urn:pa:subject:paservice"] |
Thumbnail | //feed/entry/media:thumbnail/@url |
Usage Terms | //feed/entry/rights |
Expiry | //feed/entry/dcterms:valid |
Production Download | //feed/entry/media:content/@url To verify it is the correct rendition then //feed/entry/media:content/media:category should have a value of 'original' |
RSS
Request
curl \
-H "Accept: application/rss+xml" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813?product=paproduct:create
Response
<?xml version="1.0" encoding="utf-8" ?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:pa="http://api.pressassociation.io/mrss/" xmlns:snf="http://www.smartnews.be/snf/">
<channel>
<title>Press Association: Content API</title>
<description>A collection of content items</description>
<language>en</language>
<link>https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813</link>
<atom:link href="https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813" rel="self"/>
<opensearch:itemsPerPage>1</opensearch:itemsPerPage>
<opensearch:totalResults>1</opensearch:totalResults>
<opensearch:startIndex>0</opensearch:startIndex>
<snf:logo>
<snf:url>http://logo.static.press.net/pa-logo-smartnews.png</snf:url>
</snf:logo>
<lastBuildDate>Wed, 03 Feb 2021 17:08:53 GMT</lastBuildDate>
<item>
<title>Tributes paid to Captain Sir Tom Moore</title>
<link>https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813</link>
<pubDate>Tue, 02 Feb 2021 18:08:02 GMT</pubDate>
<description>
<![CDATA[]]>
</description>
<dcterms:abstract>The Queen, The Prime Minister and former England cricket captain Michael Vaughan are among the scores of people paying tribute to Captain Sir Tom Moore.</dcterms:abstract>
<dc:publisher>PA</dc:publisher>
<dcterms:created>2021-02-02T18:08:02.000Z</dcterms:created>
<dcterms:modified>2021-02-02T18:08:02.000Z</dcterms:modified>
<dcterms:valid>2021-03-15T00:01:00Z</dcterms:valid>
<dc:creator>PA Media</dc:creator>
<dc:rights>Please credit: LBC. Up to 3 minutes of footage is cleared for editorial use only on television and online – no social media.</dc:rights>
<guid isPermaLink="true">https://content-api.staging.eu-west-1.pa-aws-sandbox.io/publish/content/api/v1/item/c8f0d013-9cde-4c71-bc4a-f4486ffd4813</guid>
<content:encoded>
<![CDATA[
<!-- EMBED START StreamAMG -->
<div id="streamamg_player_1612289412205" style="width: 100%; height: 360px" data-player-config='{"partner": "3001090","uiConf": "30024158","entryId": "0_101v492i"}'></div>
<script type="text/javascript" src="https://pa.streamamg.com/player-embed/loader.js"></script>
<!-- EMBED END StreamAMG -->]]>
</content:encoded>
<category domain="urn:pa:subject:patopic">Death</category>
<category domain="urn:pa:subject:pakeyword">CaptainTom</category>
<category domain="urn:pa:subject:pavideotype:consumer">Consumer Ready</category>
<category domain="urn:pa:subject:paservice">News</category>
<category domain="urn:pa:subject:tag">NA</category>
<category domain="urn:pa:subject:tag">Captain sir tom moore</category>
<category domain="urn:pa:subject:tag">Queen</category>
<category domain="urn:pa:subject:tag">Pm</category>
<category domain="urn:pa:subject:tag">Prime minister</category>
<category domain="urn:pa:subject:tag">Michael vaughan</category>
<category domain="urn:pa:subject:tag">Priti patel</category>
<category domain="urn:pa:subject:tag">Nicola sturgeon</category>
<category domain="urn:pa:subject:tag">Gary lineker</category>
<category domain="urn:pa:subject:tag">Death</category>
<category domain="urn:pa:subject:tag">Nhs</category>
<category domain="urn:pa:subject:tag">Coronavirus</category>
<category domain="urn:pa:subject:tag">Michael ball</category>
<category domain="urn:pa:subject:tag">Eddie izzard</category>
<category domain="urn:pa:subject:tag">Archbishop of canterbury</category>
<category domain="urn:pa:subject:tag">Royal family</category>
<category domain="urn:pa:subject:contributor">PA</category>
<category domain="urn:pa:subject:contributor">StreamAMG</category>
<category domain="urn:pa:subject:provider">StreamAMG</category>
<category domain="urn:pa:subject:paservice">UK</category>
<category domain="urn:pa:content:profile">asset</category>
<category domain="urn:pa:content:type">video</category>
<media:content url="https://content-staging-cont-vid-pxy.pamedia.io/2NGMxMmE3NGQtZjcxOS00NjExLThiMjQtZmQ0ZmUzNTVkNDBiZHv3itFWHhHbBv59jBZUBQ==fD/0+X5sSUY=" type="video/mp4" width="1920" height="1080">
<media:category scheme="urn:pa:media:rendition">original</media:category>
</media:content>
<media:thumbnail url="https://cont-img-pxy-staging.pamedia.io/1aHR0cDovL29wZW4uaHR0cC5tcC5zdHJlYW1hbWcuY29tL3AvMzAwMTA5MC9zcC8zMDAxMDkwMDAvdGh1bWJuYWlsL2VudHJ5X2lkLzBfMTAxdjQ5Mmkvd2lkdGgvMTkyMA==4hLVNYP5Z/6ZKzsmfAuZLg==ZMgdRS5KG/w=" width="1920" height="1080"/>
</item>
</channel>
</rss>
Important Metadata Mappings
Name | JSON Path |
---|---|
Id | //rss/channel/item/guid |
First Created | //rss/channel/item/dcterms:created |
Version Created | //rss/channel/item/dcterms:modified |
Content | //rss/channel/item/content:encoded |
Topic | //rss/channel/item/category[@domain="urn:pa:subject:patopic"] |
Keyword | //rss/channel/item/category[@domain="urn:pa:subject:pakeyword"] |
Service | //rss/channel/item/category[@domain="urn:pa:subject:paservice"] |
Thumbnail | //rss/channel/item/media:thumbnail/@url |
Usage Terms | //rss/channel/item/dc:rights |
Expiry | //rss/channel/item/dcterms:valid |
Production Download | //rss/channel/item/media:content/@url To verify it is the correct rendition then //rss/channel/item/media:content/media:category should have a value of 'original' |
Video Type
All of the Videos availble in Create fall into one of two types:
- Consumer Ready - A video that has been edited and is ready for the general public.
- Newsroom Ready - A raw video that is suitable for a news room to edit and distribute themselves.
A subject will be present on each video to denote which type it is.
Ninjs (JSON)
{
...
subject: [
...
{
"code": "pavideotype:newsroom-ready",
"name": "Newsroom Ready",
"profile": "pavideotype:newsroom",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "classifiedAs"
}
...
]
...
}
ATOM
<category term="pavideotype:newsroom-ready" scheme="urn:pa:subject:pavideotype:newsroom" label="Newsroom Ready"/>
RSS
<category domain="urn:pa:subject:pavideotype:newsroom">Newsroom Ready</category>
It is possible to query Content API to only return a feed of a specified type using the andSubject parameter.
Consumer Ready
curl \
-H "Accept: application/rss+xml" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item?product=paproduct:create&andSubject=pavideotype:consumer-ready
Newsroom Ready
curl \
-H "Accept: application/rss+xml" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item?product=paproduct:create&andSubject=pavideotype:newsroom-ready
Download
The video download is only available if you are entitled to download videos. If you aren't entitled and would like to be please speak to your account manager.
To access the download URL you need to fetch the entire video item as described above.
The download URL is time limited link so it will need to be refreshed every time it needs to be accessed.
Each link lasts for 5 minutes. The link will return a 400 BAD REQUEST if it has timed out.
Updated almost 4 years ago