Asset - Social

Definition

Name

Value

Description

Profile

Asset

An individual piece of content.

Type

Social

A post from a social media website.

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.

Content

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

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

Name

JSON Path

Id

uri

First Created

firstcreated

Version Created

versioncreated

Content

body_html

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

Name

JSON 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

Name

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