• Register

News API v1.5 - ATOM response format

Back to top

List Response - Navigation

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

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <link rel="self" href="http://news.api.press.net/v1.5/feeds" />
  <title>Press Association News API Feeds</title>
  <updated>2015-08-17T10:33:59.083Z</updated>
  <id>http://news.api.press.net/v1.5/feeds</id>
  <author>
    <name>Press Association</name>
  </author>
  <opensearch:totalResults>25</opensearch:totalResults>
  <opensearch:startIndex>1</opensearch:startIndex>
  <opensearch:itemsPerPage>10</opensearch:itemsPerPage>
  <entry>
    <title>Business and Finance</title>
    <id>http://news.api.press.net/v1.5/feeds/businessFinance</id>
    <updated>2015-08-17T10:33:59.083Z</updated>
    <link rel="alternate" href="http://news.api.press.net/v1.5/feeds/businessFinance" />
  </entry>
  <entry ...  
</feed>

All list types for the ATOM response format are structured as ATOM feeds, with each option listed as an entry. Note that for navigation list responses, paging of results is enabled and may be controlled by the offset and limit parameters. The itemsPerPage will be be no more than limit, whilst totalResults will be the total list size.

Each entry has an idtitle and updated time, as well as an alternate link which must be used to access the resource. Do not assume that the id field will take the form of a visitable URL.

Search Response

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

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:pa="http://rss.pressassociation.com/pa">
  <title>Search Results</title>
  <id>http://news.api.press.net/v1.5/assets?sortby=modified:desc&amp;facets=when,tag</id>
  <author>
    <name>Press Association</name>
  </author>
  <updated>2015-08-17T10:42:42.695Z</updated>
  <link rel="self" href="http://news.api.press.net/v1.5/assets?sortby=modified:desc&amp;facets=when,tag" />
  <link rel="next" href="http://news.api.press.net/v1.5/assets?sortby=modified:desc&amp;facets=when,tag&amp;offset=11" />
  <link rel="last" href="http://news.api.press.net/v1.5/assets?sortby=modified:desc&amp;facets=when,tag&amp;offset=5299191" />
  <opensearch:totalResults>5299194</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="195" />
      <pa:facetValue term="yesterday" label="Yesterday" count="239" />
      <pa:facetValue term="7-days" label="7-days" count="3252" />
      <pa:facetValue term="30-days" label="30-days" count="12432" />
      <pa:facetValue term="older" label="Older" count="5286762" />
    </pa:facet>
    <pa:facet field="tag">
      <pa:facetValue term="pacategory:HHH" label="Home News" count="1536368" />
      <pa:facetValue term="pasportstopic:SOCCER" label="Soccer" count="1036639" />
      <pa:facetValue term="pacategory:SSO" label="Soccer News" count="829704" />
      <pa:facetValue term="pacategory:SSS" label="Sport News" count="571106" />
      <pa:facetValue term="pacategory:OOO" label="Foreign News" count="345543" />
      <pa:facetValue term="pacategory:FSP" label="Foreign Sport" count="336559" />
      <pa:facetValue term="pasportstopic:RACING" label="Racing" count="336195" />
      <pa:facetValue term="pacategory:SRR" label="Racing News Avisories/racing tips/etc" count="334797" />
      <pa:facetValue term="patopic:POLICE" label="Police" count="230352" />
      <pa:facetValue term="patopic:COURTS" label="Courts" count="227756" />
    </pa:facet>
  </pa:facets>
  <entry>
    <id>http://news.api.press.net/v1.5/assets/71890800-3f4f-48b7-bb5b-d3f179961a53</id>
    <title>Chief executives' average pay '183 times that of workers'</title>
    <dcterms:alternative>INDUSTRY Pay</dcterms:alternative>
    <pa:leadNumber>0</pa:leadNumber>
    <updated>2015-08-17T10:27:13.764Z</updated>
    <link rel="alternate" href="http://news.api.press.net/v1.5/assets/71890800-3f4f-48b7-bb5b-d3f179961a53" />
    <link rel="story" href="http://news.api.press.net/v1.5/stories/ea4b7e43-4548-4c2d-9081-834fdff27a00" />
    <category term="pakeyword:pay" label="Pay" scheme="keyword" />
    <category term="tag:high-pay-centre" label="High Pay Centre" scheme="simple-tag" />
    <category term="tag:chief-executives" label="Chief executives" scheme="simple-tag" />
    <category term="tag:ftse-100-index" label="FTSE 100 Index" scheme="simple-tag" />
    <category term="tag:tuc" label="TUC" scheme="simple-tag" />
    <category term="patopic:INDUSTRY" label="Industry" scheme="wire-topic" />
    <category term="patopic:CITY" label="City" scheme="wire-topic" />
    <category term="patopic:MONEY" label="Money" scheme="wire-topic" />
    <category term="pacategory:HHH" label="Home News" scheme="category" />
    <summary>The average pay of a chief executive in leading companies is almost £5 million - 183 times that of workers, a new study has revealed.</summary>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/eaa92cced98a30df4e65c8e7228170ee/2.23639132.jpg" width="511" height="376" />
    <media:content url="https://news.static.press.net/v2/image/production/94c2e658caba03c85046223ba0240a72/2.23639132.jpg" type="image/jpeg" width="3500" height="2577" fileSize="1952257">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/35ce40fc6615dd2dd5e42223374768d7/2.23639132.jpg" width="128" height="94" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/eaa92cced98a30df4e65c8e7228170ee/2.23639132.jpg" width="511" height="376" />
      <media:title>Pay study</media:title>
      <media:description>The High Pay Centre think tank found that chief executives' average pay jumped to £4.964 million in 2014</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <pa:type>asset</pa:type>
    <pa:embargoed>2015-08-16T23:01:00.000Z</pa:embargoed>
  </entry>
  <entry ... 
