Asset - Social

Definition

NameValueDescription
ProfileAssetAn individual piece of content.
TypeSocialA post from a social media website.

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 social item this is a fragment of HTML that represents the Social Embed.

This can be used on client applications to render the social posts.
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/e7e75760-0106-43a0-b015-420cb4914ea0?product=paproduct:create

Response

{
    "uri": "e7e75760-0106-43a0-b015-420cb4914ea0",
    "type": "social",
    "profile": "asset",
    "version": "1",
    "firstcreated": "2019-10-10T07:06:02Z",
    "versioncreated": "2019-10-10T07:06:02Z",
    "issued": "2019-10-10T07:06:02Z",
    "urgency": 6,
    "pubstatus": "usable",
    "language": "en",
    "headline": "Showbiz Glastonbury",
    "body_html": "<!-- EMBED START Twitter --><figure><blockquote class=\"twitter-tweet\" data-width=\"525\" data-dnt=\"true\"><p lang=\"en\" dir=\"ltr\">We are delighted to announce that <a href=\"https://twitter.com/DianaRoss?ref_src=twsrc%5Etfw\">@DianaRoss</a> will play the Sunday legends slot on the Pyramid Stage at Glastonbury 2020. <a href=\"https://t.co/fm4iewfWqN\">pic.twitter.com/fm4iewfWqN</a></p><p>&mdash; Glastonbury Festival (@GlastoFest) <a href=\"https://twitter.com/GlastoFest/status/1182188668871696385?ref_src=twsrc%5Etfw\">October 10, 2019</a></p></blockquote><script async src=\"//platform.twitter.com/widgets.js\" charset=\"utf-8\"></script></figure><!-- EMBED END Twitter -->",
    "subject": [
        {
            "code": "paservice:entertainment",
            "name": "Entertainment",
            "profile": "paservice",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "partOf"
        },
        {
            "code": "paservice:entertainment:music",
            "name": "Music",
            "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"
        },
        {
            "code": "patopic:showbiz",
            "name": "Showbiz",
            "profile": "patopic",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "about"
        },
        {
            "code": "pakeyword:glastonbury",
            "name": "Glastonbury",
            "profile": "pakeyword",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "about"
        },
        {
            "code": "paterritory:uk",
            "name": "UK",
            "profile": "paterritory",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "intendedFor"
        },
        {
            "code": "provider:twitter",
            "name": "Twitter",
            "profile": "provider",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "providedBy"
        },
        {
            "code": "contributor:pa",
            "name": "PA",
            "profile": "contributor",
            "scheme": "https://content.api.pressassociation.io/v1/subject",
            "rel": "contributedBy"
        }
    ],
    "event": [
        {
            "code": "paevent:7a9e80ec3bddff2f095219de5ec9817dc92f8b9dd962818c68a47164eab4ed58",
            "name": "Showbiz Glastonbury 10/10/2019",
            "profile": "paevent",
            "scheme": "https://content.api.pressassociation.io/v1/event",
            "rel": "partOf"
        }
    ],
    "renditions": {
        "original": {
            "href": "https://twitter.com/GlastoFest/status/1182188668871696385"
        }
    },
    "links": [
        {
            "rel": "self",
            "href": "https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0"
        }
    ]
}

Important Metadata Mappings

