Asset - Graphic

Definition

NameValueDescription
ProfileAssetAn individual piece of content.
TypeGraphicAn infographic image.

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.
Copyright HolderThe copyright holder for the picture.
Usage TermsAny special instructions around the usage of this picture.
Picture URLThe URL to retrieve the picture from.
BylineThe specific person or company that took the picture.
CaptionThe graphics caption.
This is normally displayed alongside the picture.
Alt TextA piece of text to be used when the picture is not available or cannot be seen by the user.
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.

Ninjs (JSON)

Request

curl \
  -H "Accept: application/json" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b?product=paproduct:create

Response

{
    "uri": "e8419b82-cfd3-4485-8cd5-9b95f9231f4b",
    "type": "graphic",
    "profile": "asset",
    "version": "1",
    "contentcreated": "2019-10-06T00:00:00Z",
    "firstcreated": "2019-10-06T19:10:39Z",
    "versioncreated": "2019-10-06T19:10:39Z",
    "issued": "2019-10-06T19:10:39Z",
    "urgency": 6,
    "pubstatus": "usable",
    "copyrightholder": "PA Graphics",
    "copyrightnotice": "PA Graphics/Press Association Images",
    "usageterms": "",
    "language": "en",
    "byline": "PA Graphics",
    "headline": "SHOWBIZ Strictly",
    "description_text": "Strictly Come Dancing, celebrities still in the competition as of Sunday October 6. See story SHOWBIZ Strictly. Editable versions of this graphic are available via PA Graphics or your account manager. Infographic by PA Graphics",
    "body_text": "Strictly Come Dancing, celebrities still in the competition as of Sunday October 6. See story SHOWBIZ Strictly. Editable versions of this graphic are available via PA Graphics or your account manager. Infographic by PA Graphics",
    "subject": [
        {
            "code": "paservice:entertainment",
            "name": "Entertainment",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "patopic:showbiz",
            "name": "SHOWBIZ",
            "profile": "patopic",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "about"
        },
        {
            "code": "pakeyword:strictly",
            "name": "Strictly",
            "profile": "pakeyword",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "about"
        },
        {
            "code": "paservice:entertainment:tv",
            "name": "TV",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "paservice:entertainment:uk",
            "name": "UK",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        }
    ],
    "event": [
        {
            "code": "paevent:59f91c1c4f74638765e792bc88d2ea97ab25aaf19e6223025f145bd0dbfab85c",
            "name": "SHOWBIZ Strictly 06/10/2019",
            "profile": "paevent",
            "scheme": "https://content.api.pressassociation.io/v1/event",
            "rel": "partOf"
        }
    ],
    "renditions": {
        "original": {
            "href": "https://image.assets.pressassociation.io/v2/image/production/9bd2573c1764ce2a5ed2ed606a1b02b0/2.45877955.jpg",
            "mimetype": "image/jpeg",
            "height": 1290,
            "width": 1400,
            "orientation": "landscape"
        }
    },
    "links": [
        {
            "rel": "self",
            "href": "https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b"
        }
    ]
}

Important Metadata Mappings

NameJSON Path
Iduri
First Createdfirstcreated
Version Createdversioncreated
Copyright Holdercopyrightholder
Usage Termsusageterms
Picture URLrenditions.original.href
Bylinebyline
Captiondescription_text
Alt Textbody_text
Topicsubject[?(@.profile == 'patopic')]
Keywordsubject[?(@.profile == 'pakeyword')]
Servicesubject[?(@.profile == 'paservice')]

ATOM

Request

