• Register

News API v1 - RSS response format

List Response - Navigation

This response type is used for enumerating the available lists of feeds, schedules and packages when accessing the corresponding base endpoint:

<rss version="2.0" 
    xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
    xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>Press Association News API Feeds</title>
        <link>http://news.api.press.net/v1/feeds</link>
        <atom:link rel="self" href="http://news.api.press.net/v1/feeds" type="application/rss+xml"/>
        <description>Press Association News API Feeds</description>
        <lastBuildDate>Mon, 16 Jun 2014 10:45:27 +0000</lastBuildDate>
        <opensearch:totalResults>19</opensearch:totalResults>
        <opensearch:startIndex>1</opensearch:startIndex>
        <opensearch:itemsPerPage>19</opensearch:itemsPerPage>
        <item>
            <title>Business and Finance</title>
            <link>http://news.api.press.net/v1/feeds/businessFinance</link>
            <guid isPermaLink="false">businessFinance</guid>
            <pubDate>Mon, 16 Jun 2014 10:26:37 +0000</pubDate>
        </item>
        ...
    </channel>
</rss>

All list types for the RSS response format are structured as RSS channels, with each option listed as an item. Note that for navigation list responses, the OpenSearchitemsPerPage and totalResults fields will have the same value - all results are returned, and no paging of results is enabled.

Each item has a link, a guid, a title and a pubDate time.

List Response - Assets

The asset list response is returned for packages and schedules, where there is a managed finite set of assets curated by PA editorial teams.

<rss version="2.0" 
    xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
    xmlns:dcterms="http://purl.org/dc/terms/" 
    xmlns:content="http://purl.org/rss/1.0/modules/content/" 
    xmlns:media="http://search.yahoo.com/mrss/" 
    xmlns:pa="http://rss.pressassociation.com/pa" 
    xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>Sport Digital</title>
        <link>http://news.api.press.net/v1/schedules/sportdigital</link>
        <atom:link rel="self" href="http://news.api.press.net/v1/schedules/sportdigital" type="application/rss+xml"/>
        <description>Sport Digital</description>
        <lastBuildDate>Mon, 16 Jun 2014 10:10:56 +0000</lastBuildDate>
        <opensearch:totalResults>37</opensearch:totalResults>
        <opensearch:startIndex>1</opensearch:startIndex>
        <opensearch:itemsPerPage>37</opensearch:itemsPerPage>
        <item>
            ...
        </item>
    </channel>
</rss>

Note that for list responses, the OpenSearch itemsPerPage and totalResults fields will have the same value - all results are returned, and no paging of results is enabled.

Each item is a story represented using the long-form Full Asset Response.

Search Response

The search response is returned for feed listing/searching and ad-hoc general searches. The response is based on the list response, but with additional information to assist navigation through the result space.

<rss version="2.0" 
    xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
    xmlns:dcterms="http://purl.org/dc/terms/" 
    xmlns:content="http://purl.org/rss/1.0/modules/content/" 
    xmlns:media="http://search.yahoo.com/mrss/" 
    xmlns:pa="http://rss.pressassociation.com/pa" 
    xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>Search Results</title>
        <link>http://news.api.press.net/v1/assets?query=Cameron&tag=patopic:POLITICS</link>
        <atom:link rel="self" href="http://news.api.press.net/v1/assets?query=Cameron&tag=patopic:POLITICS" type="application/rss+xml"/>
        <description>Search Results</description>
        <lastBuildDate>Mon, 16 Jun 2014 12:06:13 +0000</lastBuildDate>
        <opensearch:totalResults>8428</opensearch:totalResults>
        <opensearch:startIndex>1</opensearch:startIndex>
        <opensearch:itemsPerPage>10</opensearch:itemsPerPage>
        <pa:facets>
            <pa:facet field="when">
                <pa:facetValue term="today" label="Today" count="4"/>
                <pa:facetValue term="yesterday" label="Yesterday" count="7"/>
                <pa:facetValue term="7-days" label="Last 7 Days" count="107"/>
                <pa:facetValue term="30-days" label="Last 30 Days" count="362"/>
                <pa:facetValue term="older" label="Older" count="8066"/>
            </pa:facet>
            <pa:facet field="tag">
                <pa:facetValue term="pacategory:HHH" label="Home News" count="7008"/>
                <pa:facetValue term="patopic:POLITICS" label="Politics" count="4778"/>
                <pa:facetValue term="pafeattopic:POLITICS" label="Politics" count="3653"/>
                <pa:facetValue term="patopic:CITY" label="City" count="1386"/>
                <pa:facetValue term="subj:11000000" label="politics" count="787"/>
                <pa:facetValue term="pacategory:SCN" label="Scottish News" count="654"/>
                <pa:facetValue term="patopic:ENVIRONMENT" label="Environment" count="626"/>
                <pa:facetValue term="subj:04000000" label="economy, business and finance" count="590"/>
                <pa:facetValue term="patopic:INDUSTRY" label="Industry" count="484"/>
                <pa:facetValue term="patopic:TRANSPORT" label="Transport" count="484"/>
            </pa:facet>
        </pa:facets>
        <item>
            ...
        </item>
    </channel>
</rss>

totalResults and itemsPerPage now have different values, indicating that you can page through the set of search results using the limit and offset parameters.

The search response also includes a set of facets which can be used to drill down further into the result set. The when facet provides a breakdown of results into commonly-used time bands (if a specific band contains no results then it will be omitted). The tag facet reveals how many results include the (up to) 10 most commonly used tags within the result set, inviting guided navigation by adding an additional ?tag= query parameter to add the relevant filter.

All story responses in RSS are represented as a long-form Full Asset Response.

Summary Asset Response

There is no short-form summary representation of an asset in RSS format; the full asset response is used throughout.

