Change Log¶
This page lists all changes that have been made to the API since its first installment. The API will remain backward-compatible (with the exception of bug fixes).
v1.28 2013-04-10¶
- Added jwplayer_edition request parameter in the calls:
- Added //account/jwplayer_edition response parameter in the /accounts/show call.
- Added advertising_client and advertising_tag request parameters in the calls:
- Added //player/advertising/client and //player/advertising/tag response parameters in the /players/show call.
- Value of the version request parameter in /players/create call is now defaults to 6 instead of 5.
v1.27 2013-02-27¶
- Added version request parameter in the /players/update call.
v1.26 2012-12-19¶
- Added update_file request parameter in the /videos/captions/update call.
- Added updating status in the status response parameter in the calls:
- Added xml skin format in the format response parameter in the calls:
- Added xml skin format in the format request parameter in the calls:
- Added player_version request parameter in the /accounts/skins/list call.
- Added version request and response parameter in the calls:
- Removed skin_format response parameter in the /accounts/show call.
v1.25 2012-11-14¶
- Added download_url request parameter in the calls:
- Added strip_status response parameter in the /videos/thumbnails/show call.
- Added thumbnail_index request parameter in the /videos/thumbnails/update call.
- Added min_scale_width request parameter in the calls:
- Removed update-failed and updating-after-failed values of the status response parameter in the calls:
v1.24 2012-10-25¶
- Added related_videos request and response parameter in the calls:
- Renamed creating value of the status response parameter to processing in the calls:
- Added created status in the status response parameter in the /accounts/skins/show call.
v1.23 2012-09-19¶
v1.22 2012-08-28¶
- Added resumable file upload in the calls:
- Added created status in the status response parameter in the calls:
- Added created status in the statuses_filter request parameter in the /videos/list call.
v1.21 2012-05-02¶
- Added search request parameter that accepts list of fields (including custom fields) that specifies where search should be done. Parameter added to the following calls:
- Deprecated text, author request parameters in favour of search query parameter in the calls:
v1.20 2011-12-15¶
- New API calls:
- Added captions, ga_web_property_id and sharing_player_key request and response parameters in the calls:
- Changed sharing parameter options in the calls.
- Value of the repeat request parameter in /players/create call is now defaults to list instead of none.
- Removed hd_template_key request parameter in the calls:
- Removed //player/hd_template response parameter in the /players/show call.
- Maximum value of the result_limit request parameter is automatically forced to 1000 in all /*/list calls.
- Vorbis audio conversion is now uses Ogg container instead of WebM. Documentation for the following calls has been updated to reflect the change:
- It is now possible to update required conversion templates using /accounts/templates/update call. All parameters except default and upscale can be updated.
- Removed editable response parameter in the calls:
v1.19 2011-11-08¶
- Content Server will only return the first 100 entries in a manual or dynamic playlist when the playlist is embedded or published as an RSS feed. Total number of videos returned by the /channels/videos/list API call remains unlimited.
v1.18 2011-07-20¶
- Removed deprecated request parameter template_id from the documentation in the calls:
- Removed deprecated response parameter //templates/template/@id from the documentation in the /accounts/templates/list call.
- Removed deprecated response parameter //conversion/template/@id from the documentation in the calls:
- Added title-asc, title-desc, duration-asc, duration-desc, views-asc and views-desc options to the sort_order request parameter the /channels/update call.
- Added //video/custom, //video/md5, //video/mediatype and //video/views response parameters in the calls:
- Added //video/md5, //video/size response parameters in the calls:
- Added hd_template_key request parameter in the calls:
- Added //player/hd_template response parameter in the /players/show call.
v1.17 2011-07-07¶
- Added content_dns_mask and usage_type request parameters in the calls:
- Added //account/dns_masks/content response parameter in the /accounts/show call.
- Added //account/usage_type, //account/can_store, //account/can_stream and //account/content/size response parameters in the calls:
- Removed trial account state in the calls:
- Removed streaming account combination state from the states_filter request parameter in the /accounts/list call.
- Replaced blocked account state with pending state in the calls:
- Deprecated result_limit query parameter with value 0 in all /*/list calls. Only values between 1 and 1000 will be accepted starting from the next (1.18) API version.
v1.16 2011-04-20¶
- New API calls:
- Deprecated API calls:
- Added watermark_key, watermark_position and watermark_margin request parameters the calls:
- Added watermark_key, watermark_position, watermark_margin and watermark_clicklink request parameters the calls:
- Added //watermark response parameter in the calls:
- Added //players/player/ltas_channel response parameter in the /players/list call.
v1.15 2011-02-20¶
- Added mediatypes_filter request parameter in the /videos/list call.
- Added update_file request parameter in the /videos/update call.
- Replaced date_asc and date_desc values of the //channel/sort_order parameter in the /channels/show call with date-asc and date-desc values.
v1.14 2010-12-08¶
- Added cdn_protocol request parameter in the calls:
- Added cdn/protocol response parameter in the /accounts/show call.
v1.13 2010-11-11¶
- New API calls:
v1.12 2010-10-21¶
- New API calls:
- Deprecated parameters:
- redirect_query query parameter in upload URLs in favour of redirect_query.param query parameter.
v1.11 2010-09-22¶
- New API calls:
- Added format, status and error response parameters in the /accounts/skins/list call.
- Added custom.param request parameter in the calls:
- Added custom response parameter in the calls:
- Added statuses_filter request parameter in the /videos/views/list call.
- Added start_date and end_date response parameters in the /videos/list call.
- Added status response parameter in the calls:
- Added title response parameter in the /videos/views/show call.
- Added editable response parameter in the calls:
- Added author field to the list of fields to search within using text request parameter in the calls:
- Added key field to the list of fields to search within using search/text request parameter in the calls:
- Added mediatype response parameter in the calls:
- Extended format_key request parameter with webm, aac and vorbis options in the calls:
- Replaced True, False options of the default request parameter with video, audio, all and none options in the calls:
- Renamed request parameter update_image to update_file in the /accounts/templates/watermarks/update call.
- Value of videos_max response parameter in /channels/update call is now defaults to 10 instead of 20.
- Removed URL validation of the redirect_address request parameter in upload calls.
- Deprecated parameters:
- custom_flashvars request parameter in /players/create and /players/update calls in favour of custom.param request parameter.
- custom_flashvars response parameter in /players/show call in favour of custom response parameter.
v1.10 2010-07-05¶
- New API calls:
- Added statuses_filter request parameter in the /videos/list call.
- Added content_limit and traffic_limit request parameters in the /accounts/create call.
- Added allow_downloads and allow_embeds request parameters in the calls:
- Added playlistsize request parameter in the calls:
- Added playlistsize and views response parameters in the /players/show call.
- Changed /channels/videos/ calls to allow multiple videos with the same key in a manual channel:
- added position request parameter in the /channels/videos/show call.
- added position request parameter in the /channels/videos/delete call.
- replaced video_key and position request parameter in the /channels/videos/update call with position_from and position_to parameters.
v1.9 2010-06-07¶
- New API calls:
- Added link request parameter and link response parameter in the calls:
- Added account_password request parameter and secret response parameter in the /accounts/show call.
- Added types_filter request parameter in the /channels/list call.
- Added streams, downloads, pageviews and viewed response parameters in the calls:
- Added required response parameters in the calls:
v1.8 2010-05-06¶
New API calls:
Added template_key parameter in /videos/conversions/create call and marked template_id parameter as deprecated.
Added //format/@key and //format/name response parameters in /videos/conversions/list and /videos/conversions/show calls.
Added result_limit and result_offset parameters in the calls:
- /videos/list
- /videos/views/list
- /videos/conversions/list
- /channels/list
- /channels/views/list
- /channels/videos/list
- /players/list
- /players/views/list
- /accounts/list
- /accounts/templates/list
total_limit parameter is deprecated and removed from the documentation.
Added order_by parameter in the calls:
- /videos/list
- /videos/views/list
- /channels/list
- /channels/views/list
- /players/list
- /players/views/list
- /accounts/list
- /accounts/templates/list
sort_order parameter is deprecated and removed from the documentation. Default sort order has been changed to ascending.
Added //video/views response parameters in the calls:
Added //channel/views response parameters in the calls:
Added //players/player/views and //players/player/playlist response parameters in the /players/list call.
Removed //day/hits response parameters from the /accounts/traffic/list call.
v1.7 2010-04-19¶
- New API calls:
- Added //template/format/@key and //template/upscale response parameters in the calls:
- Added //account/conversions/templates/@key response parameter in the /accounts/show call.
- Removed //account/restrictions/embeds/sites/site from /accounts/show call as whitelisting has been phased out in favour of signed video download URLs and signed video player embed URLs.
v1.6 2010-03-29¶
- New channels and players views statistics API calls:
- Added include_empty_days parameter in the calls:
- Added login parameter in the call:
- Added types_filter parameter in /accounts/list call.
v1.5 2010-02-15¶
- Added include_empty_days parameter in the calls:
- Added CDN name and CDN type response parameters in /accounts/show call.
- Renamed parameter unverified to registered in the calls:
- Added account_login parameter in the calls:
v1.4 2009-12-14¶
- New API calls to manage templates watermarks:
v1.3 2009-11-12¶
- New API calls:
- Added option to list videos only by author field in /videos/list call.
- Renamed parameter grouped to group_days in /accounts/content/list and in /accounts/traffic/list calls.
- Added template_key parameter in /accounts/templates/list and /accounts/templates/show calls and marked template_id parameter as deprecated.
- Added duration, width, height and template name parameters in /videos/conversions/list and /videos/conversions/show calls.
- Added call back parameters for upload URL in the calls:
- Added information about tracking file upload progress in the calls:
v1.2 2009-10-15¶
- Added processing and failed thumbnail creation statuses in /videos/thumbnails/show and /channels/thumbnails/show calls.
- Removed width and height response parameters from /videos/thumbnails/show and /channels/thumbnails/show call.
- Now a string is returned instead of an integer for the following response parameters when API output format is PHP or JSON:
- call /accounts/list:
- //account/content/limit
- //account/content/used
- //account/traffic/limit
- //account/traffic/used
- call /accounts/show:
- //account/content/limit
- //account/content/used
- //account/traffic/limit
- //account/traffic/used
- call /accounts/content/list:
- //day/limit
- //account/conversions/used
- //account/originals/used
- call /accounts/traffic/list:
- //day/hits
- //day/limit
- //day/used
- call /videos/update:
- //video/size
- call /videos/conversions/list:
- //conversion/filesize
- call /videos/conversions/show:
- //conversion/filesize
- call /videos/thumbnails/update:
- /thumbnail/size
- call /channels/thumbnails/update:
- //thumbnail/size
- call /accounts/list:
v1.1 2009-09-10¶
- Added account state transition check in /accounts/delete call. Only accounts with the state unverified or suspended can be deleted.
- Switched to phpserialize 1.1.
- Added /accounts/content/list call.
- Added /accounts/traffic/list call.
- Added states_filter option in /accounts/list call.
- Added conversion download link in /videos/conversions/list and /videos/conversions/show calls.
- /videos/templates calls are moved to /accounts/templates
- Added /version call.