</feed>

Again the totalResults and itemsPerPage have different values, indicating that you can page through the set of search results using the limit and offset parameters. Also note the atom link elements with a rel attribute of "next" and "last", to assist navigation through the result set.

The above search response also includes a set of facets which can be used to drill down further into the result set, enabled by use of the facets parameter. 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.

For search responses in ATOM, each entry is a story represented as a short-form Summary Asset Response.

Package response

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

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:pa="http://rss.pressassociation.com/pa">
  <title>Main News</title>
  <id>http://news.api.press.net/v1.5/packages/news-main</id>
  <author>
    <name>Press Association</name>
  </author>
  <link rel="self" href="http://news.api.press.net/v1.5/packages/news-main" />
  <updated>2015-08-17T10:46:07.215Z</updated>
  <opensearch:totalResults>10</opensearch:totalResults>
  <opensearch:startIndex>1</opensearch:startIndex>
  <opensearch:itemsPerPage>10</opensearch:itemsPerPage>
  <entry>
    <id>http://news.api.press.net/v1.5/assets/49788d50-b932-4235-97cb-08809fad47bb</id>
    <title>Family seeks private prosecution against Glasgow bin lorry crash driver</title>
    <dcterms:alternative>INQUIRY Lorry</dcterms:alternative>
    <pa:leadNumber>2</pa:leadNumber>
    <updated>2015-08-17T10:46:04.816Z</updated>
    <link rel="self" href="http://news.api.press.net/v1.5/assets/49788d50-b932-4235-97cb-08809fad47bb" />
    <link rel="story" href="http://news.api.press.net/v1.5/stories/6edfe35e-0c0f-490b-801f-9161ff986fc8" />
    <category term="pakeyword:lorry" label="Lorry" scheme="keyword" />
    <category term="tag:bin-lorry" label="Bin lorry" scheme="simple-tag" />
    <category term="tag:harry-clarke" label="Harry Clarke" scheme="simple-tag" />
    <category term="tag:driver" label="Driver" scheme="simple-tag" />
    <category term="tag:glasgow" label="Glasgow" scheme="simple-tag" />
    <category term="tag:jacqueline-morton" label="Jacqueline Morton" scheme="simple-tag" />
    <category term="tag:glasgow-sheriff-court" label="Glasgow Sheriff Court" scheme="simple-tag" />
    <category term="patopic:INQUIRY" label="Inquiry" scheme="wire-topic" />
    <category term="pacategory:HHH" label="Home News" scheme="category" />
    <category term="pacategory:SCN" label="Scottish News" scheme="category" />
    <summary>The family of a woman killed in the Glasgow bin lorry crash will seek to bring charges against the driver after prosecutors ruled out a case against him.</summary>
    <author>
      <name>By Lucy Christie and Paul Ward, Press Association Scotland</name>
    </author>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/8ad6efa8758d4de8a02553c52fdb2b1a/2.23748721.jpg" width="511" height="312" />
    <media:content url="https://news.static.press.net/v2/image/production/b395a0e5781240fe30b4331129850209/2.23748721.jpg" type="image/jpeg" width="4000" height="2440" fileSize="1850504">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/f5a6371397ebcd523e55d105e446ba54/2.23748721.jpg" width="127" height="78" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/8ad6efa8758d4de8a02553c52fdb2b1a/2.23748721.jpg" width="511" height="312" />
      <media:title>Bin lorry crash</media:title>
      <media:description>The scene in Glasgow's George Square after the bin lorry killed six people</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <content type="html">&lt;article&gt;&lt;section data-page-number="1" data-page-modified="2015-08-17T10:46:04Z"&gt;&lt;p&gt;The family of a woman killed in the Glasgow bin lorry crash will seek to bring charges against the driver after prosecutors ruled out a case against him.&lt;/p&gt;&lt;p&gt;Lawyers acting for Jacqueline Morton, 51, have requested that an inquiry under way into the December 22 tragedy be halted as they attempt to bring a private prosecution against Harry Clarke, 58.&lt;/p&gt;&lt;p&gt;Mr Clarke was behind the wheel of the council refuse truck that veered out of control on a busy shopping street, killing Ms Morton, from Glasgow, and five others.&lt;/p&gt;&lt;p&gt;A fatal accident inquiry at Glasgow Sheriff Court has heard evidence that Mr Clarke had a history of dizzy spells and fainting which he failed to disclose to the DVLA and on job application forms.&lt;/p&gt;&lt;p&gt;Dorothy Bain QC, told Sheriff John Beckett she had been instructed to seek an adjournment of the inquiry in order to seek authority to bring a private prosecution.&lt;/p&gt;&lt;p&gt;Funding has still to be secured and it may take up to three months to establish whether they can proceed, she said.&lt;/p&gt;&lt;p&gt;A lawyer for the family of victim Gillian Ewing, 52, from Edinburgh, said they supported the motion for adjournment but relatives of 29-year-old Stephenie Tait, from Glasgow, said they would not be involved in any private prosecution.&lt;/p&gt;&lt;p&gt;Ronald Conway, solicitor for the Taits, said public interest would best be served by continuing with the inquiry, which is looking at Mr Clarke's medical history, the bin lorry and the route it took three days before Christmas.&lt;/p&gt;&lt;p&gt;He said: "Telling lies is not a crime; telling lies to the medical profession is not a crime."&lt;/p&gt;&lt;p&gt;Erin McQuade, 18, and her grandparents Jack Sweeney, 68, and Lorraine Sweeney, 69, from Dumbarton, also died in the tragedy.&lt;/p&gt;&lt;p&gt;Their lawyer, Mark Stewart QC, said they reserve the right to prosecute anyone found to carry personal responsibility for the crash.&lt;/p&gt;&lt;p&gt;The Crown Office ordered an investigation into the circumstances of the accident after ruling that there was no evidence to warrant criminal proceedings.&lt;/p&gt;&lt;p&gt;The inquiry, now in its fifth week, will hear from the remaining witnesses before the sheriff makes a decision on Ms Bain's request on Thursday.&lt;/p&gt;&lt;p&gt;Mr Clarke himself was expected to give evidence but this has been complicated by the prospect of a private prosecution.&lt;/p&gt;&lt;p&gt;His lawyer said he "wants to answer all the questions that are put to him at the inquiry" but added that his client was entitled to "privilege against self-incrimination".&lt;/p&gt;&lt;p&gt;Solicitor General Lesley Thomson QC, who is leading the inquiry, said that a private prosecution was a "rare and exceptional beast", and the development would need to be considered by the Crown.&lt;/p&gt;&lt;p&gt;The DVLA last week ruled out taking any action against Mr Clarke, who was a driver with First Bus before taking up a job with Glasgow City Council in 2011.&lt;/p&gt;&lt;p&gt;The inquiry has heard evidence that he blacked out at the wheel of a stationary bus in Glasgow in April 2010.&lt;/p&gt;&lt;p&gt;Doctors diagnosed Mr Clarke with vaso vagal syndrome, a condition that affects the heart rate and blood pressure.&lt;/p&gt;&lt;p&gt;Witnesses on the day of December's crash reported seeing the lorry driver slumped at the wheel as the vehicle mounted the pavement on Queen Street and careered up the road towards George Square where it crashed into the Millennium Hotel.&lt;/p&gt;&lt;/section&gt;&lt;/article&gt;</content>
    <pa:type>asset</pa:type>
  </entry>
  <entry ... 
