Extract audio - URL

POST {{video-api-server}}/extract-audio/url

The POST /extract-audio/url endpoint extracts audio from a video provided through a publicly accessible URL. The audio will be extracted in a MP3 format. This endpoint supports extracting audio from multiple video files at the same time.

Request Body

If batch processing multiple files, pass an array of objects. Every object should contain 1 url parameter. Each URL will be processed individually, and results will be returned in the result array.

  • url (string, required): The URL of the video from which audio will be extracted.

Response

The response for this request is a JSON object with the following properties:

  • status (string): The status of the extraction process. Possible values - success or error. In case of batch processing, if one or more files fail, a multi-status value will be returned. Each file's status will be listed in the result array, with successful and failed extractions separated accordingly.

  • version (number): The API version used for the extraction process

  • result (array): Contains objects representing individual extraction results. In most cases, it will contain a single object, but batch processing may result in multiple items.

    • uuid (string): The unique identifier for the extraction process, which can be used to track or reference the extraction job for status updates or debugging.
    • url (string): The URL of the original video.
    • extracted_audio (string): Contains the URL of the extracted audio file in MP3 format.
    • sha1 (string): Contains the SHA1 hash of the extracted audio file, which can be used to verify the integrity of the file.
    • progress (string): contains a URL where the current status of the extraction process can be checked, including the completion percentage.

Request Body

{"0"=>{"url"=>"http://sample.li/big_buck_bunny.mp4"}}

HEADERS

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

RESPONSES

status: OK

{"status":"ok","version":2.14,"result":[{"uuid":"2825ecb7-3807-42fd-8a39-795f6ee39a29","url":"http://sample.li/big_buck_bunny.mp4","extracted_audio":"https://fbmjmuoeb.filerobot.com/https://filerobot.s3.eu-west-3.amazonaws.com/fbmjmuoeb/extracted_audio/LvXUM_big_buck_bunny/big_buck_bunny_audio.mp3","sha1":"0181d7880acf0c443a57cd2510a5b81447fa577e","progress":"https://api.filerobot.com/fbmjmuoeb/v4/video-status/ZXUtb3YtNzA2LWdyYTIuZWxhc3RpYy11cGxvYWRlci5haXJzdG9yZS5zY2FsM2ZsM3guY29tOjg3MzI__2825ecb7-3807-42fd-8a39-795f6ee39a29"}]}