Media API Version 2.2 Build 2.2.17 Release Notes

ON THIS PAGE          HideON THIS PAGE          Show Video Rendition DUIDs in NewsML-G2 New Optional Fields in JSON Item Metadata "derivedfrom" "refersto"

Video Rendition DUIDs in NewsML-G2

DUIDs are now available for video renditions not only in JSON, but also in NewsML-G2. A DUID is a descriptive tag that ties together the important rendition characteristics and allows you to differentiate between the renditions of the same type (for example, multiple Main, Preview or Thumbnail renditions).

Example: Video rendition DUID in NewsML-G2

<remoteContent residref="660c98e0794b4fc29b3030e844ce45bb" href="https://api.ap.org/download_link" rendition="rnd:highRes" size="75675947" contenttype="video/mpeg" format="frmt:MPEG" width="640" height="360" duration="59000" durationunit="timeunit:milliseconds" videoframerate="25" videoaspectratio="16:9" videoavgbitrate="1500000" videocodec="codec:h.264" videoscaling="sov:unscaled">

  <altId type="ap:originalFileName">US CA PALISADES FIRE AFTERMATH DRONE 20250116cr_x040n.mp4</altId>

  <altId type="ap:duid">vid-360p-main-60</altId>

  <signal type="ap:priceTag" literal="Unlimited"/>

</remoteContent>

New Optional Fields in JSON Item Metadata

When available, the following fields now appear in the JSON Item Metadata response or when the include=* parameter is specified in the request. 

"derivedfrom"

Indicates the GUIDs of one or more news items that were used as the source material for the current item. The current item and the source item(s) are essentially the same news item, but with a significant difference in a certain aspect, such as the language of the story body or the description of the image shown. Examples of use cases are translations and refiled photos.

{// JSON example:
"derivedfrom": [
    {"code": "e80b37bd3d7a487486f90360ebf0efdf" }]}

"refersto"

Indicates the GUIDs of one or more independent items that have a strong, lasting relationship to the current item, such as between a NewsAlert about an event and the full story about that same event. Another example is the relationship between the main story about a news event ("mainbar") and its "sidebars" that break out specific developments and follow-ups to that event.

{// JSON example:
"refersto": [
    {"code": "1f9f50d8d11e4a608a55d81b7b514471" }]}