</feed>

The package response is also returned as an atom feed, where every curated asset in the package is an atom entry. The atom feed title and id identifies the package, whilst the updated element is the last time the package was published by PA editorial with any changes (textual or media).

For convenience, the atom entry for each asset in the package is returned as a Full Asset Response (unlike the JSON) so that the entire package feed may be ingested and used without further API calls.

Each asset returned in a package is always the last published lead from the story of that asset. Therefore the asset id (entry/id) may change over time as new leads are written and published to replace the previous. However there will always be a consistent link to the story that the asset belongs to, in the <link rel="story" .../> element. The <pa:leadNumber> in each entry will inform which lead the asset is within it's story.

Schedule response

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

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:pa="http://rss.pressassociation.com/pa">
  <title>News Schedule</title>
  <id>http://news.api.press.net/v1.5/schedules/news</id>
  <author>
    <name>Press Association</name>
  </author>
  <link rel="self" href="http://news.api.press.net/v1.5/schedules/news" />
  <updated>2015-08-17T10:55:50.196Z</updated>
  <opensearch:totalResults>21</opensearch:totalResults>
  <opensearch:startIndex>1</opensearch:startIndex>
  <opensearch:itemsPerPage>21</opensearch:itemsPerPage>
  <entry>
    <id>http://news.api.press.net/v1.5/assets/49788d50-b932-4235-97cb-08809fad47bb</id>
    <title>Family seeks private prosecution against Glasgow bin lorry crash driver</title>
    <dcterms:alternative>INQUIRY Lorry</dcterms:alternative>
    <pa:leadNumber>2</pa:leadNumber>
    <updated>2015-08-17T10:46:04.816Z</updated>
    <link rel="self" href="http://news.api.press.net/v1.5/assets/49788d50-b932-4235-97cb-08809fad47bb" />
    <link rel="story" href="http://news.api.press.net/v1.5/stories/6edfe35e-0c0f-490b-801f-9161ff986fc8" />
    <category term="pakeyword:lorry" label="Lorry" scheme="keyword" />
    <category term="tag:bin-lorry" label="Bin lorry" scheme="simple-tag" />
    <category term="tag:harry-clarke" label="Harry Clarke" scheme="simple-tag" />
    <category term="tag:driver" label="Driver" scheme="simple-tag" />
    <category term="tag:glasgow" label="Glasgow" scheme="simple-tag" />
    <category term="tag:jacqueline-morton" label="Jacqueline Morton" scheme="simple-tag" />
    <category term="tag:glasgow-sheriff-court" label="Glasgow Sheriff Court" scheme="simple-tag" />
    <category term="patopic:INQUIRY" label="Inquiry" scheme="wire-topic" />
    <category term="pacategory:HHH" label="Home News" scheme="category" />
    <category term="pacategory:SCN" label="Scottish News" scheme="category" />
    <summary>The family of a woman killed in the Glasgow bin lorry crash will seek to bring charges against the driver after prosecutors ruled out a case against him.</summary>
    <author>
      <name>By Lucy Christie and Paul Ward, Press Association Scotland</name>
    </author>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/8ad6efa8758d4de8a02553c52fdb2b1a/2.23748721.jpg" width="511" height="312" />
    <media:content url="https://news.static.press.net/v2/image/production/b395a0e5781240fe30b4331129850209/2.23748721.jpg" type="image/jpeg" width="4000" height="2440" fileSize="1850504">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/f5a6371397ebcd523e55d105e446ba54/2.23748721.jpg" width="127" height="78" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/8ad6efa8758d4de8a02553c52fdb2b1a/2.23748721.jpg" width="511" height="312" />
      <media:title>Bin lorry crash</media:title>
      <media:description>The scene in Glasgow's George Square after the bin lorry killed six people</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <pa:edNote>Stills and video planned. Copy by Lucy Christie (@LucyChristiePA).</pa:edNote>
    <content type="html">&lt;article&gt;&lt;section data-page-number="1" data-page-modified="2015-08-17T10:46:04Z"&gt;&lt;p&gt;The family of a woman killed in the Glasgow bin lorry crash will seek to bring charges against the driver after prosecutors ruled out a case against him.&lt;/p&gt;&lt;p&gt;Lawyers acting for Jacqueline Morton, 51, have requested that an inquiry under way into the December 22 tragedy be halted as they attempt to bring a private prosecution against Harry Clarke, 58.&lt;/p&gt;&lt;p&gt;Mr Clarke was behind the wheel of the council refuse truck that veered out of control on a busy shopping street, killing Ms Morton, from Glasgow, and five others.&lt;/p&gt;&lt;p&gt;A fatal accident inquiry at Glasgow Sheriff Court has heard evidence that Mr Clarke had a history of dizzy spells and fainting which he failed to disclose to the DVLA and on job application forms.&lt;/p&gt;&lt;p&gt;Dorothy Bain QC, told Sheriff John Beckett she had been instructed to seek an adjournment of the inquiry in order to seek authority to bring a private prosecution.&lt;/p&gt;&lt;p&gt;Funding has still to be secured and it may take up to three months to establish whether they can proceed, she said.&lt;/p&gt;&lt;p&gt;A lawyer for the family of victim Gillian Ewing, 52, from Edinburgh, said they supported the motion for adjournment but relatives of 29-year-old Stephenie Tait, from Glasgow, said they would not be involved in any private prosecution.&lt;/p&gt;&lt;p&gt;Ronald Conway, solicitor for the Taits, said public interest would best be served by continuing with the inquiry, which is looking at Mr Clarke's medical history, the bin lorry and the route it took three days before Christmas.&lt;/p&gt;&lt;p&gt;He said: "Telling lies is not a crime; telling lies to the medical profession is not a crime."&lt;/p&gt;&lt;p&gt;Erin McQuade, 18, and her grandparents Jack Sweeney, 68, and Lorraine Sweeney, 69, from Dumbarton, also died in the tragedy.&lt;/p&gt;&lt;p&gt;Their lawyer, Mark Stewart QC, said they reserve the right to prosecute anyone found to carry personal responsibility for the crash.&lt;/p&gt;&lt;p&gt;The Crown Office ordered an investigation into the circumstances of the accident after ruling that there was no evidence to warrant criminal proceedings.&lt;/p&gt;&lt;p&gt;The inquiry, now in its fifth week, will hear from the remaining witnesses before the sheriff makes a decision on Ms Bain's request on Thursday.&lt;/p&gt;&lt;p&gt;Mr Clarke himself was expected to give evidence but this has been complicated by the prospect of a private prosecution.&lt;/p&gt;&lt;p&gt;His lawyer said he "wants to answer all the questions that are put to him at the inquiry" but added that his client was entitled to "privilege against self-incrimination".&lt;/p&gt;&lt;p&gt;Solicitor General Lesley Thomson QC, who is leading the inquiry, said that a private prosecution was a "rare and exceptional beast", and the development would need to be considered by the Crown.&lt;/p&gt;&lt;p&gt;The DVLA last week ruled out taking any action against Mr Clarke, who was a driver with First Bus before taking up a job with Glasgow City Council in 2011.&lt;/p&gt;&lt;p&gt;The inquiry has heard evidence that he blacked out at the wheel of a stationary bus in Glasgow in April 2010.&lt;/p&gt;&lt;p&gt;Doctors diagnosed Mr Clarke with vaso vagal syndrome, a condition that affects the heart rate and blood pressure.&lt;/p&gt;&lt;p&gt;Witnesses on the day of December's crash reported seeing the lorry driver slumped at the wheel as the vehicle mounted the pavement on Queen Street and careered up the road towards George Square where it crashed into the Millennium Hotel.&lt;/p&gt;&lt;/section&gt;&lt;/article&gt;</content>
    <pa:type>asset</pa:type>
  </entry>
  <entry ... 
