Skip to main content
GET
/
v1
/
raw
/
youtube
/
transcript
/
{video_id}
cURL
curl --request GET \
  --url https://api.influship.com/v1/raw/youtube/transcript/{video_id} \
  --header 'X-API-Key: <api-key>'
import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const response = await client.raw.youtube.getTranscript('dQw4w9WgXcQ');

console.log(response.data);
import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
response = client.raw.youtube.get_transcript(
    video_id="dQw4w9WgXcQ",
)
print(response.data)
{
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Full Body Workout | 30 Minutes",
    "language": "en",
    "source": "manual",
    "transcript": [
      {
        "text": "Welcome to my channel!",
        "start": 0.5,
        "duration": 2.3
      }
    ],
    "full_text": "<string>",
    "word_count": 1245,
    "available_languages": [
      {
        "code": "en",
        "name": "English",
        "is_auto": false
      }
    ],
    "scraped_at": "2024-01-15T14:30:00Z"
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

video_id
string
required

YouTube video ID

Minimum string length: 1
Example:

"dQw4w9WgXcQ"

Query Parameters

language
string
default:auto

Language code or "auto" for automatic detection

Example:

"en"

Response

Successful response

data
object
required