Endpoints available:

SEARCH

This API returns videos that contain the query in the language and accent specified.
Each result comes with the caption and location in the video where the query appears.
Endpoint: https://youglish.com/api/v1/videos/search

API Parameters

Name Required Type Meaning Values
key Yes String Your App key
query Yes String Query to search
lg Yes String Language to search arabic, chinese, dutch, english, french, german, greek, hebrew, hindi, italian, japanese, korean, persian, polish, portuguese, romanian, russian, spanish, swedish, thai, turkish, ukrainian, vietnamese, signlanguage
accent No String Accent to search Arabic: sa, eg, dz, ma, tn, lb, sy, jo, iq, qa, ae, kw, bh, om af, ps, il, ly
Chinese: cn, tw, sg, hk, sh, mo, mn
Dutch: nl, be
English: us, uk, aus, ca, ie, sco, nz
French: fr, qc, be, ch
Portuguese: pt, br
Spanish: es, la
Sign Languages: us, uk, ie,nz, aus, fr, is

Default: None or all
restricted No String Adult content restricted yes , no

Default: no

gender No String Gender of the speaker m (male), f(female)

Default: None

page No Number Used to implement pagination.
Depending on your plan, max. page & hits per page may apply.

Default: 1

Examples

Return US-English speaking videos containing 'cat':
API call: https://youglish.com/api/v1/videos/search?key=your_key&query=cat&lg=english&accent=us
Result:
{
	'total_results': '8946',
	'results': [
		{
			'display': 'as it is to order cat food to my house?',
			'vid': '3OgsRa7VDtI',
			'start': '304',
			'id': '10474658',
			'zone': 'US'
		},
		{
			'display': 'The entire crew? One cat.',
			'vid': 'trr8Sy1wYa0',
			'start': '80',
			'id': '41269315',
			'zone': 'US'
		},
		//...
	]
}
Return French speaking videos containing 'bonjour':
API call: https://youglish.com/api/v1/videos/search?key=your_key&query=bonjour&lg=french
Result:
{
	'total_results': '9346',
	'results': [
		{
			'display': 'Bonjour Thomas Bourdrel - Bonjour - vous êtes radiologue,',
			'vid': '-f7V7F3YvRU',
			'start': '25',
			'id': '1707131,
			'zone': 'FRANCE'
		},
		{
			'display': 'Bonjour Michel alors l'intelligence artificielle au service',
			'vid': 'HShlybf_3Og',
			'start': '120',
			'id': '1788246',
			'zone': 'FRANCE'
		},
		//...
	]
}

COUNT

This API returns the number of result found for the parameters specified.
Endpoint: https://youglish.com/api/v1/videos/count

API Parameters

Name Required Type Meaning Values
key Yes String Your App key
query Yes String Query to search
lg Yes String Language to search See Search API for all supported languages.
accent No String Accent to search See Search API for all supported accents.
restricted No String Adult content restricted yes , no

Default: no

gender No String Gender of the speaker m (male), f(female)

Default: None

Examples

Return number of US-English speaking videos containing 'cat':
API call: https://youglish.com/api/v1/videos/count?key=your_key&query=cat&lg=english&accent=us
Result:
{
	'total': '8946',
}