---
title: Audio Extractor from Video Job API
slug: audio-extract-from-video
url: https://apyhub.com/apyhub/service/audio-extract-from-video
provider: ApyHub
categories: [Media Kit]
tags: [video-to-audio, mp4-to-mp3, audio-extraction, batch-jobs]
auth: api_key
version: 1.0
service_type: job
endpoints: 3
atoms: 5-400
mcp: true
alias: job-extract-video-audio
---

# Audio Extractor from Video Job API

Extract audio from large videos without waiting. Submit a video file or URL, check the job status & download the audio as MP3, WAV, AAC, or FLAC. Free tier.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/apyhub/audio-extract-from-video/url-to-json` | What it does Submits an async job to extract audio from a video at a source URL. It returns a job i… | 400 |
| POST | `https://api.eu.apyhub.com/apyhub/audio-extract-from-video/file-to-json` | What it does Submits a multipart video file for audio extraction and starts an asynchronous job. Th… | 400 |
| GET | `https://api.eu.apyhub.com/apyhub/audio-extract-from-video/jobs/:job_id` | What it does Checks the status of an audio extraction job submitted earlier and returns the current… | 5 |

## Endpoint reference

### Submit audio extraction job (source URL)

`POST https://api.eu.apyhub.com/apyhub/audio-extract-from-video/url-to-json` · 400 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `duration` | body | string | no | Clip length in seconds. Default 2 unless full_audio is true. |
| `video_url` | body | string (uri) | yes | Example: `https://assets.apyhub.com/samples/sample.mp4`. |
| `full_audio` | body | boolean | no | When true, extract from start_time to end of file. Default: `false`. |
| `start_time` | body | string | no | Seek offset in seconds (non-negative integer as string). Default 0. |
| `output_format` | body | string | no | One of: mp3, wav, aac, ogg, flac, wma, ac3. Default: `mp3`. |
| `persistent` | query | boolean | no |  |

#### Quickstart

Submit a video URL to start extracting audio and get back a job ID you can poll later.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/audio-extract-from-video/url-to-json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://assets.apyhub.com/samples/sample.mp4"
  }'
```

#### What you'll get back

Returns a JSON object with a `job_id` string field — the UUID of the submitted async job.

```json
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```

### Submit audio extraction job (multipart file)

`POST https://api.eu.apyhub.com/apyhub/audio-extract-from-video/file-to-json` · 400 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `video` | body | string (binary) | yes |  |
| `duration` | body | integer | no | Number of seconds to extract. Ignored when full_audio is true. Default: `2`. |
| `full_audio` | body | string | no | When true, extract the complete audio track. One of: true, false, 1, 0. Default: `false`. |
| `start_time` | body | integer | no | Seek offset in seconds. Default: `0`. |
| `output_format` | body | string | no | One of: mp3, wav, aac, ogg, flac, wma, ac3. Default: `mp3`. |
| `persistent` | query | boolean | no |  |

#### Quickstart

Upload a video file to start an async audio-extraction job and get back a job ID.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/audio-extract-from-video/file-to-json" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4"
```

#### What you'll get back

Returns a JSON object with a required `job_id` string field, which is the UUID you can use to poll job status later.

```json
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```

### Check audio extraction job status

`GET https://api.eu.apyhub.com/apyhub/audio-extract-from-video/jobs/:job_id` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `job_id` | path | string (uuid) | yes |  |

#### Quickstart

Check the status of an audio-extraction job by its job ID.

```bash
curl -X GET "https://api.eu.apyhub.com/apyhub/audio-extract-from-video/jobs/:job_id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object. The `data` object may include `job_id` (string), `status` (`pending`, `successful`, or `failed`), `message` (string), and `url` (string) when the job is successful.

```json
{
  "data": {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "successful",
    "url": "https://assets.apyhub.com/samples/sample.mp4"
  }
}
```

## About

## What it does
The Extract Audio from Video Job API pulls the audio track out of long or large videos as a background job. Submit a video file or URL, get a job ID right away, and check the job status until your audio is ready to download in MP3, WAV, AAC, OGG, FLAC, WMA, or AC3.

Use it when videos are too long to process within a single request, such as full recordings, webinars, and lectures, or when you're processing many videos in a queue and don't want your app to wait for each one.

For short videos you want to convert immediately, use the [Extract Audio from Video API](https://apyhub.com/apyhub/service/extract-audio-from-video), which returns the audio in the same request.

You can start on ApyHub's free tier with no card required.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/audio-extract-from-video
