YouTube Single Download Job Information API

/download/info/job API endpoint allows you to query the status and details of a single download job.

API Details

Endpoint GET https://download.abcproxy.com/download/info/job

Description

Query the status and details of a single YouTube video download job, including download status and video metadata for completed downloads.

---

Request

HTTP Request

---

cURL

curl -X GET "https://download.abcproxy.com/download/info/job?job_id=411e81d8-237c-4c96-b946-990ade660c1d"

Python

import requests

params = {
    "job_id": "411e81d8-237c-4c96-b946-990ade660c1d"
}
response = requests.get("https://download.abcproxy.com/download/info/job", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  job_id: "411e81d8-237c-4c96-b946-990ade660c1d"
};

axios.get("https://download.abcproxy.com/download/info/job", { params })
  .then(response => console.log(response.data));

HTTP

GET /download/info/job?job_id=411e81d8-237c-4c96-b946-990ade660c1d HTTP/1.1
Host: download.abcproxy.com

Parameters

Query Parameters

Name	Type	Required	Description	Example
job_id	string	Yes	The ID of the job to query	"411e81d8-237c-4c96-b946-990ade660c1d"

---

Response

Success 200

Response Body - Completed Example

{
  "code": 200,
  "msg": "Success",
  "data": {
    "job_id": "a082eec0-8902-4016-b38a-0dce65d309f9",
    "video_id": "ONZZvc_IqQg",
    "status": "completed",
    "error": "",
    "video_info": {
      "url": "https://www.youtube.com/watch?v=ONZZvc_IqQg",
      "video_id": "ONZZvc_IqQg",
      "download_url": "https://s3-service.exampleapi.net/files/youtube/videos/ONZZvc_IqQg_5992d185990a55f38ca4cadb79cd9188.mp4",
      "title": "Rust and Linux",
      "duration": 729,
      "resolution": "640x360"
    }
  }
}

Response Body - Failed Example

{
  "code": 200,
  "msg": "Success",
  "data": {
    "job_id": "a082eec0-8902-4016-b38a-0dce65d309f9",
    "video_id": "ONZZvc_IqQg",
    "status": "failed",
    "error": "Download failed",
    "video_info": {}
  }
}

Response Body - Pending Example

{
  "code": 200,
  "msg": "Success",
  "data": {
    "job_id": "a082eec0-8902-4016-b38a-0dce65d309f9",
    "video_id": "ONZZvc_IqQg",
    "status": "pending",
    "error": "",
    "video_info": {}
  }
}

Response Fields

Field	Type	Description
code	integer	Response code (200 for success)
msg	string	Response message
data.job_id	string	The job ID
data.video_id	string	YouTube video ID
data.status	string	Job status (pending: processing, completed: success, failed: error)
data.error	string	Error message if job failed
data.video_info	object	Video metadata (empty for pending/failed jobs)
video_info.url	string	Original YouTube URL
video_info.video_id	string	YouTube video ID
video_info.download_url	string	URL to downloaded file
video_info.title	string	Video title
video_info.duration	integer	Video duration in seconds
video_info.resolution	string	Video resolution (widthxheight)

---

Error Responses

Common Errors

HTTP Status	Error Code	Description
400	Invalid job ID	The provided job ID is invalid or missing
404	Job not found	No job exists with the provided ID
500	Internal server error	An error occurred while processing the request

Error Example

{
  "code": 404,
  "msg": "Job not found",
  "data": null
}

---

Notes

1. The download_url in the response will be a publicly accessible URL where the video can be downloaded

2. For pending or failed jobs, the video_info object will be empty

3. The error field will contain detailed failure reasons for failed jobs