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 http://https://serpapi.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

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

Python

import requests

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

Node.js

const axios = require('axios');

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

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

HTTP

POST /download/info/batch HTTP/1.1
Host: https://serpapi.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": "C:\\code\\project\\youtube\\yt-downloader\\app\\worker\\batch_download_task\\consumer\\yt-downloader\\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": "C:\\code\\project\\youtube\\yt-downloader\\app\\worker\\batch_download_task\\consumer\\yt-downloader\\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": "C:\\code\\project\\youtube\\yt-downloader\\app\\worker\\batch_download_task\\consumer\\yt-downloader\\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

1. 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)

2. For pending jobs, the video_info field will be null.

3. The error field will contain detailed failure reasons for failed jobs, which may include YouTube-specific error messages.