</feed>

The schedule response is similar to the packages response, in that it is returned as an atom feed with an atom entry for the last published lead of each asset. The feed id and title identifies the schedule, whilst the updated element is the last publish time of the schedule.

For convenience, the atom entry for each asset in the schedule is returned as a Full Asset Response (unlike the JSON) so that the entire schedule feed may be ingested and used without further API calls.

The totalResults and itemsPerPage values will, by default, be equal to the number of items in the schedule - which are all returned. The offset and limit parameters may be passed to modify this behaviour to return less items.

Summary Asset Response

This short-form representation of an asset is used in all ATOM search responses.

  <entry>
    <id>http://news.api.press.net/v1.5/assets/eb498922-1b1d-40f8-8cc1-ca3b751a41aa</id>
    <title>Leona Lewis shines at film premiere</title>
    <dcterms:alternative>SHOWBIZ Sunshine</dcterms:alternative>
    <pa:leadNumber>1</pa:leadNumber>
    <updated>2014-06-11T19:18:00.015Z</updated>
    <link rel="alternate" href="http://news.api.press.net/v1.5/assets/eb498922-1b1d-40f8-8cc1-ca3b751a41aa" />
    <link rel="story" href="http://news.api.press.net/v1.5/stories/387e7242-6cee-496c-8350-117689c52990" />
    <category term="pakeyword:sunshine" label="Sunshine" scheme="keyword" />
    <category term="patopic:SHOWBIZ" label="Showbiz" scheme="wire-topic" />
    <category term="pacategory:HHH" label="Home News" scheme="category" />
    <summary>Leona Lewis was Walking On Sunshine tonight at the premiere of her debut film.</summary>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/a0d0908b83d7c4f0c4eb9efdbdd60c63/2.20081663.jpg" width="307" height="512" />
    <media:content url="https://news.static.press.net/v2/image/production/6bbd29dd8ee872ef2ff5a5b8f6aa699c/2.20081663.jpg" type="image/jpeg" width="2099" height="3500" fileSize="990303">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/40f4057072ec345e260391510a0fb15e/2.20081663.jpg" width="76" height="127" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/a0d0908b83d7c4f0c4eb9efdbdd60c63/2.20081663.jpg" width="307" height="512" />
      <media:title>Walking On Sunshine premiere - London</media:title>
      <media:description>Leona Lewis attending the Walking On Sunshine premiere at Vue West End, Leicester Square, London.</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <pa:type>asset</pa:type>
  </entry>

