Media metadata and job progress

We shipped a few media updates that were overdue: inspect a URL without downloading it, and see how far a download has gone.

Media Metadata (no download)

Need the title, duration, thumbnail, or channel before you spend a download credit? Call:

GET https://api.huntapi.com/v1/media/metadata?query=https://www.youtube.com/watch?v=VIDEO_ID
x-api-key: YOUR_API_KEY

This endpoint is synchronous. You get a metadata object in the same response - no job_id, no polling. Cost: 1 credit per successful call.

Docs: Media Metadata API.

Use it to preview a URL, build a catalog, or decide quality / max_duration before starting a download job.

Download job progress (0–100)

Video and audio downloads stay asynchronous. What’s new on GET https://api.huntapi.com/v1/jobs/{id} is a numeric progress field:

Poll every 1–2 seconds while the job is Queued or Running. Webhooks still work if you prefer not to poll.

Updated references:

• Video Download API
• Audio Download API

Quick mental model

1. Info only → GET https://api.huntapi.com/v1/media/metadata
2. File → GET https://api.huntapi.com/v1/video/download (or /v1/audio/download) → poll /v1/jobs/{id}

Grab a key on app.huntapi.com and try a metadata call first - it’s the cheapest way to confirm a URL is usable.