Full Asset Response

The full asset response format is used to represent story assets across all RSS endpoints.

        <item>
            <title>Leona Lewis shines at film premiere</title>
            <link>http://news.api.press.net/v1/assets/05947487-4cac-42ba-8b2e-5e15de51f278</link>
            <description>Leona Lewis was Walking On Sunshine at the premiere of her debut film.</description>
            <category>Showbiz</category>
            <category>Film</category>
            <category>Music</category>
            <guid isPermaLink="false">05947487-4cac-42ba-8b2e-5e15de51f278</guid>
            <pubDate>Thu, 12 Jun 2014 08:22:54 +0000</pubDate>
            <content:encoded>
                <![CDATA[<article><p>Leona Lewis was Walking On Sunshine at the premiere of her debut film.</p><p>The former X Factor winner appears in musical film Walking On Sunshine, about a woman getting married in Italy who realises her whirlwind romance is with her sister's former holiday fling.</p><p>Leona said: "Because I'd been to theatre school when I was young, I'd done a bit of acting before, so I wanted to do something like this - specifically I did really want to do a musical and then this came along and it was perfect."</p><p>The Bleeding Love singer, who wore a glittering black gown and white blazer, said she would love to act again.</p><p>"If an opportunity arises from it and it's the right kind of thing, why not? I'd love to do a musical again because this was so much fun and maybe I'll do something more serious too," she said.</p><p>The film also stars Greg Wise, Hannah Arterton, Annabel Scholey, Giulio Berruti and Katy Brand, who were all on the red carpet at the Vue cinema in London's Leicester Square.</p><p>Greg, who arrived with wife Emma Thompson and their daughter, wore a kilt which he said had been his wedding outfit, and danced along the carpet.</p><p>He said: "I can't actually dance, you saw as I walked in what little dancing I could actually do."</p><p>The actor added: "Emma hasn't seen the film yet. My daughter's never seen anything I've been in ever."</p><p>Hannah said of working with Leona: "I was starstruck for quite a long time, it took me a couple of days to pluck up the courage to relax around her. She's such an icon.</p><p>"I do most of the lead vocal on this film so I was, 'oh my God it's Leona, how is that going to work?'."</p><p>Walking On Sunshine is released in cinemas on June 27.</p></article>]]>
            </content:encoded>
            <dcterms:alternative>SHOWBIZ Sunshine</dcterms:alternative>
            <dcterms:isPartOf>634297b7-aa11-4842-8b4c-80b98559db7c</dcterms:isPartOf>
            <media:content url="https://static.images.api.press.net/v1/image/fb5b068c8aff005cc81b4c1a83af984a/2.20081663.jpg" type="image/jpeg" width="2099" height="3500" fileSize="990303">
                <media:thumbnail url="https://static.images.api.press.net/v1/image/thumbnail/fb5b068c8aff005cc81b4c1a83af984a/2.20081663.jpg" width="76" height="127"/>
                <media:thumbnail url="https://static.images.api.press.net/v1/image/preview/fb5b068c8aff005cc81b4c1a83af984a/2.20081663.jpg" width="307" height="512"/>
                <media:description>Leona Lewis attending the Walking On Sunshine premiere in London</media:description>
            </media:content>
            <media:content url="https://static.images.api.press.net/v1/image/91eee60b35bca275e236974dd3429236/2.20081743.jpg" type="image/jpeg" width="2381" height="3500" fileSize="1288932">
                <media:thumbnail url="https://static.images.api.press.net/v1/image/thumbnail/91eee60b35bca275e236974dd3429236/2.20081743.jpg" width="87" height="128"/>
                <media:thumbnail url="https://static.images.api.press.net/v1/image/preview/91eee60b35bca275e236974dd3429236/2.20081743.jpg" width="348" height="512"/>
                <media:description>A kilt-wearing Greg Wise attends the premiere of Walking On Sunshine with wife Emma Thompson and their daughter Gaia</media:description>
            </media:content>
            <media:content url="https://static.images.api.press.net/v1/image/b473fada52b20a6a6501727d1c2b9eba/2.20081575.jpg" type="image/jpeg" width="2221" height="3500" fileSize="1469480">
                <media:thumbnail url="https://static.images.api.press.net/v1/image/thumbnail/b473fada52b20a6a6501727d1c2b9eba/2.20081575.jpg" width="81" height="127"/>
                <media:thumbnail url="https://static.images.api.press.net/v1/image/preview/b473fada52b20a6a6501727d1c2b9eba/2.20081575.jpg" width="324" height="511"/>
                <media:description>Hannah Arterton shows off her vocal talents in Walking On Sunshine</media:description>
            </media:content>
            <pa:videoRef>urn:newsml:pressassociation.com:20140612:Ipkg1402560019886I</pa:videoRef>
        </item>

The elements have the following usage:

KeyRequired?Usage
guid mandatory The unique identifier for the asset
title mandatory The headline of the story
dcterms:isPartOf optional Where a story is part of an update chain - new stories written on the same theme, rather than the same story itself being corrected or extended - then isPartOf is an identifier for that set of stories.
dcterms:alternative mandatory A PA moniker for the story, intended for editorial use but not for display to consumers.
pubDate mandatory The date and time of the last published update to this story
category mandatory The set of classification and entity metadata tagged against the asset.
description optional A short abstract/description of the story. Commonly this is the first paragraph of the story (PA's intros are written to be stand-alone in this way) unless a specific abstract has been written.
media.content mandatory Related pictures for the story, if any. Preview and thumbnails are provided as child media:thumbnail entries, and a caption as media.description.
pa:videoRef optional The ID of a video relating to this story. Videos are uploaded to customers' CDNs and are not available directly through the News API.
content:encoded mandatory The body content of the story, encoded as an HTML5 article

Docs Navigation