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

NameValueDescription
ProfileAssetAn individual piece of content.
TypeVideoA video.

Important Metadata

NameDescription
IdThe unique id of the content item
First CreatedThe timestamp of when the first version of this content item was published.
Version CreatedThe timestamp of when the most recent version of this content item was published.
ContentThe 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.
TopicPA Specific metadata to define an event or story.

For more information please see Subject FAQs.
KeywordPA Specific metadata to define an event or story.

For more information please see Subject FAQs.
ServiceThe service that this content is part of inside of a product.

For more information please see Service FAQ.
ThumbnailThe 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 TermsA description on how this video can be used.
ExpiryCertain 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 DownloadThe 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

NameJSON Path
Iduri
First Createdfirstcreated
Version Createdversioncreated
Contentbody_html
Topicsubject[?(@.profile == 'patopic')]
Keywordsubject[?(@.profile == 'pakeyword')]
Servicesubject[?(@.profile == 'paservice')]
Thumbnailrenditions.thumbnail.href
Usage Termsusageterms
Expirydescription_expires
Production Downloadrenditions.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

NameJSON 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

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