Transcripts

This API allows you to fetch the transcripts of a set of YouTube video IDs.

POST /api/transcripts

Headers

Authorization
Required
Basic API token generated in your profile. Check the pricing page to see the cost of this API.
Content-Type
Required
application/json

Parameters

ids
Required
Array of strings that contains the ids of all the video's you want the transcripts of. Limited to 50 at a time!
countryCode
Optional string that indicates the country code to use for fetching the transcripts. If not provided, the default is "us". See https://en.wikipedia.org/wiki/ISO_3166-1 for valid country codes.

Rate Limit

The API is rate-limited to 5 requests per 10 seconds. If you exceed this limit, you will receive a 429 Too Many Requests response.
A Retry-After header will be included in the response when you hit the rate limit. It indicates how many seconds you should wait before making another request.
curl -X POST https://www.youtube-transcript.io/api/transcripts \ -H "Authorization: Basic <your-api-token>" \ -H "Content-Type: application/json" \ -d '{"ids": ["jNQXAC9IVRw"]}'

By using this Service, you acknowledge that you have read, understood, and agreed to these Terms of Service.