Convert - URL

POST {{video-api-server}}/convert/url?output_format=webm

This is a POST request to the Filerobot Video API, designed to convert videos that are publicly available through HTTP protocol.
Use the output_format query parameter to define the output video format (e.g., webm or mp4).

You can use this endpoint for:

  • Converting an avi file to mp4 for compatibility with mobile devices.

  • Resizing and cropping a video before uploading it to your website.

Request Params

KeyDatatypeRequiredDescription
output_formatstringRequired. Format of the output file
cropstringwidth,height,x,y
  • width, height: Size of the crop window

  • x, y: Top-left coordinates to align the crop window's top-left corner (optional, default = 0, 0) | | resize | string | | width,height

  • Target size of the converted video. If only one value is specified, it is interpreted as height and the aspect ratio is kept. | | rotate | number | | Degrees to rotate to:

  • Positive values rotate clockwise

  • Negative - counterclockwise |

Request Body

{"0"=>{"url"=>"https://www.pexels.com/download/video/2231485"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Filerobot-TokenstringFilerobot project identifier, aka token
Filerobot-KeystringFilerobot API key

RESPONSES

status: OK

{"status":"ok","version":2.11,"result":[{"uuid":"ce59dfa3-6818-4eaf-a4c0-78db56ffb0cb","url":"https://www.pexels.com/download/video/2231485","converted":"https://fbmjmuoeb.filerobot.com/https://filerobot.s3.eu-west-3.amazonaws.com/fbmjmuoeb/converted_videos/xwOBN_2231485/2231485_converted.webm","sha1":"298da7e2e2e6e01764d6aec9802608efce2b49e7","progress":"https://api.filerobot.com/fbmjmuoeb/v4/video-status/ZXUtb3YtNzA2LWdyYTIuZWxhc3RpYy11cGxvYWRlci5haXJzdG9yZS5zY2FsM2ZsM3guY29tOjg3MzI__ce59dfa3-6818-4eaf-a4c0-78db56ffb0cb"}]}