Drop your videos here to upload
Mid_arrow
conversion de video multiformato

Video Converter

Convert your videos online and play them on any device

Documentation and Help

Index » API Documentation

Note that all the requests must be made as an XML REST or HTTP request, using either GET or POST.
The return values are formatted based on the XML syntax.

Method:

web_services/request_conversion.xml

This method creates a new conversion, with all the required parameters: videos to convert (URLs), presets to use, sites for uploading and a possible callback URL. After creating and configurating the conversion, it runs the conversion script, notifying the user by email inmediately, aswell as when the conversion is finished.

Parameters:

  • api_user: the user name for accessing the API.
  • api_key: the password for accessing the API.
  • sources: array with the URLs of the source videos.
  • presets: array with the nicenames of the presets to use in the conversion.
  • uploads (optional): array with the services you want to upload the videos to. Each item of the array is a hash, with 3 possible keys: amazons3, youtube, ftp. The value of each item of the hash is, aswell, an array of elements, each one containing a hash with the option you must provide for the upload service.
  • callback (optional): an URL to make a callback when the video conversion has finished.

Return value:

The conversion object newly created.

PHP Example Code | Ruby on Rails Example Code

Method:

web_services/get_conversion_status.xml

This method retrieves the current status of a conversion, identified by its ID.

Parameters:

  • api_user: the user name for accessing the API.
  • api_key: the password for accessing the API.
  • conversion_id: the ID of the conversion.

Return value:

The conversion status. Possible values: queued, waiting_upload, inprocess, failed, finished.

PHP Example Code | Ruby on Rails Example Code

Method:

web_services/get_converted_files.xml

This method retrieves the converted and uploaded files for a conversion, identified by its ID.

Parameters:

  • api_user: the user name for accessing the API.
  • api_key: the password for accessing the API.
  • conversion_id: the ID of the conversion.

Return value:

All the converted videos (URLs), if they are already converted and uploaded.

PHP Example Code | Ruby on Rails Example Code