The keys presented in the summary response are similar to those in the Full Asset Response (see below), excluding content and providing only the first picture as media:content.

Full Asset Response

The full asset response is used in package and schedule responses, and when a specific asset is retrieved by ID from the /v1/assets/{asset_id} endpoint.

  <entry>
    <id>http://news.api.press.net/v1.5/assets/7e1f59bd-635f-4e25-97ca-408a4edf6395</id>
    <title>Breakdown of regional unemployment figures</title>
    <dcterms:alternative>INDUSTRY Unemployment Regions</dcterms:alternative>
    <pa:leadNumber>0</pa:leadNumber>
    <updated>2015-08-12T08:55:31.432Z</updated>
    <link rel="self" href="http://news.api.press.net/v1.5/assets/7e1f59bd-635f-4e25-97ca-408a4edf6395" />
    <link rel="story" href="http://news.api.press.net/v1.5/stories/38e87898-fbda-41fc-aa04-4365c9258070" />
    <link rel="related" href="http://news.api.press.net/v1.5/stories/d529f6d3-bd18-4372-984d-0b9a0d31ee06" />
    <category term="pakeyword:unemployment" label="Unemployment" scheme="keyword" />
    <category term="pakeyword:regions" label="Regions" scheme="keyword" />
    <category term="tag:unemployment-rate" label="unemployment rate" scheme="simple-tag" />
    <category term="tag:regions-of-england" label="Regions of England" scheme="simple-tag" />
    <category term="tag:wales" label="Wales" scheme="simple-tag" />
    <category term="tag:scotland" label="Scotland" scheme="simple-tag" />
    <category term="tag:northern-ireland" label="Northern Ireland" scheme="simple-tag" />
    <category term="tag:unemployment" label="Unemployment" scheme="simple-tag" />
    <category term="patopic:INDUSTRY" label="Industry" scheme="wire-topic" />
    <category term="patopic:POLITICS" label="Politics" scheme="wire-topic" />
    <category term="pacategory:HHH" label="Home News" scheme="category" />
    <category term="pacategory:SCN" label="Scottish News" scheme="category" />
    <category term="pacategory:PPW" label="Welsh Parliament" scheme="category" />
    <category term="pacategory:PPI" label="Irish Parliament" scheme="category" />
    <summary>Figures showing regional unemployment between April and June (region, total unemployed, change on quarter and unemployment rate)</summary>
    <author>
      <name>By Alan Jones, Press Association Industrial Correspondent</name>
    </author>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/8db1b5a848c824749459c219a9fdf436/2.23320122.jpg" width="511" height="325" />
    <media:content url="https://news.static.press.net/v2/image/production/501ceac342642bcc25982224f616c98b/2.23320122.jpg" type="image/jpeg" width="2813" height="1790" fileSize="492197">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/f0d427b5a1cc2c2a911ad95592c463ff/2.23320122.jpg" width="127" height="81" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/8db1b5a848c824749459c219a9fdf436/2.23320122.jpg" width="511" height="325" />
      <media:title>Jobless figure expected to fall</media:title>
      <media:description>Some regions fare better than others in the new unemployment figures</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <content type="html">&lt;article&gt;&lt;section data-page-number="1" data-page-modified="2015-08-12T08:55:31Z"&gt;&lt;p&gt;Figures showing regional unemployment between April and June (region, total unemployed, change on quarter and unemployment rate)&lt;/p&gt;&lt;p&gt;North East 103,000 plus 7,000 8.1%&lt;/p&gt;&lt;p&gt;North West 213,000 plus 11,000 6.0%&lt;/p&gt;&lt;p&gt;Yorkshire and The Humber 174,000 minus 3,000 6.5%&lt;/p&gt;&lt;p&gt;East Midlands 112,000 minus 3,000 4.7%&lt;/p&gt;&lt;p&gt;West Midlands 167,000 minus 12,000 6.0%&lt;/p&gt;&lt;p&gt;East of England 146,000 plus 9,000 4.7%&lt;/p&gt;&lt;p&gt;London 307,000 plus 22,000 6.7%&lt;/p&gt;&lt;p&gt;South East 207,000 plus 11,000 4.5%&lt;/p&gt;&lt;p&gt;South West 124,000 plus 5,000 4.4%&lt;/p&gt;&lt;p&gt;Wales 90,000 minus 9,000 5.9%&lt;/p&gt;&lt;p&gt;Scotland 155,000 minus 13,000 5.6%&lt;/p&gt;&lt;p&gt;Northern Ireland 56,000 plus 1,000 6.5%&lt;/p&gt;&lt;/section&gt;&lt;/article&gt;</content>
    <pa:type>asset</pa:type>
  </entry>

