Asset - Picture

Definition

NameValueDescription
ProfileAssetAn individual piece of content.
TypePictureA photograph.

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 pictures 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/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

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/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

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/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

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"]