Get a timed transcript
curl --request GET \
--url https://api.video2ctx.dev/v1/providers/{provider}/videos/{id}/transcript \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.video2ctx.dev/v1/providers/{provider}/videos/{id}/transcript', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.video2ctx.dev/v1/providers/{provider}/videos/{id}/transcript"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"videoId": "<string>",
"track": {
"id": "<string>",
"name": "<string>",
"languageCode": "<string>",
"kind": "manual",
"isTranslatable": true,
"isDefault": true,
"provenance": "manual"
},
"text": "<string>",
"meta": {
"provider": "youtube",
"source": "video2ctx",
"fetchedAt": "2023-11-07T05:31:56Z",
"partial": true,
"warnings": [
"<string>"
]
},
"translatedTo": {
"languageCode": "<string>",
"name": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}Videos
Get a timed transcript
GET
/
v1
/
providers
/
{provider}
/
videos
/
{id}
/
transcript
Get a timed transcript
curl --request GET \
--url https://api.video2ctx.dev/v1/providers/{provider}/videos/{id}/transcript \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.video2ctx.dev/v1/providers/{provider}/videos/{id}/transcript', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.video2ctx.dev/v1/providers/{provider}/videos/{id}/transcript"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"videoId": "<string>",
"track": {
"id": "<string>",
"name": "<string>",
"languageCode": "<string>",
"kind": "manual",
"isTranslatable": true,
"isDefault": true,
"provenance": "manual"
},
"text": "<string>",
"meta": {
"provider": "youtube",
"source": "video2ctx",
"fetchedAt": "2023-11-07T05:31:56Z",
"partial": true,
"warnings": [
"<string>"
]
},
"translatedTo": {
"languageCode": "<string>",
"name": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}Authorizations
bearerApiKeysessionCookiecliSessionapiKeydemoUser
Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects
Path Parameters
External video provider.
Available options:
youtube Example:
"youtube"
Provider video ID.
Minimum string length:
1Example:
"dQw4w9WgXcQ"
Query Parameters
Fetch again and save a new version. Default reuses saved data regardless of age. A failed explicit refresh returns an error.
Desired transcript language. The backend selects the default source track and translates only when necessary.
Example:
"hi"
Response detail. text omits timing arrays, segments keeps segment timing, and words keeps word timing. Omitted preserves the rich words response.
Available options:
text, segments, words