The elements have the following usage:

KeyRequired?Usage
id mandatory The unique identifier for the asset
title mandatory The headline of the story
dcterms:alternative mandatory A PA moniker for the story, intended for editorial use but not for display to consumers
pa:leadNumber optional The sequence number of this asset in the leads for the story, from 0
link rel="story" optional A link to the overall story that this asset is part of, through which the shared media, sidebars etc may be discovered
link rel="related" mandatory If a child 'sidebar' asset, a link to the parent story
updated 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 i.e. tags. Each category has a term, which can be used in a?tag={tag_id} search query, and a label which is intended for display use for that tag. The scheme value is used to disambiguate different category domains, such as keyword
summary 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.thumbnail optional The media thumbnail at the entry root level is always the preview of the first image for the asset, for convenience
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. Crops information may also appear within this element.
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 mandatory The body content of the story, encoded as an HTML5 article

pa:type mandatory The type of asset, such as "asset", "snap", "advisory". Sidebars are still assets, but have the "related" link to a parent story

Story response

The story response is returned when accessing the /stories/{story_id} endpoint. Story ids are revealed in the story section of assets. For example:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:pa="http://rss.pressassociation.com/pa">
  <title>Story 479dc90c-63c5-4076-9fc3-7b1d4e1f2c6a</title>
  <id>http://news.api.press.net/v1.5/stories/479dc90c-63c5-4076-9fc3-7b1d4e1f2c6a</id>
  <author>
    <name>Press Association</name>
  </author>
  <link rel="self" href="http://news.api.press.net/v1.5/stories/479dc90c-63c5-4076-9fc3-7b1d4e1f2c6a" />
  <updated>2015-08-17T12:53:20.270Z</updated>
  <entry>
    <id>http://news.api.press.net/v1.5/stories/479dc90c-63c5-4076-9fc3-7b1d4e1f2c6a</id>
    <title>INDUSTRY Strike</title>
    <updated>2014-07-10T21:03:29.112Z</updated>
    <link rel="self" href="http://news.api.press.net/v1.5/stories/479dc90c-63c5-4076-9fc3-7b1d4e1f2c6a" />
    <link rel="latest-lead" href="http://news.api.press.net/v1.5/assets/f2f857e8-1ce4-4997-86ca-10a4382dd00d" />
    <author>
      <name>Press Association</name>
    </author>
    <content type="html">&lt;article&gt;Story 479dc90c-63c5-4076-9fc3-7b1d4e1f2c6a&lt;/article&gt;</content>
    <pa:type>story</pa:type>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/2656b3c8b05f809a223a82caa9e047c3/2.20360036.jpg" width="511" height="340" />
    <media:content url="https://news.static.press.net/v2/image/production/318b0438136563e83e2200ee67e6c11b/2.20360036.jpg" type="image/jpeg" width="4252" height="2830" fileSize="2210113">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/97c79ce5a33be45d48bfadbb428e11b6/2.20360036.jpg" width="127" height="84" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/2656b3c8b05f809a223a82caa9e047c3/2.20360036.jpg" width="511" height="340" />
      <media:title>Public sector strike</media:title>
      <media:description>Public sector workers marched through Newcastle city centre as part of the one-day walkout</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <pa:videoRef>urn:newsml:pressassociation.com:20140710:Ikes1405015717096I</pa:videoRef>
  </entry>
