Asset - Picture

Definition

Name	Value	Description
Profile	Asset	An individual piece of content.
Type	Picture	A photograph.

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.
Copyright Holder	The copyright holder for the picture.
Usage Terms	Any special instructions around the usage of this picture.
Picture URL	The URL to retrieve the picture from.
Byline	The specific person or company that took the picture.
Caption	The pictures caption. This is normally displayed alongside the picture.
Alt Text	A piece of text to be used when the picture is not available or cannot be seen by the user.
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.

Ninjs (JSON)

Request

curl \
  -H "Accept: application/json" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77?product=paproduct:create

Response

{
    "uri": "734ab7a8-2482-4708-be81-76ca2b00ca77",
    "type": "picture",
    "profile": "asset",
    "version": "1",
    "contentcreated": "2019-10-11T10:20:09Z",
    "firstcreated": "2019-10-11T11:45:17Z",
    "versioncreated": "2019-10-11T11:45:17Z",
    "issued": "2019-10-11T11:45:17Z",
    "urgency": 6,
    "pubstatus": "usable",
    "copyrightholder": "PA WIRE",
    "copyrightnotice": "PA Wire/PA Images",
    "usageterms": "",
    "language": "en",
    "byline": "Aaron Chown",
    "headline": "Queen Elizabeth II opens Haig Housing Trust development",
    "description_text": "Queen Elizabeth II arrives to visit Haig Housing Trust, Morden, London, where she will officially open their new housing development for armed forces veterans and the ex-service community.",
    "body_text": "Queen Elizabeth II arrives to visit Haig Housing Trust, Morden, London, where she will officially open their new housing development for armed forces veterans and the ex-service community.",
    "subject": [
        {
            "code": "paservice:news",
            "name": "News",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "pakeyword:queen",
            "name": "Queen",
            "profile": "pakeyword",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "about"
        },
        {
            "code": "patopic:royal",
            "name": "ROYAL",
            "profile": "patopic",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "about"
        },
        {
            "code": "paservice:news:world",
            "name": "World",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "paservice:news:uk",
            "name": "UK",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "paservice:news:scotland",
            "name": "Scotland",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "paservice:news:northern-ireland",
            "name": "Northern Ireland",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "paservice:news:ireland",
            "name": "Ireland",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        }
    ],
    "event": [
        {
            "code": "paevent:d83658dc4885e19e7cd14a3807ee17a234b4e11fcd98d0e717b7cf5d7a5d5d97",
            "name": "ROYAL Queen 11/10/2019",
            "profile": "paevent",
            "scheme": "https://content.api.pressassociation.io/v1/event",
            "rel": "partOf"
        }
    ],
    "place": [
        {
            "code": "country:gb",
            "name": "UK",
            "profile": "country",
            "scheme": "http://images-repository/v1/place",
            "rel": "mentions"
        },
        {
            "code": "city:london",
            "name": "London",
            "profile": "country",
            "scheme": "http://images-repository/v1/place",
            "rel": "mentions"
        }
    ],
    "renditions": {
        "original": {
            "href": "https://image.assets.pressassociation.io/v2/image/production/3f6ced4f7767fecde87f437325bee8ee/2.46402030.jpg",
            "mimetype": "image/jpeg",
            "height": 1445,
            "width": 963,
            "orientation": "portrait"
        }
    },
    "links": [
        {
            "rel": "self",
            "href": "https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77"
        }
    ]
}

Important Metadata Mappings

Name	JSON Path
Id	uri
First Created	firstcreated
Version Created	versioncreated
Copyright Holder	copyrightholder
Usage Terms	usageterms
Picture URL	renditions.original.href
Byline	byline
Caption	description_text
Alt Text	body_text
Topic	subject[?(@.profile == 'patopic')]
Keyword	subject[?(@.profile == 'pakeyword')]
Service	subject[?(@.profile == 'paservice')]

ATOM

Request

