Each Episode has various videos, in two access levels:
Trailers are short videos that show off parts of the episode. These videos are provided for most episodes.
Paid content videos are full scenes (and sub-clips that have been cut from them, for slower connections) for each episode. These come from a separate API request and are only available to API users who have linked a Pluginfeeds account to their API key.
All videos are in the MPEG format.
Trailers come in an array under the “trailers” key for every Episode. This array will have the various quality sub-arrays inside it.
Videos come only in the paid content request, in the “videos” key.
The “trailers” and “videos” keys are sub-divided by quality. All videos come in four different qualities:
Note: Not all qualities are available for all episodes. If an episode doesn’t have a certain quality of trailer or video, the array will still have that quality key, but the value will be null.
Even though there is always just 1 trailer video in each quality level for an episode, the quality arrays contain a “clip” entry with the URL to the trailer. This is to accommodate the XML DTD. However, it is true even for JSON requests.
The quality arrays for the “videos” key in the paid content request contain multiple video URLs. These are keyed by the sub-clip number (in JSON) or the word “clip” (in XML) for sub-clips, or “scene” for the full scene. The sub-clips contain the same video as the full scene, but are split to reduce load times on slower connections.
Note: URLs you receive for full videos are access-controlled and will expire. It’s important that you do not re-use these URLs. When you are going to provide them to a visitor on a web page, request them fresh from the PV API.