Content File Formats and Renditions¶
It is recommended that you download files in the format that is best suited to your needs rather than all available formats.
About Content Item Renditions¶
For each media type (text, picture, graphic, video and audio), content may be available in a variety of renditions:
- Media Renditions (renditions of non-textual content) are alternative versions of the same content item based on the format, size and/or other content characteristics, such as video frame rate and aspect ratio. For example, media renditions of a picture or graphic are the high-resolution, preview and thumbnail sizes of an image.
- Text Renditions (renditions of textual content) are different formats of the same text content item (for example, NITF and ANPA version of a story) and textual descriptions of the media (for example, an image caption or a video script).
All renditions may not be available for certain entitlements or content items. Learn more >>
Content Item Formats and Renditions¶
|Media Type||Text Renditions
(renditions of textual content)
(renditions of non-textual content)
|Text||NITF and ANPA versions of the story.||-|
|Picture||Caption (NITF). A freeform textual description of the image.||Main (JPG). High-resolution version of the image. For royalty-free images, the largest image size available is returned.
Preview (JPG). A low-resolution version of the image, if available.
Thumbnail (JPG). A small version of the image, if available.
|Graphic||Caption (NITF). A freeform textual description of the image.||Main (JPG, PNG, AI, PDF). Source graphic in one or more formats.
Preview (JPG). A low-resolution version of the graphic.
Thumbnail (JPG). A small version of the image.
|Video||Caption (NITF). A brief textual description of the video.
Script (NITF). The storyline: a chronological description of scenes, shots, action and dialog in a video clip, which may contain important special restrictions on the use of the video content item.
Shotlist (NITF). A list of shots included in a video clip, which summarizes the visual content of each shot, and may contain important special restrictions on the use of the video content item.
Note: The script and shotlist are typically delivered in the same rendition ("Script").
|Main (MPG and MP4). High-resolution version of the video clip in these formats, each at various quality levels.
Web-player preview (MPG). A low-resolution version of the video clip, if available.
Image preview (JPG). An enlarged version of the image that captures a specific frame of the video clip.
Thumbnail (JPG). A small version of the image that captures a specific frame of the video clip.
|Audio||-||Main (MP3 and MPG). Audio clip in these formats.|
Although the AP offers a wide variety of potential media renditions, their availability for any given entitlement or content item is not guaranteed.
- Using the agent? You can select the file types and formats to download on the Media API portal. Selecting certain renditions does not guarantee that you receive all of them; it only ensures that if the rendition is available, it is not filtered out. For example, you can select all video renditions, but the available video for a given entitlement or feed may include only MP4 files.
- Accessing the API directly? You can determine which formats are available by checking the
formatand additional characteristics (for example,
framerate) for the various renditions in the search or feed response. Learn more >>