curl \
  -H "Accept: application/atom+xml" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b?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.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b</id>
    <title>Press Association: Content API</title>
    <updated>2019-10-11T14:10:01.019Z</updated>
    <link href="https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b" 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.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b</id>
        <author>
            <name>PA Graphics</name>
        </author>
        <title>
            <![CDATA[SHOWBIZ Strictly]]>
        </title>
        <link rel="self" href="https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b"/>
        <link rel="alternate" href="https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b"/>
        <link rel="related" href="https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b/more-like-this"/>
        <published>2019-10-06T19:10:39.000Z</published>
        <updated>2019-10-06T19:10:39.000Z</updated>
        <summary type="text">
            <![CDATA[Strictly Come Dancing, celebrities still in the competition as of Sunday October 6. See story SHOWBIZ Strictly. Editable versions of this graphic are available via PA Graphics or your account manager. Infographic by PA Graphics]]>
        </summary>
        <category term="paservice:entertainment" scheme="urn:pa:subject:paservice" label="Entertainment"/>
        <category term="patopic:showbiz" scheme="urn:pa:subject:patopic" label="SHOWBIZ"/>
        <category term="pakeyword:strictly" scheme="urn:pa:subject:pakeyword" label="Strictly"/>
        <category term="paservice:entertainment:tv" scheme="urn:pa:subject:paservice" label="TV"/>
        <category term="paservice:entertainment:uk" scheme="urn:pa:subject:paservice" label="UK"/>
        <category term="profile:asset" scheme="urn:pa:content:profile" label="asset"/>
        <category term="type:graphic" scheme="urn:pa:content:type" label="graphic"/>
        <media:content url="https://image.assets.pressassociation.io/v2/image/production/9bd2573c1764ce2a5ed2ed606a1b02b0/2.45877955.jpg" type="image/jpeg" width="1400" height="1290"></media:content>
    </entry>
</feed>

Important Metadata Mappings

NameJSON Path
Id//feed/entry/id
First Created//feed/entry/published
Version Created//feed/entry/updated
Copyright HolderN/A
Usage TermsN/A
Picture URL//feed/entry/media:content/@url
Byline//feed/entry/author/name
Caption//feed/entry/summary[@type="text"]
Alt TextN/A
Topic//feed/entry/category[@scheme="urn:pa:subject:patopic"]
Keyword//feed/entry/category[@scheme="urn:pa:subject:pakeyword"]
Service//feed/entry/category[@scheme="urn:pa:subject:paservice"]

RSS

Request

curl \
  -H "Accept: application/rss+xml" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b?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.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b</link>
        <atom:link href="https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b" 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>Fri, 11 Oct 2019 14:10:21 GMT</lastBuildDate>
        <item>
            <title>SHOWBIZ Strictly</title>
            <link>https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b</link>
            <pubDate>Sun, 06 Oct 2019 19:10:39 GMT</pubDate>
            <description>
                <![CDATA[]]>
            </description>
            <dcterms:abstract>Strictly Come Dancing, celebrities still in the competition as of Sunday October 6. See story SHOWBIZ Strictly. Editable versions of this graphic are available via PA Graphics or your account manager. Infographic by PA Graphics</dcterms:abstract>
            <dc:publisher>PA</dc:publisher>
            <dcterms:created>2019-10-06T19:10:39.000Z</dcterms:created>
            <dcterms:modified>2019-10-06T19:10:39.000Z</dcterms:modified>
            <dc:creator>PA Graphics</dc:creator>
            <guid isPermaLink="true">https://content.api.pressassociation.io/v1/item/e8419b82-cfd3-4485-8cd5-9b95f9231f4b</guid>
            <category domain="urn:pa:subject:paservice">Entertainment</category>
            <category domain="urn:pa:subject:patopic">SHOWBIZ</category>
            <category domain="urn:pa:subject:pakeyword">Strictly</category>
            <category domain="urn:pa:subject:paservice">TV</category>
            <category domain="urn:pa:subject:paservice">UK</category>
            <category domain="urn:pa:content:profile">asset</category>
            <category domain="urn:pa:content:type">graphic</category>
            <media:content url="https://image.assets.pressassociation.io/v2/image/production/9bd2573c1764ce2a5ed2ed606a1b02b0/2.45877955.jpg" type="image/jpeg" width="1400" height="1290"></media:content>
        </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
Copyright Holdercopyrightholder
Usage Termsusageterms
Picture URL//rss/channel/item/media:content/@url
Byline//rss/channel/item/dc:creator
Caption//rss/channel/item/dcterms:abstract
Alt TextN/A
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"]