Skip to content

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 Feed Structure

Tips

  • Using the agent?
    • JSON text story items (such as 'Text Story Item' in the example above) are delivered in the JSON feed or JSON item metadata files, which your agent downloads when you select the JSON: Feed Files or JSON: Item Files option on the AP Media API portal.
    • Linked media item files ('Linked Picture Item 1', 'Linked Picture Item 2', 'Linked Picture Item 3' and 'Linked Video Item' files in the example above) are downloaded by the agent when you select the JSON: Associated Item Files option on the AP Media API portal.
  • Accessing the API directly? 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"}}}}