API Reference

Audio Download API

The Audio Download API allows you to extract and download audio tracks from videos or audio-only sources. This is an asynchronous API: you initiate a job and then poll for the result.

x-api-key:stringrequired

This parameter specifies the private key you'll need for Hunt access.

Endpoint: GET /api/v1/audio/download

query:stringrequired

URL to download audio from.

download_type:stringopt

Desired download type.

audio: Downloads only the audio (default option)

default:audio

audio_quality:stringopt

Desired audio quality.

best: Best available quality (default)
320kbps: High quality
256kbps: Standard quality
128kbps: Low quality

default:best

audio_format:stringopt

Desired output format for the audio.

mp3: MP3 format (default option)
m4a: MPEG-4 Audio format
wav: Waveform Audio File Format

Note: This is a format preference. While we will do our best to provide the requested format, due to technical limitations or conversion issues, the final output format may differ from the requested one.

default:mp3

max_duration:numberopt

Maximum duration of the downloaded content in seconds. If the audio is longer than this value, only the content up to this duration will be downloaded. Useful for limiting file sizes or extracting specific portions.

webhook_url:stringopt

URL of the webhook where results will be sent. When specified, the system will attempt to send the response to this URL up to 3 times with a 5-second delay between each attempt. The results will be sent as a POST request.

webhook_authorization:stringopt

Authorization header for the webhook. This parameter allows you to add authentication to your webhook endpoint.

Response

{
    "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Endpoint: GET /api/v1/jobs/{job_id}

Check the status of your job using the job_id returned from Step 1.

Response Example (Completed)

{
    "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
    "status": "CompletedJob",
    "result": {
        "metadata": {
            "title": "Example Audio Title",
            "duration": 180,
            "upload_date": 1729641600
        },
        "response": "https://s3.huntapi.com/audios/audio_id.mp3"
    }
}

Notes

Some audios cannot be downloaded for the following reasons:

Private content: If the content is set as private by its owner
Unavailable content: If the content has been deleted or is no longer accessible
Age restricted content: If the content is age restricted

In these cases, the API will return an explanatory error message.

Get API Key

Response

Response Example (Completed)

Notes

VIDEO API