HuntAPI

Jobs

Fetch the status and result of a HuntAPI async job.

GET
/v1/jobs

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Path Parameters

id*string

Unique identifier for the job (UUID). This is the job_id returned by async endpoints like /v1/video/download and /v1/audio/download.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.huntapi.com/v1/jobs"
{
  "id": "0193443f-fb80-9d19-29ba-82bc77c7cd8c",
  "args": {
    "query": "https://www.youtube.com/watch?v=example"
  },
  "status": "QueuedJob",
  "endpoint": "/v1/video/download",
  "created_at": "2024-11-19T11:47:44.127229Z",
  "started_at": "2024-11-19T11:47:44.134374Z"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}