Skip to main content
GET
/
youtube
/
batch
/
{jobId}
import { Supadata } from '@supadata/js';

const supadata = new Supadata({
  apiKey: 'YOUR_API_KEY',
});

const batchResults = await supadata.youtube.batch.getBatchResults(JOB_ID);
console.log(batchResults);
{
  "status": "completed",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "transcript": {
        "content": [
          {
            "text": "Never gonna give you up...",
            "offset": 8150,
            "duration": 1200,
            "lang": "en"
          }
        ],
        "lang": "en",
        "availableLangs": [
          "en",
          "es",
          "zh-TW"
        ]
      },
      "video": {
        "id": "dQw4w9WgXcQ",
        "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
        "description": "The official music video for \"Never Gonna Give You Up\"...",
        "duration": 213,
        "channel": {
          "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
          "name": "Rick Astley"
        },
        "tags": [
          "Rick Astley",
          "Official Video",
          "Music"
        ],
        "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
        "uploadDate": "2009-10-25T00:00:00.000Z",
        "viewCount": 1234567890,
        "likeCount": 12345678,
        "transcriptLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      "errorCode": "not-found"
    }
  ],
  "stats": {
    "total": 10,
    "succeeded": 8,
    "failed": 2
  },
  "completedAt": "2025-04-03T06:59:53.428Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
jobId
string
required

The batch job ID

Response

Successfully retrieved the status and results (if completed)

Response for batch job results

​
status
enum<string>
required

Current status of the batch job

Available options:
queued,
active,
completed,
failed
Example:

"completed"

​
results
object[]
required

Array of results for each video in the batch

​
stats
object
required

Statistics about the batch job progress

​
completedAt
string<date-time> | null

Timestamp when the job completed, if status is completed

Example:

"2025-04-03T06:59:53.428Z"