curl \
  -H "Accept: application/atom+xml" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77?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/734ab7a8-2482-4708-be81-76ca2b00ca77</id>
    <title>Press Association: Content API</title>
    <updated>2019-10-11T12:40:12.287Z</updated>
    <link href="https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77" 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/734ab7a8-2482-4708-be81-76ca2b00ca77</id>
        <author>
            <name>Aaron Chown</name>
        </author>
        <title>
            <![CDATA[Queen Elizabeth II opens Haig Housing Trust development]]>
        </title>
        <link rel="self" href="https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77"/>
        <link rel="alternate" href="https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77"/>
        <link rel="related" href="https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77/more-like-this"/>
        <published>2019-10-11T11:45:17.000Z</published>
        <updated>2019-10-11T11:45:17.000Z</updated>
        <summary type="text">
            <![CDATA[Queen Elizabeth II arrives to visit Haig Housing Trust, Morden, London, where she will officially open their new housing development for armed forces veterans and the ex-service community.]]>
        </summary>
        <category term="paservice:news" scheme="urn:pa:subject:paservice" label="News"/>
        <category term="pakeyword:queen" scheme="urn:pa:subject:pakeyword" label="Queen"/>
        <category term="patopic:royal" scheme="urn:pa:subject:patopic" label="ROYAL"/>
        <category term="paservice:news:world" scheme="urn:pa:subject:paservice" label="World"/>
        <category term="paservice:news:uk" scheme="urn:pa:subject:paservice" label="UK"/>
        <category term="paservice:news:scotland" scheme="urn:pa:subject:paservice" label="Scotland"/>
        <category term="paservice:news:northern-ireland" scheme="urn:pa:subject:paservice" label="Northern Ireland"/>
        <category term="paservice:news:ireland" scheme="urn:pa:subject:paservice" label="Ireland"/>
        <category term="country:gb" scheme="urn:pa:place:country" label="UK"/>
        <category term="city:london" scheme="urn:pa:place:country" label="London"/>
        <category term="profile:asset" scheme="urn:pa:content:profile" label="asset"/>
        <category term="type:picture" scheme="urn:pa:content:type" label="picture"/>
        <media:content url="https://image.assets.pressassociation.io/v2/image/production/3f6ced4f7767fecde87f437325bee8ee/2.46402030.jpg" type="image/jpeg" width="963" height="1445"></media:content>
    </entry>
</feed>

Important Metadata Mappings

Name	JSON Path
Id	//feed/entry/id
First Created	//feed/entry/published
Version Created	//feed/entry/updated
Copyright Holder	N/A
Usage Terms	N/A
Picture URL	//feed/entry/media:content/@url
Byline	//feed/entry/author/name
Caption	//feed/entry/summary[@type="text"]
Alt Text	N/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/734ab7a8-2482-4708-be81-76ca2b00ca77?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/734ab7a8-2482-4708-be81-76ca2b00ca77</link>
        <atom:link href="https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77" 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 12:41:21 GMT</lastBuildDate>
        <item>
            <title>Queen Elizabeth II opens Haig Housing Trust development</title>
            <link>https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77</link>
            <pubDate>Fri, 11 Oct 2019 11:45:17 GMT</pubDate>
            <description>
                <![CDATA[]]>
            </description>
            <dcterms:abstract>Queen Elizabeth II arrives to visit Haig Housing Trust, Morden, London, where she will officially open their new housing development for armed forces veterans and the ex-service community.</dcterms:abstract>
            <dc:publisher>PA</dc:publisher>
            <dcterms:created>2019-10-11T11:45:17.000Z</dcterms:created>
            <dcterms:modified>2019-10-11T11:45:17.000Z</dcterms:modified>
            <dc:creator>Aaron Chown</dc:creator>
            <guid isPermaLink="true">https://content.api.pressassociation.io/v1/item/734ab7a8-2482-4708-be81-76ca2b00ca77</guid>
            <category domain="urn:pa:subject:paservice">News</category>
            <category domain="urn:pa:subject:pakeyword">Queen</category>
            <category domain="urn:pa:subject:patopic">ROYAL</category>
            <category domain="urn:pa:subject:paservice">World</category>
            <category domain="urn:pa:subject:paservice">UK</category>
            <category domain="urn:pa:subject:paservice">Scotland</category>
            <category domain="urn:pa:subject:paservice">Northern Ireland</category>
            <category domain="urn:pa:subject:paservice">Ireland</category>
            <category domain="urn:pa:place:country">UK</category>
            <category domain="urn:pa:place:country">London</category>
            <category domain="urn:pa:content:profile">asset</category>
            <category domain="urn:pa:content:type">picture</category>
            <media:content url="https://image.assets.pressassociation.io/v2/image/production/3f6ced4f7767fecde87f437325bee8ee/2.46402030.jpg" type="image/jpeg" width="963" height="1445"></media:content>
        </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
Copyright Holder	copyrightholder
Usage Terms	usageterms
Picture URL	//rss/channel/item/media:content/@url
Byline	//rss/channel/item/dc:creator
Caption	//rss/channel/item/dcterms:abstract
Alt Text	N/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"]