Endpoints available:

FETCH BY TIME

This API returns 10 consecutive captions from the video and start time indicated.
Endpoint: https://youglish.com/api/v1/captions/fetch/by_time

API Parameters

Name Required Type Meaning Values
key Yes String Your App key
video Yes String Video ID
lg Yes String Language to search arabic, chinese, dutch, english, french, german, greek, hebrew, italian, japanese, korean, polish, portuguese, romanian, russian, spanish, swedish, thai, turkish, ukrainian, vietnamese, signlanguage
start Yes Number Time from where to start fetching captions Value in seconds.

Example

Return 10 English consecutive captions from video QBO7B1RSR8A, starting at 12 seconds:
API call: https://youglish.com/api/v1/captions/fetch/by_time?key=your_key&video=QBO7B1RSR8A&lg=english&start=12
Result:
	{
		"total":"10",
		"results":
		[
			{
				'id': '17014323',
				'display': 'she's written a book called "The Life of I."',
				'start': '11',
				'end': '13'
			},
			{
				'id': '17014324',
				'display': 'It's all about narcissism and the issues',
				'start': '13',
				'end': '17'
			},
			...
		]
	}

FETCH BY CAPTION ID

This API returns 10 consecutive captions from the video and caption ID indicated.
Endpoint: https://youglish.com/api/v1/captions/fetch/by_id

API Parameters

Name Required Type Meaning Values
key Yes String Your App key
video Yes String Video ID
lg Yes String Language to search arabic, chinese, dutch, english, french, german, greek, hebrew, italian, japanese, korean, polish, portuguese, romanian, russian, spanish, swedish, thai, turkish, ukrainian, vietnamese, signlanguage
id Yes Number Caption ID from where to start fetching captions

Example

Return 10 English consecutive captions from video QBO7B1RSR8A, starting at ID: 24384338
API call: https://youglish.com/api/v1/captions/fetch/by_id?key=your_key&video=QBO7B1RSR8A&lg=english&id=24384338
Result:
	{
		"total":"10",
		"results":
		[
		    {
		      "id": "24384338",
		      "display": ">> Our speaker today, Anne Manne,",
		      "start": "9",
		      "end": "10"
		    },
		    {
		      "id": "24384339",
		      "display": "she's written a book called "The Life of I."",
		      "start": "11",
		      "end": "13"
		    },
			...
		]
	}

FETCH ALL

This API returns all the captions of the requested video.
Endpoint: https://youglish.com/api/v1/captions/fetch/all

API Parameters

Name Required Type Meaning Values
key Yes String Your App key
video Yes String Video ID
lg Yes String Language to search arabic, chinese, dutch, english, french, german, greek, hebrew, italian, japanese, korean, polish, portuguese, romanian, russian, spanish, swedish, thai, turkish, ukrainian, vietnamese, signlanguage

Example

Return all the captions of video 'QBO7B1RSR8A':
API call: https://youglish.com/api/v1/captions/fetch/all?key=your_key&video=QBO7B1RSR8A&lg=english
Result:
	{
		"total":"1137",
		"results":
		[
			{
				'id': '24384337',
				'display': '[ Music ]',
				'start': '0',
				'end': '8'
			},
			{
				'id': '24384338',
				'display': '>> Our speaker today, Anne Manne,',
				'start': '9',
				'end': '10'
			},
			...
		]
	}