YouTube Batch Download Task Information API

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

API Details

Endpoint POST https://download.abcproxy.com/download/info/batch

Description
This API retrieves detailed information about a YouTube video batch download job, including the status of each individual download and the video metadata for completed downloads.

Request

HTTP Request

curl -X POST "https://download.abcproxy.com/download/info/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "batch_id": "aa3aba32-796f-4449-929e-3809d366f72c"
  }'


import requests

payload = {
    "batch_id": "aa3aba32-796f-4449-929e-3809d366f72c"
}
response = requests.post("https://download.abcproxy.com/download/info/batch", json=payload)
print(response.json())

const axios = require('axios');

const payload = {
  batch_id: "aa3aba32-796f-4449-929e-3809d366f72c"
};

axios.post("https://download.abcproxy.com/download/info/batch", payload)
  .then(response => console.log(response.data));

POST /download/info/batch HTTP/1.1
Host: https://download.abcproxy.com
Content-Type: application/json

{
  "batch_id": "aa3aba32-796f-4449-929e-3809d366f72c"
}

Parameters

Request Body

Name

Type

Required

Description

Example

batch_id

string

Yes

The ID of the batch download job to query

"aa3aba32-796f-4449-929e-3809d366f72c"

Response

Success 200

Response Body - Completed Example

{
  "code": 200,
  "msg": "Success",
  "data": {
    "batch_id": "d0a3d4a1-403d-41f3-a232-c2f7dc79bb1a",
    "status": "completed",
    "total_job_count": 2,
    "completed_job_count": 2,
    "failed_job_count": 0,
    "job_list": [
      {
        "job_id": "6ba037bd-9b4f-413b-8795-87d500198da0",
        "status": "completed",
        "error": "",
        "video_info": {
          "url": "https://www.youtube.com/watch?v=1BxhbKNbjqE",
          "video_id": "1BxhbKNbjqE",
          "download_url": "download\\cb4bf5ad-16ed-46b7-9158-0dae601ff555\\1BxhbKNbjqE_afe557bc446c7ec5a0085a5229d6022f.mp4",
          "title": "oceans",
          "duration": 47,
          "resolution": "640x266"
        }
      },
      {
        "job_id": "ebe5f3da-4126-4196-a595-7003c7e69ef0",
        "status": "completed",
        "error": "",
        "video_info": {
          "url": "https://www.youtube.com/watch?v=dXzrhQfzvhA",
          "video_id": "dXzrhQfzvhA",
          "download_url": "download\\4abaf508-0d0e-4c55-b4d6-78aa1b5e91fa\\dXzrhQfzvhA_d26591dcd09b38c0079ffe960d6def12.mp4",
          "title": "#SeasideSunset #EveningGlow #VideoMaterial #HealingScenery #special #shorts",
          "duration": 7,
          "resolution": "640x360"
        }
      }
    ]
  }
}

Response Body - Pending Example

{
  "code": 200,
  "msg": "Success",
  "data": {
    "batch_id": "25ba9534-bb83-4496-ac5b-6bc94f83e963",
    "status": "pending",
    "total_job_count": 2,
    "completed_job_count": 0,
    "failed_job_count": 0,
    "job_list": [
      {
        "job_id": "3283017f-c4bf-45e9-9f33-0021c1bd1cf3",
        "status": "pending",
        "error": "",
        "video_info": null
      },
      {
        "job_id": "dc773dd5-57d7-435b-8a5d-aff9d536adb3",
        "status": "pending",
        "error": "",
        "video_info": null
      }
    ]
  }
}

Response Body - Partial Completion Example

{
  "code": 200,
  "msg": "Success",
  "data": {
    "batch_id": "aa3aba32-796f-4449-929e-3809d366f72c",
    "status": "partial",
    "total_job_count": 2,
    "completed_job_count": 1,
    "failed_job_count": 1,
    "job_list": [
      {
        "job_id": "8c780403-73a4-4c97-aa22-c89930b203dc",
        "status": "completed",
        "error": "",
        "video_info": {
          "url": "https://www.youtube.com/watch?v=1BxhbKNbjqE",
          "video_id": "1BxhbKNbjqE",
          "download_url": "download\\0f4a5ab2-51ce-42e5-8cde-4c2829bf8f6a\\1BxhbKNbjqE_afe557bc446c7ec5a0085a5229d6022f.mp4",
          "title": "oceans",
          "duration": 47,
          "resolution": "640x266"
        }
      },
      {
        "job_id": "ef0d5f13-22de-4195-87f4-be14a6aa53e3",
        "status": "failed",
        "error": "Failed after exceeding maximum retry attempts. The reason for failure in the last attempt was: Task execution failed, failure cause: [error details]：An unexpected error occurred during download: ERROR: [youtube] dXzrhQfzvhA: Sign in to confirm you're not a bot...",
        "video_info": null
      }
    ]
  }
}

Response Fields

Field

Type

Description

code

integer

Response code (200 for success)

msg

string

Response message

data.batch_id

string

The batch job ID

data.status

string

Overall batch status (pending, completed, partial, failed)

data.total_job_count

integer

Total number of videos in the batch

data.completed_job_count

integer

Number of successfully downloaded videos

data.failed_job_count

integer

Number of failed downloads

data.job_list

array

List of individual download jobs

job_list[].job_id

string

Individual job ID

job_list[].status

string

Job status (pending, completed, failed)

job_list[].error

string

Error message if job failed

job_list[].video_info

object/null

Video metadata for completed jobs

video_info.url

string

Original YouTube URL

video_info.video_id

string

YouTube video ID

video_info.download_url

string

Local path or 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)

Status Values

pending: All jobs are still processing
completed: All jobs finished successfully
partial: Some jobs succeeded, some failed
failed: All jobs failed

Error Responses

Common Errors

HTTP Status

Error Code

Description

400

Invalid batch ID

The provided batch ID is invalid or missing

404

Batch not found

No batch job exists with the provided ID

500

Internal server error

An error occurred while processing the request

Error Example


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

Notes

The download_url in the response may be either:
- A local file path (for direct server storage)
- A cloud storage URL (if configured during batch creation)
For pending jobs, the video_info field will be null.
The error field will contain detailed failure reasons for failed jobs, which may include YouTube-specific error messages.

PreviousYouTube Video Batch Download API NextYouTube Single Download Job Information API