Event Linking FAQ
Events
Every content item that is published in the Create product contains an event id.
This is used to link together the different pictures, graphics, social & textual posts that are about the same thing.
Typically, an Event is defined by a Topic and a set of Keywords for a single date, however different products may assign dates in different ways, so it is best to use the event id without assuming any logic.
Story with an Event
The event data is only exposed by the JSON response format.
If you wish to use the event id to link different assets, please migrate to this response format.
Here is an example of story that has been assigned to an event id
curl \
-H "Accept: application/json" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item/002c1318-8ec5-4151-aacf-7b340969ec59?product=paproduct:create
{
"uri": "002c1318-8ec5-4151-aacf-7b340969ec59",
"type": "composite",
"profile": "story",
"version": "1",
"firstcreated": "2019-10-16T10:39:20Z",
"versioncreated": "2019-10-16T10:39:20Z",
"issued": "2019-10-16T10:39:20Z",
"urgency": 6,
"pubstatus": "usable",
"language": "en",
"byline": "By Jamie Harris, PA Science Technology Reporter",
"headline": "Nasa says new spacesuits for moonwalking will consign bunny hops to history",
"description_text": "The American space agency has been tasked with putting astronauts back on the moon by 2024.",
"description_html": "<p>The American space agency has been tasked with putting astronauts back on the moon by 2024.</p>",
"body_text": "Nasa has revealed new spacesuits as it moves closer in its bid to return to the moon by 2024.\n\nThe American space agency unveiled two prototypes, one white model designed for exploring outside of the spacecraft on spacewalks, and a second orange suit for high-risk activity on the inside, such as launch and returning to Earth.\n\nAmy Ross, a spacesuit engineer, said the new Exploration Extravehicular Mobility Unit (xEMU) for outside use has been made more flexible than before, making it easier for astronauts to move and bend.\n\nIt is so flexible that it allows users to put their arms overhead, something astronauts during the Apollo programme were not able to do.\n\n“Zippers are bad and cables are bad so we have no zippers or cables on this suit,” she explained at a demonstration held in Washington DC.\n\n“There will be fewer seams and new materials that keep the dust out.”\n\nIt also features new technology to better manage pressure and the gloves have been improved to allow greater dexterity.\n\n“You’ll remember, Neil Armstrong and Buzz Aldrin, they bunny hopped on the surface of the moon, well now we’re actually going to be able to walk on the surface of the moon, which is very different than our suits of the past,” said Nasa administrator Jim Bridenstine.\n\nThe Orion suit used for launch and entry is made from fire resistant material and features a lighter and stronger helmet, with improvements to reduce noise.\n\nNasa is aiming to put the the first woman and next man on the moon by 2024 and maintain a presence with an ISS-like gateway orbiting around it, in hopes of eventually moving further into space to Mars.\n\nKenneth Bowersox, acting associate administrator for human exploration, recently cast some doubt on the target date for the Artemis missions to the moon, saying he would not bet anything on it.\n\nFunding and technical challenges still need to come together in order to meet the White House-set deadline, the former space shuttle and space station commander told a congressional subcommittee last month.",
"body_html": "<p>Nasa has revealed new spacesuits as it moves closer in its bid to return to the moon by 2024.</p><p>The American space agency unveiled two prototypes, one white model designed for exploring outside of the spacecraft on spacewalks, and a second orange suit for high-risk activity on the inside, such as launch and returning to Earth.</p><p>Amy Ross, a spacesuit engineer, said the new Exploration Extravehicular Mobility Unit (xEMU) for outside use has been made more flexible than before, making it easier for astronauts to move and bend.</p><p>It is so flexible that it allows users to put their arms overhead, something astronauts during the Apollo programme were not able to do.</p><p>“Zippers are bad and cables are bad so we have no zippers or cables on this suit,” she explained at a demonstration held in Washington DC.</p><p>“There will be fewer seams and new materials that keep the dust out.”</p><p>It also features new technology to better manage pressure and the gloves have been improved to allow greater dexterity.</p><p>“You’ll remember, Neil Armstrong and Buzz Aldrin, they bunny hopped on the surface of the moon, well now we’re actually going to be able to walk on the surface of the moon, which is very different than our suits of the past,” said Nasa administrator Jim Bridenstine.</p><p>The Orion suit used for launch and entry is made from fire resistant material and features a lighter and stronger helmet, with improvements to reduce noise.</p><p>Nasa is aiming to put the the first woman and next man on the moon by 2024 and maintain a presence with an ISS-like gateway orbiting around it, in hopes of eventually moving further into space to Mars.</p><p>Kenneth Bowersox, acting associate administrator for human exploration, recently cast some doubt on the target date for the Artemis missions to the moon, saying he would not bet anything on it.</p><p>Funding and technical challenges still need to come together in order to meet the White House-set deadline, the former space shuttle and space station commander told a congressional subcommittee last month.</p>",
"subject": [
{
"code": "paservice:sci-tech",
"name": "Sci-Tech",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "paservice:sci-tech:science",
"name": "Science",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "patopic:science",
"name": "Science",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:nasa",
"name": "Nasa",
"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": "paselection:featured",
"name": "Featured",
"profile": "paselection",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "selectedAs"
},
{
"code": "tag:mars",
"name": "Mars",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:moon",
"name": "Moon",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:nasa",
"name": "Nasa",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:space",
"name": "Space",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "contributor:pa",
"name": "PA",
"profile": "contributor",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "contributedBy"
}
],
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "Science Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/002c1318-8ec5-4151-aacf-7b340969ec59"
}
]
}
The event id can be seen as an entry in the event array. Specifically this entry
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "Science Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
Querying for linked pictures using an event id
You can pass the event id (in this example paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a) to the event query parameter of the item endpoint.
The type parameter is available for use to drill down which content item you wish to retrieve. In this example we are using picture to find the photographs that are linked.
Putting this together gives us this request -
curl \
-H "Accept: application/json" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item?product=paproduct:create&event=paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a&type=picture
Which returns the following response -
{
"total": 5,
"limit": 20,
"offset": 0,
"item": [
{
"uri": "4385a1f3-f7d2-410c-988a-ee9b8decdf43",
"type": "picture",
"profile": "asset",
"version": "1",
"contentcreated": "2019-10-16T13:04:26Z",
"firstcreated": "2019-10-16T11:07:06Z",
"versioncreated": "2019-10-16T11:07:06Z",
"issued": "2019-10-16T11:07:06Z",
"urgency": 6,
"pubstatus": "usable",
"copyrightholder": "PA PICTURE DESK",
"copyrightnotice": "Press Association Images",
"usageterms": "PICTURE DESK USE ONLY. NO SALES",
"language": "en",
"byline": "NASA/Joel Kowsky",
"headline": "NASA Artemis program",
"description_text": "Undated handout photo issued by NASA of NASA Administrator Jim Bridenstine (left) and Amy Ross, a spacesuit engineer at NASAÕs Johnson Space Center (centre) with Kristine Davis, a spacesuit engineer at NASAÕs Johnson Space Center, wearing a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"body_text": "Undated handout photo issued by NASA of NASA Administrator Jim Bridenstine (left) and Amy Ross, a spacesuit engineer at NASAÕs Johnson Space Center (centre) with Kristine Davis, a spacesuit engineer at NASAÕs Johnson Space Center, wearing a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"subject": [
{
"code": "paservice:news",
"name": "News",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "patopic:science",
"name": "SCIENCE",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:nasa",
"name": "Nasa",
"profile": "pakeyword",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "paservice:sci-tech",
"name": "Sci-Tech",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "paservice:sci-tech:science",
"name": "Science",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
}
],
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "SCIENCE Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
"place": [
{
"code": "city:washington",
"name": "Washington",
"profile": "country",
"scheme": "http://images-repository/v1/place",
"rel": "mentions"
}
],
"renditions": {
"original": {
"href": "https://image.assets.pressassociation.io/v2/image/production/c4286520f75adfb20a12a9d3508089b5/2.47176663.jpg",
"mimetype": "image/jpeg",
"height": 3525,
"width": 5680,
"orientation": "landscape"
}
},
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/4385a1f3-f7d2-410c-988a-ee9b8decdf43"
}
]
},
{
"uri": "fc2696f9-3f18-4d43-96aa-cf868a06f649",
"type": "picture",
"profile": "asset",
"version": "1",
"contentcreated": "2019-10-16T12:05:41Z",
"firstcreated": "2019-10-16T11:07:03Z",
"versioncreated": "2019-10-16T11:07:03Z",
"issued": "2019-10-16T11:07:03Z",
"urgency": 6,
"pubstatus": "usable",
"copyrightholder": "PA PICTURE DESK",
"copyrightnotice": "Press Association Images",
"usageterms": "PICTURE DESK USE ONLY. NO SALES",
"language": "en",
"byline": "NASA/Joel Kowsky",
"headline": "NASA Artemis program",
"description_text": "Undated handout photo issued by NASA of NASA Administrator Jim Bridenstine (left) and Amy Ross, a spacesuit engineer at NASAÕs Johnson Space Center (centre) with Kristine Davis, a spacesuit engineer at NASAÕs Johnson Space Center, wearing a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"body_text": "Undated handout photo issued by NASA of NASA Administrator Jim Bridenstine (left) and Amy Ross, a spacesuit engineer at NASAÕs Johnson Space Center (centre) with Kristine Davis, a spacesuit engineer at NASAÕs Johnson Space Center, wearing a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"subject": [
{
"code": "paservice:news",
"name": "News",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "pakeyword:nasa",
"name": "Nasa",
"profile": "pakeyword",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "patopic:science",
"name": "SCIENCE",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "paservice:sci-tech",
"name": "Sci-Tech",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "paservice:sci-tech:science",
"name": "Science",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
}
],
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "SCIENCE Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
"place": [
{
"code": "city:washington",
"name": "Washington",
"profile": "country",
"scheme": "http://images-repository/v1/place",
"rel": "mentions"
}
],
"renditions": {
"original": {
"href": "https://image.assets.pressassociation.io/v2/image/production/054a8f5d61bedc2c57136156115d1d28/2.47176656.jpg",
"mimetype": "image/jpeg",
"height": 2947,
"width": 4578,
"orientation": "landscape"
}
},
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/fc2696f9-3f18-4d43-96aa-cf868a06f649"
}
]
},
{
"uri": "b6557270-3640-4528-be66-8dd28ea99b45",
"type": "picture",
"profile": "asset",
"version": "1",
"contentcreated": "2019-10-16T14:13:32Z",
"firstcreated": "2019-10-16T11:07:02Z",
"versioncreated": "2019-10-16T11:07:02Z",
"issued": "2019-10-16T11:07:02Z",
"urgency": 6,
"pubstatus": "usable",
"copyrightholder": "PA PICTURE DESK",
"copyrightnotice": "Press Association Images",
"usageterms": "PICTURE DESK USE ONLY. NO SALES",
"language": "en",
"byline": "NASA/Joel Kowsky",
"headline": "NASA Artemis program",
"description_text": "Undated handout photo issued by NASA of a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"body_text": "Undated handout photo issued by NASA of a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"subject": [
{
"code": "paservice:news",
"name": "News",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "patopic:science",
"name": "SCIENCE",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:nasa",
"name": "Nasa",
"profile": "pakeyword",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "paservice:sci-tech",
"name": "Sci-Tech",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "paservice:sci-tech:science",
"name": "Science",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
}
],
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "SCIENCE Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
"place": [
{
"code": "city:washington",
"name": "Washington",
"profile": "country",
"scheme": "http://images-repository/v1/place",
"rel": "mentions"
}
],
"renditions": {
"original": {
"href": "https://image.assets.pressassociation.io/v2/image/production/b97a6af3633854edbb82206193286641/2.47176657.jpg",
"mimetype": "image/jpeg",
"height": 3119,
"width": 1900,
"orientation": "portrait"
}
},
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/b6557270-3640-4528-be66-8dd28ea99b45"
}
]
},
{
"uri": "4b0b81b6-5341-4254-90ac-ae12d7674756",
"type": "picture",
"profile": "asset",
"version": "1",
"contentcreated": "2019-10-16T09:20:52Z",
"firstcreated": "2019-10-16T11:07:02Z",
"versioncreated": "2019-10-16T11:07:02Z",
"issued": "2019-10-16T11:07:02Z",
"urgency": 6,
"pubstatus": "usable",
"copyrightholder": "PA PICTURE DESK",
"copyrightnotice": "Press Association Images",
"usageterms": "PICTURE DESK USE ONLY. NO SALES",
"language": "en",
"byline": "NASA/Joel Kowsky",
"headline": "NASA Artemis program",
"description_text": "Undated handout photo issued by NASA of Dustin Gohmert, Orion Crew Survival Systems Project Manager at NASAÕs Johnson Space Center, wearing the Orion Crew Survival System (OCSS) suit, during a demonstration of the suit at NASA Headquarters in Washington.",
"body_text": "Undated handout photo issued by NASA of Dustin Gohmert, Orion Crew Survival Systems Project Manager at NASAÕs Johnson Space Center, wearing the Orion Crew Survival System (OCSS) suit, during a demonstration of the suit at NASA Headquarters in Washington.",
"subject": [
{
"code": "paservice:news",
"name": "News",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "patopic:science",
"name": "SCIENCE",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:nasa",
"name": "Nasa",
"profile": "pakeyword",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "paservice:sci-tech",
"name": "Sci-Tech",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "paservice:sci-tech:science",
"name": "Science",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
}
],
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "SCIENCE Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
"place": [
{
"code": "city:washington",
"name": "Washington",
"profile": "country",
"scheme": "http://images-repository/v1/place",
"rel": "mentions"
}
],
"renditions": {
"original": {
"href": "https://image.assets.pressassociation.io/v2/image/production/2fd4158ee4b9cbf62c8eafce699ed661/2.47176655.jpg",
"mimetype": "image/jpeg",
"height": 4894,
"width": 2688,
"orientation": "portrait"
}
},
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/4b0b81b6-5341-4254-90ac-ae12d7674756"
}
]
},
{
"uri": "afb77d4f-3186-4759-a4ba-a725cf2ab156",
"type": "picture",
"profile": "asset",
"version": "1",
"contentcreated": "2019-10-16T13:08:16Z",
"firstcreated": "2019-10-16T11:07:01Z",
"versioncreated": "2019-10-16T11:07:01Z",
"issued": "2019-10-16T11:07:01Z",
"urgency": 6,
"pubstatus": "usable",
"copyrightholder": "PA PICTURE DESK",
"copyrightnotice": "Press Association Images",
"usageterms": "PICTURE DESK USE ONLY. NO SALES",
"language": "en",
"byline": "NASA/Joel Kowsky",
"headline": "NASA Artemis program",
"description_text": "Undated handout photo issued by NASA of NASA Administrator Jim Bridenstine (centre left) and Amy Ross, a spacesuit engineer at NASAÕs Johnson Space Center (centre) with Kristine Davis, a spacesuit engineer at NASAÕs Johnson Space Center, wearing a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"body_text": "Undated handout photo issued by NASA of NASA Administrator Jim Bridenstine (centre left) and Amy Ross, a spacesuit engineer at NASAÕs Johnson Space Center (centre) with Kristine Davis, a spacesuit engineer at NASAÕs Johnson Space Center, wearing a ground prototype of NASAÕs new Exploration Extravehicular Mobility Unit (xEMU), during a demonstration of the suit at NASA Headquarters in Washington.",
"subject": [
{
"code": "paservice:news",
"name": "News",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "patopic:science",
"name": "SCIENCE",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:nasa",
"name": "Nasa",
"profile": "pakeyword",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "paservice:sci-tech",
"name": "Sci-Tech",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
},
{
"code": "paservice:sci-tech:science",
"name": "Science",
"profile": "paservice",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "partOf"
}
],
"event": [
{
"code": "paevent:02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a",
"name": "SCIENCE Nasa 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
}
],
"place": [
{
"code": "city:washington",
"name": "Washington",
"profile": "country",
"scheme": "http://images-repository/v1/place",
"rel": "mentions"
}
],
"renditions": {
"original": {
"href": "https://image.assets.pressassociation.io/v2/image/production/6668e7df772ce0ad83264fd51a777c48/2.47176651.jpg",
"mimetype": "image/jpeg",
"height": 3486,
"width": 5735,
"orientation": "landscape"
}
},
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/afb77d4f-3186-4759-a4ba-a725cf2ab156"
}
]
}
],
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item?apikey=tx2rkyadav6gf4pvxjns6ekr&product=paproduct%3Acreate&event=paevent%3A02bcb2d602828dde96ab0dcfa126067b99e4c46db374ba1e010bc4faf878813a.partOf&type=picture"
}
]
}
Sidebar events
Some stories are 'sidebars' of other stories. This means that they are related to the original story and often offer a different or more in depth view on certain aspects of the story.
This is reflected in the events array by having 2 events -
- the event for the story itself. This is denoted by a rel value of
partOf - the event for the parent story that this story is a sidebar of. This is denoted by a rel value of
relatedTo
Sidebar event example
This story has the metadata of
- Topic - Police
- Keyword 1 - Diplomat
- Keyword 2 - Reaction
It is a sidebar of a story with the metadata of
- Topic - Police
- Keyword 1 - Diplomat
curl \
-H "Accept: application/json" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item/2d95a7d5-c919-4113-810f-c0de38282a41?product=paproduct:create
{
"uri": "2d95a7d5-c919-4113-810f-c0de38282a41",
"type": "composite",
"profile": "story",
"version": "2",
"firstcreated": "2019-10-16T02:53:40Z",
"versioncreated": "2019-10-16T06:51:17Z",
"issued": "2019-10-16T06:51:17Z",
"urgency": 6,
"pubstatus": "usable",
"language": "en",
"byline": "By Josh Payne, PA, in Washington DC",
"headline": "Trump ‘very graceful’ in White House meeting, say Harry Dunn parents",
"description_note": "(updates throughout)",
"description_text": "But the teenager’s parents said they are no ‘further along’ in their quest for justice for their son.",
"description_html": "<p>But the teenager’s parents said they are no ‘further along’ in their quest for justice for their son.</p>",
"body_text": "The family of British teenager Harry Dunn have described Donald Trump as “very graceful” after meeting the US president at the White House.\n\nBut the teenager’s parents said they are no “further along” after being told that the US woman allegedly responsible for their son’s death would not return to the UK.\n\nAnne Sacoolas left the UK after the crash in Northamptonshire which killed the 19-year-old in August.\n\n Tim Dunn, Harry’s father, said: “I think the president was very graceful and spoke very well to us.\n\n“Obviously we’ve just met the president and we never thought we’d get this far, but I don’t know whether we’re any further along.”\n\nHarry’s mother, Charlotte Charles, said: “When he (President Trump) held my hand, I gripped it a lot tighter and I was honest with him and just said, as I said a while ago, ‘if it was your son you would be doing the same as us’.\n\n“He actually gripped my hand a little bit tighter and said, ‘Yes, I would be’. And that’s when he said he would try and look at this from a different angle.\n\n“He seemed to understand that our grief has been locked in for seven weeks now on a case that should have been very, very clear cut.”\n\nMr Dunn said: “He listened to Charlotte very well – she spoke excellently to him and he was very understanding.\n\n“I genuinely do think he will look to resolve this in a way that will help us.”\n\nAsked about how it felt to have taken their fight for justice all the way to the White House, Mrs Charles said: “We were very proud of (Harry), extremely proud of him, and we set out to make him – when he’s riding the skies up there – very proud of us and his twin brother, and he would have been a little bit blown away, I think.”\n\nMr Dunn said of turning down the chance to meet Mrs Sacoolas at the White House: “We weren’t ready to meet her, it would have been too rushed.\n\nBut he added that the meeting “didn’t feel like a stunt – they didn’t try and force it on to us”.\n\nMrs Charles added: “But I don’t think it would be appropriate to meet her without therapists or mediators in the room.”\n\nShe added she thought the attempt to get them to meet Mrs Sacoolas could be viewed as an effort to sweep the matter under the carpet.\n\n“I think by having (Mrs Sacoolas) there they were hoping that would be enough for us – seven weeks on, it’s not enough.\n\n“The frustrating part is we’ve been saying since starting out on this mission to get justice for our son that we would meet her and we are still more than willing to meet her, but we made it very clear that needs to be on our terms.\n\n“It needs to be on UK soil when she has faced our justice system.”",
"body_html": "<p>The family of British teenager Harry Dunn have described Donald Trump as “very graceful” after meeting the US president at the White House.</p><p>But the teenager’s parents said they are no “further along” after being told that the US woman allegedly responsible for their son’s death would not return to the UK.</p><p>Anne Sacoolas left the UK after the crash in Northamptonshire which killed the 19-year-old in August.</p><p> Tim Dunn, Harry’s father, said: “I think the president was very graceful and spoke very well to us.</p><p>“Obviously we’ve just met the president and we never thought we’d get this far, but I don’t know whether we’re any further along.”</p><p>Harry’s mother, Charlotte Charles, said: “When he (President Trump) held my hand, I gripped it a lot tighter and I was honest with him and just said, as I said a while ago, ‘if it was your son you would be doing the same as us’.</p><p>“He actually gripped my hand a little bit tighter and said, ‘Yes, I would be’. And that’s when he said he would try and look at this from a different angle.</p><p>“He seemed to understand that our grief has been locked in for seven weeks now on a case that should have been very, very clear cut.”</p><p>Mr Dunn said: “He listened to Charlotte very well – she spoke excellently to him and he was very understanding.</p><p>“I genuinely do think he will look to resolve this in a way that will help us.”</p><p>Asked about how it felt to have taken their fight for justice all the way to the White House, Mrs Charles said: “We were very proud of (Harry), extremely proud of him, and we set out to make him – when he’s riding the skies up there – very proud of us and his twin brother, and he would have been a little bit blown away, I think.”</p><p>Mr Dunn said of turning down the chance to meet Mrs Sacoolas at the White House: “We weren’t ready to meet her, it would have been too rushed.</p><p>But he added that the meeting “didn’t feel like a stunt – they didn’t try and force it on to us”.</p><p>Mrs Charles added: “But I don’t think it would be appropriate to meet her without therapists or mediators in the room.”</p><p>She added she thought the attempt to get them to meet Mrs Sacoolas could be viewed as an effort to sweep the matter under the carpet.</p><p>“I think by having (Mrs Sacoolas) there they were hoping that would be enough for us – seven weeks on, it’s not enough.</p><p>“The frustrating part is we’ve been saying since starting out on this mission to get justice for our son that we would meet her and we are still more than willing to meet her, but we made it very clear that needs to be on our terms.</p><p>“It needs to be on UK soil when she has faced our justice system.”</p>",
"subject": [
{
"code": "paservice:news",
"name": "News",
"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": "patopic:police",
"name": "Police",
"profile": "patopic",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:diplomat",
"name": "Diplomat",
"profile": "pakeyword",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "pakeyword:reaction",
"name": "Reaction",
"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": "paterritory:uk:england:east-midlands",
"name": "East Midlands",
"profile": "paterritory",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "intendedFor"
},
{
"code": "tag:anne-sacoolas",
"name": "Anne Sacoolas",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:charlotte-charles",
"name": "Charlotte Charles",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:dominc-raab",
"name": "Dominc Raab",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:donald-trump",
"name": "Donald Trump",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:harry-dunn",
"name": "Harry Dunn",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:mark-stephens",
"name": "Mark Stephens",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:northamptonshire",
"name": "Northamptonshire",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "tag:tim-dunn",
"name": "Tim Dunn",
"profile": "tag",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "about"
},
{
"code": "contributor:pa",
"name": "PA",
"profile": "contributor",
"scheme": "https://content.api.pressassociation.io/v1/subject",
"rel": "contributedBy"
}
],
"event": [
{
"code": "paevent:c310113fd5890c75673bf1033291dd98781a7bd7a28e137748aa88022c9c5a97",
"name": "Police Diplomat Reaction 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
},
{
"code": "paevent:7423571259ea82de7ac7846ac3ffb543a5bb00e1bb3cef1b5598ee993338cac5",
"name": "Police Diplomat 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "relatedTo"
}
],
"links": [
{
"rel": "self",
"href": "https://content.api.pressassociation.io/v1/item/2d95a7d5-c919-4113-810f-c0de38282a41"
}
]
}
The event array contains 2 entries.
The first entry is for this story.
The second entry is for the parent story.
"event": [
{
"code": "paevent:c310113fd5890c75673bf1033291dd98781a7bd7a28e137748aa88022c9c5a97",
"name": "Police Diplomat Reaction 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "partOf"
},
{
"code": "paevent:7423571259ea82de7ac7846ac3ffb543a5bb00e1bb3cef1b5598ee993338cac5",
"name": "Police Diplomat 16/10/2019",
"profile": "paevent",
"scheme": "https://content.api.pressassociation.io/v1/event",
"rel": "relatedTo"
}
],
Querying items linked to a sidebar
As in the example above, you can add the event parameter to the /item endpoint to other items linked to the same event.
However, in the case of stories that have sidebars, if you just use the event id you might pull in items that have the relatedTo relationship to this event id.
In order to resolve this, you can add .partOf onto the event id in order to limit the scope to only items with a partOf relationship to this event id.
curl \
-H "Accept: application/json" \
-H "apikey: <API KEY>" \
https://content.api.pressassociation.io/v1/item?product=paproduct:create&event=paevent:7423571259ea82de7ac7846ac3ffb543a5bb00e1bb3cef1b5598ee993338cac5.partOf&type=picture
Updated about 5 years ago