</feed>

The story response is an atom feed where the single atom entry is the summary of the last published asset lead of the story. Via this entry the story media is exposed. Note the <link rel="latest-lead" .../> element, which links to the asset id of the latest lead.

Gallery response

The gallery response is returned by the /galleries/{gallery_id} endpoint and is a specialised media asset containing a set of curated pictures on a theme. The response looks like:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:pa="http://rss.pressassociation.com/pa">
  <link rel="self" href="http://news.api.press.net/v1.5/galleries/week-in-photos" />
  <title>Gallery week-in-photos</title>
  <updated>2015-08-14T06:09:28.266Z</updated>
  <id>http://news.api.press.net/v1.5/galleries/week-in-photos</id>
  <author>
    <name>Press Association</name>
  </author>
  <entry>
    <id>http://news.api.press.net/v1.5/galleries/week-in-photos</id>
    <title>August 8 week - in pictures</title>
    <dcterms:alternative>Week In Photos</dcterms:alternative>
    <updated>2015-08-14T06:09:28.266Z</updated>
    <link rel="self" href="http://news.api.press.net/v1.5/galleries/week-in-photos" />
    <author>
      <name>Press Association</name>
    </author>
    <media:thumbnail url="https://news.static.press.net/v2/image/preview/53b9300636385bd3fcb6baa7eba6cd3e/2.23803280.jpg" width="511" height="340" />
    <media:content url="https://news.static.press.net/v2/image/production/96fc5a4eec92314d5e3460ebec5ca386/2.23803280.jpg" type="image/jpeg" width="3500" height="2330" fileSize="1057066">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/827dd2517003eb39e74b5d81b3fe2aaa/2.23803280.jpg" width="127" height="84" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/53b9300636385bd3fcb6baa7eba6cd3e/2.23803280.jpg" width="511" height="340" />
      <media:title>Perseid meteor shower</media:title>
      <media:description>A shooting star seen through thin cloud in the skies over the Bathing House at Howick in Northumberland as the annual Perseids meteor shower peaked, delighting viewers in the Midlands and the North. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/a08d18eaa694ed7f24c7c5857fc264c9/2.23788426.jpg" type="image/jpeg" width="4812" height="3330" fileSize="2075149">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/db930b4ef25e8571c9855ee9f0ca84d2/2.23788426.jpg" width="127" height="88" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/3278c1aaceee4111acf08776716a8b05/2.23788426.jpg" width="512" height="354" />
      <media:title>Conley Thompson funeral</media:title>
      <media:description>The coffin of seven-year-old Conley Thompson arrives at St Thomas and St James Church in Worsbrough Dale for his superhero-themed funeral. Conley died after falling into a pipe on a building site. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/076939a1803d666d0bfb2cb4697286bf/2.23787727.jpg" type="image/jpeg" width="4782" height="2934" fileSize="2733036">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/d1b604f75976c5c928735bd767fc1db1/2.23787727.jpg" width="127" height="78" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/e3d976b629a5837b9736c9a39ff0a894/2.23787727.jpg" width="512" height="314" />
      <media:title>Baby undulate rays</media:title>
      <media:description>Two endangered 10cm baby undulate rays which were born last month at the Sea Life London Aquarium. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/a4a43acfaa17949cc29f0e057137d9a9/2.23799914.jpg" type="image/jpeg" width="5040" height="2988" fileSize="2391220">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/9bcd1566c5c50bd72b51b608dc7c0956/2.23799914.jpg" width="127" height="75" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/5d852e8794ab6369aee74240be4df4a6/2.23799914.jpg" width="511" height="303" />
      <media:title>Don Lock funeral</media:title>
      <media:description>Cyclists perform a guard of honour with their bike wheels as the coffin of great-grandfather Don Lock arrives at Worthing Crematorium. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/a66bb8065e6ae773c52e7e081133c672/2.23795365.jpg" type="image/jpeg" width="3200" height="2415" fileSize="5231964">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/9c87d225cb0521b4c71fc382d4236a91/2.23795365.jpg" width="127" height="96" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/bbceab321f44dde9903b61e898229e25/2.23795365.jpg" width="511" height="386" />
      <media:title>Tiger training at Blair Drummond Safari Park</media:title>
      <media:description>Blair Drummond Safari Park keeper Sandra Rainey goes through a training exercise with Bela, a 13-year-old Amur tiger. A tennis ball on the end of a stick is used by trainers to carry out health checks with a positive reward of food. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/e71b35e437a62f7122482801b82a2134/2.23804717.jpg" type="image/jpeg" width="3500" height="2554" fileSize="1455556">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/fc849e8ca291b20ed5520d89a893c38e/2.23804717.jpg" width="128" height="93" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/97dec1312162881a333a9debd05791c3/2.23804717.jpg" width="511" height="373" />
      <media:title>A-level results</media:title>
      <media:description>Students, from left, Megan Armishaw, Kathryn Bullman, Ellie Stockwell, Georgina Ginnaw and Jasmine Bawa celebrate after receiving their A-level results at Chelmsford County High School for Girls. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/0f5abb42769d9742fbe6c85c9f1b09a0/2.23798094.jpg" type="image/jpeg" width="3500" height="2334" fileSize="845744">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/1515deb8c28b7005239f2802c669b8d2/2.23798094.jpg" width="127" height="85" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/65121baada828579896cfc12ba0bdb21/2.23798094.jpg" width="511" height="341" />
      <media:title>Parrot and dog become friends</media:title>
      <media:description>Cracker, an African Grey parrot, sits on the back of Dudley, a Staffordshire Bull Terrier, outside their home in New Parks, Leicester. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/4cc4c6d8eb3a8ce01a2141fa07b2382c/2.23807002.jpg" type="image/jpeg" width="3500" height="2355" fileSize="1083490">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/78438a338e417d48cb4e11746b9e933f/2.23807002.jpg" width="128" height="86" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/bc871f892fa29377614830326ecffe87/2.23807002.jpg" width="511" height="344" />
      <media:title>Summer weather Aug 13th 2015</media:title>
      <media:description>A man's umbrella is blown inside out as he take a photo with his mobile phone in Westminster, central London, as torrential downpours and thunderstorms swept in from the South.</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/3b1e2c440b5160b1a4b97b1dcb046c71/2.23772566.jpg" type="image/jpeg" width="4254" height="2929" fileSize="1990838">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/53c7ffea8f62419cfe1de64c6c384f11/2.23772566.jpg" width="128" height="88" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/de75bf75b64aebaacefccfe69316e291/2.23772566.jpg" width="511" height="352" />
      <media:title>Moffat Sheep Races 2015</media:title>
      <media:description>Sheep with knitted woollen jockeys on their backs race down Moffat High Street in Dumfriesshire, followed by seven-year-old Callum Horn, during the annual Moffat Sheep Races. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <media:content url="https://news.static.press.net/v2/image/production/8ef20507bae5317bc05cdd7cd58ff532/2.23799352.jpg" type="image/jpeg" width="4000" height="2370" fileSize="2746511">
      <media:thumbnail url="https://news.static.press.net/v2/image/thumbnail/5a6645637f3d37654d38ebeb217861ed/2.23799352.jpg" width="127" height="75" />
      <media:thumbnail url="https://news.static.press.net/v2/image/preview/0aea362948fba3988c41280b356eef3e/2.23799352.jpg" width="511" height="303" />
      <media:title>Gung-Ho! event</media:title>
      <media:description>Europe's largest inflatable slide is unveiled at Liverpool Cricket club, and will be part of three Gung-Ho! events to raise money for local charities. (PA)</media:description>
      <media:credit>PA WIRE</media:credit>
    </media:content>
    <content type="html">&lt;article&gt;Gallery week-in-photos&lt;/article&gt;</content>
    <pa:type>gallery</pa:type>
  </entry>
</feed>

The gallery response is an atom feed with a single entry for the gallery. The feed id and title identifies the gallery, as does the id of the entry. The entry title may be updated to reflect the theme or date of the gallery. The feed and entry updated time is the publish time of the gallery.

The media:content material in the entry carries the gallery images, same as for an asset. The pa:type will always be "gallery".

Docs Navigation