Linked Media
|
|
|
|
About Linked Media
Text story items may contain references to linked media (for example, pictures, graphics, audio and video linked to the story by an AP editorial staff member). Linked media files may be available in the same formats as media renditions shown in the right column of the Content Item Formats and Renditions table.
Linked media references are delivered as associations in the JSON text story item.
Story with Linked Media Example
Structure Example
For brevity, this example shows only one text story item with three linked pictures and one linked video (the complete structure is illustrated only for the first linked picture):
|
|
|
|
JSON text story items with references to linked media items are delivered in feeds and search results. To learn more, see Search and Feed. |
|
|
|
|
JSON Example
This JSON example shows a text story item with three linked pictures and a video in associations and a link to the NITF story download in renditions.
// Example:
"item": {
"uri": "https://api.ap.org/media/v/content/a849ac631b0849f19bd7550e182c845c",
"altids": {
"itemid": "a849ac631b0849f19bd7550e182c845c"...},
"version": 3,
"type": "text",
...
"headline": "Cleanup, power restoration begin after 3rd nor'easter",
...
"associations": {
"1": {
"uri": "https://api.ap.org/media/v/content/8569b66ad5754931bc44c692a8a325ed",
"altids": {
"itemid": "8569b66ad5754931bc44c692a8a325ed",
"etag": "8569b66ad5754931bc44c692a8a325ed_0a1aza3c0"},
"version": 0,
"type": "picture",
"headline": "Northeast Storm Massachusetts"},
"2": {
"uri": "https://api.ap.org/media/v/content/22bbe96a632f4d01af1f72c0ca6b47c4",
"altids": {
"itemid": "22bbe96a632f4d01af1f72c0ca6b47c4",
"etag": "22bbe96a632f4d01af1f72c0ca6b47c4_0a1aza3c0"},
"version": 1,
"type": "picture",
"headline": "Winter Weather Virginia"},
"3": {
"uri": "https://api.ap.org/media/v/content/dc7b00bb74844d00bc04c74f8e1f0b8b",
"altids": {
"itemid": "dc7b00bb74844d00bc04c74f8e1f0b8b",
"etag": "dc7b00bb74844d00bc04c74f8e1f0b8b_0a1aza3c0"},
"version": 0,
"type": "picture",
"headline": "Northeast Storm New Hampshire"},
"4": {
"uri": "https://api.ap.org/media/v/content/548ae9f9bd5d448091ee10ac5bd727fe",
"altids": {
"itemid": "548ae9f9bd5d448091ee10ac5bd727fe",
"etag": "548ae9f9bd5d448091ee10ac5bd727fe_0a16aza19c0"},
"version": 0,
"type": "video",
"headline": "Latest Nor'easter Hits New England"}},
"renditions": {
"nitf": {
"title": "NITF Story Download",
"rel": "Story",
...
"href": "https://api.ap.org/media/v/content/a849ac631b0849f19bd7550e182c845c/download?type=text&format=NITF"}}}