NameJSON Path
Iduri
First Createdfirstcreated
Version Createdversioncreated
Contentbody_html
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/e7e75760-0106-43a0-b015-420cb4914ea0?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/e7e75760-0106-43a0-b015-420cb4914ea0</id>
    <title>Press Association: Content API</title>
    <updated>2019-10-11T14:58:44.472Z</updated>
    <link href="https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0" 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/e7e75760-0106-43a0-b015-420cb4914ea0</id>
        <author>
            <name></name>
        </author>
        <title>
            <![CDATA[Showbiz Glastonbury]]>
        </title>
        <link rel="self" href="https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0"/>
        <link rel="alternate" href="https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0"/>
        <link rel="related" href="https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0/more-like-this"/>
        <published>2019-10-10T07:06:02.000Z</published>
        <updated>2019-10-10T07:06:02.000Z</updated>
        <content type="html">
            <![CDATA[
            <!-- EMBED START Twitter -->
            <figure>
                <blockquote class="twitter-tweet" data-width="525" data-dnt="true">
                    <p lang="en" dir="ltr">We are delighted to announce that 
                        <a href="https://twitter.com/DianaRoss?ref_src=twsrc%5Etfw">@DianaRoss</a> will play the Sunday legends slot on the Pyramid Stage at Glastonbury 2020.
                        <a href="https://t.co/fm4iewfWqN">pic.twitter.com/fm4iewfWqN</a>
                    </p>
                    <p>&mdash; Glastonbury Festival (@GlastoFest) 
                        <a href="https://twitter.com/GlastoFest/status/1182188668871696385?ref_src=twsrc%5Etfw">October 10, 2019</a>
                    </p>
                </blockquote>
                <script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>
            </figure>
            <!-- EMBED END Twitter -->]]>
        </content>
        <category term="paservice:entertainment" scheme="urn:pa:subject:paservice" label="Entertainment"/>
        <category term="paservice:entertainment:music" scheme="urn:pa:subject:paservice" label="Music"/>
        <category term="paservice:entertainment:uk" scheme="urn:pa:subject:paservice" label="UK"/>
        <category term="patopic:showbiz" scheme="urn:pa:subject:patopic" label="Showbiz"/>
        <category term="pakeyword:glastonbury" scheme="urn:pa:subject:pakeyword" label="Glastonbury"/>
        <category term="paterritory:uk" scheme="urn:pa:subject:paterritory" label="UK"/>
        <category term="provider:twitter" scheme="urn:pa:subject:provider" label="Twitter"/>
        <category term="contributor:pa" scheme="urn:pa:subject:contributor" label="PA"/>
        <category term="profile:asset" scheme="urn:pa:content:profile" label="asset"/>
        <category term="type:social" scheme="urn:pa:content:type" label="social"/>
        <media:content url="https://twitter.com/GlastoFest/status/1182188668871696385"></media:content>
    </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"]

RSS

Request

curl \
  -H "Accept: application/rss+xml" \
  -H "apikey: <API KEY>" \
  https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0?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/e7e75760-0106-43a0-b015-420cb4914ea0</link>
        <atom:link href="https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0" 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:59:01 GMT</lastBuildDate>
        <item>
            <title>Showbiz Glastonbury</title>
            <link>https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0</link>
            <pubDate>Thu, 10 Oct 2019 07:06:02 GMT</pubDate>
            <dc:publisher>PA</dc:publisher>
            <dcterms:created>2019-10-10T07:06:02.000Z</dcterms:created>
            <dcterms:modified>2019-10-10T07:06:02.000Z</dcterms:modified>
            <guid isPermaLink="true">https://content.api.pressassociation.io/v1/item/e7e75760-0106-43a0-b015-420cb4914ea0</guid>
            <content:encoded>
                <![CDATA[
                <!-- EMBED START Twitter -->
                <figure>
                    <blockquote class="twitter-tweet" data-width="525" data-dnt="true">
                        <p lang="en" dir="ltr">We are delighted to announce that 
                            <a href="https://twitter.com/DianaRoss?ref_src=twsrc%5Etfw">@DianaRoss</a> will play the Sunday legends slot on the Pyramid Stage at Glastonbury 2020.
                            <a href="https://t.co/fm4iewfWqN">pic.twitter.com/fm4iewfWqN</a>
                        </p>
                        <p>&mdash; Glastonbury Festival (@GlastoFest) 
                            <a href="https://twitter.com/GlastoFest/status/1182188668871696385?ref_src=twsrc%5Etfw">October 10, 2019</a>
                        </p>
                    </blockquote>
                    <script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>
                </figure>
                <!-- EMBED END Twitter -->]]>
            </content:encoded>
            <category domain="urn:pa:subject:paservice">Entertainment</category>
            <category domain="urn:pa:subject:paservice">Music</category>
            <category domain="urn:pa:subject:paservice">UK</category>
            <category domain="urn:pa:subject:patopic">Showbiz</category>
            <category domain="urn:pa:subject:pakeyword">Glastonbury</category>
            <category domain="urn:pa:subject:paterritory">UK</category>
            <category domain="urn:pa:subject:provider">Twitter</category>
            <category domain="urn:pa:subject:contributor">PA</category>
            <category domain="urn:pa:content:profile">asset</category>
            <category domain="urn:pa:content:type">social</category>
            <media:content url="https://twitter.com/GlastoFest/status/1182188668871696385"></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
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"]