YouTube Search

The Arcade YouTube Search toolkit provides a pre-built set of tools for interacting with YouTube. These tools make it easy to build agents and AI apps that can:

• Search for videos on YouTube;
• Get details about a video.

Available Tools

Youtube.SearchForVideos

Search for videos on YouTube.

Parameters

• keywords (string, required) Keywords to search for. E.g. ‘apple iphone’ or ‘samsung galaxy’
• language_code (string, optional, Defaults to ‘en’ English) 2-character language code to use in the YouTube search. A list of supported language codes can be found here.
• country_code (string, optional, Defaults to ‘us’ United States) 2-character country code to use in the YouTube search. A list of supported country codes can be found here.
• next_page_token (string, optional, Defaults to ‘None’) The next page token to use for pagination. Defaults to None (start from the first page).

Youtube.GetYoutubeVideoDetails

Get details about a video on YouTube.

Parameters

• video_id (string, required) Video ID. E.g. ‘414600577’. This can be retrieved from the search results of the SearchYoutubeVideos tool.
• language_code (string, optional, Defaults to ‘en’ English) 2-character language code to return information about the video. A list of supported language codes can be found here.
• country_code (string, optional, Defaults to ‘us’ United States) 2-character country code to return information about the video. A list of supported country codes can be found here.

Auth

The Arcade YouTube Search toolkit uses the SerpAPI to get video information from YouTube.

• Secret:
  • SERP_API_KEY: Your SerpAPI API key.

Default parameter values

Language and Country are configurable through environment variables. When set, they will be used as default for YouTube tools.

Providing a different value as language_code or country_code argument in a tool call will override the default value set in the environment variables.

Language

The language code is a 2-character code that determines the language in which the API will search and return video information. There are two environment variables:

• ARCADE_GOOGLE_LANGUAGE: a default value for all Google Search tools. If not set, defaults to ‘en’ (English).
• ARCADE_YOUTUBE_SEARCH_LANGUAGE: a default value for the YouTube Search tools. If not set, defaults to ARCADE_GOOGLE_LANGUAGE.

A list of supported language codes can be found here.

Country

The country code is a 2-character code that determines the country in which the API will search for videos:

• ARCADE_GOOGLE_COUNTRY: a default value for all Google Search tools. If not set, defaults to None.
• ARCADE_YOUTUBE_SEARCH_COUNTRY: a default value for the YouTube Search tools. If not set, defaults to ARCADE_GOOGLE_COUNTRY. If ARCADE_GOOGLE_COUNTRY is not set, the default country for YouTube tools will be us (United States).

A list of supported country codes can be found here.

Reference

LanguageCodes

• ar: Arabic
• bn: Bengali
• da: Danish
• de: German
• el: Greek
• en: English
• es: Spanish
• fi: Finnish
• fr: French
• hi: Hindi
• hu: Hungarian
• id: Indonesian
• it: Italian
• ja: Japanese
• ko: Korean
• ms: Malay
• nl: Dutch
• no: Norwegian
• pcm: Nigerian Pidgin
• pl: Polish
• pt: Portuguese
• pt-br: Portuguese (Brazil)
• pt-pt: Portuguese (Portugal)
• ru: Russian
• sv: Swedish
• tl: Filipino
• tr: Turkish
• uk: Ukrainian
• zh: Chinese
• zh-cn: Chinese (Simplified)
• zh-tw: Chinese (Traditional)

CountryCodes

• af: Afghanistan
• al: Albania
• dz: Algeria
• as: American Samoa
• ad: Andorra
• ao: Angola
• ai: Anguilla
• aq: Antarctica
• ag: Antigua and Barbuda
• ar: Argentina
• am: Armenia
• aw: Aruba
• au: Australia
• at: Austria
• az: Azerbaijan
• bs: Bahamas
• bh: Bahrain
• bd: Bangladesh
• bb: Barbados
• by: Belarus
• be: Belgium
• bz: Belize
• bj: Benin
• bm: Bermuda
• bt: Bhutan
• bo: Bolivia
• ba: Bosnia and Herzegovina
• bw: Botswana
• bv: Bouvet Island
• br: Brazil
• io: British Indian Ocean Territory
• bn: Brunei Darussalam
• bg: Bulgaria
• bf: Burkina Faso
• bi: Burundi
• kh: Cambodia
• cm: Cameroon
• ca: Canada
• cv: Cape Verde
• ky: Cayman Islands
• cf: Central African Republic
• td: Chad
• cl: Chile
• cn: China
• cx: Christmas Island
• cc: Cocos (Keeling) Islands
• co: Colombia
• km: Comoros
• cg: Congo
• cd: Congo, the Democratic Republic of the
• ck: Cook Islands
• cr: Costa Rica
• ci: Cote D’ivoire
• hr: Croatia
• cu: Cuba
• cy: Cyprus
• cz: Czech Republic
• dk: Denmark
• dj: Djibouti
• dm: Dominica
• do: Dominican Republic
• ec: Ecuador
• eg: Egypt
• sv: El Salvador
• gq: Equatorial Guinea
• er: Eritrea
• ee: Estonia
• et: Ethiopia
• fk: Falkland Islands (Malvinas)
• fo: Faroe Islands
• fj: Fiji
• fi: Finland
• fr: France
• gf: French Guiana
• pf: French Polynesia
• tf: French Southern Territories
• ga: Gabon
• gm: Gambia
• ge: Georgia
• de: Germany
• gh: Ghana
• gi: Gibraltar
• gr: Greece
• gl: Greenland
• gd: Grenada
• gp: Guadeloupe
• gu: Guam
• gt: Guatemala
• gg: Guernsey
• gn: Guinea
• gw: Guinea-Bissau
• gy: Guyana
• ht: Haiti
• hm: Heard Island and Mcdonald Islands
• va: Holy See (Vatican City State)
• hn: Honduras
• hk: Hong Kong
• hu: Hungary
• is: Iceland
• in: India
• id: Indonesia
• ir: Iran, Islamic Republic of
• iq: Iraq
• ie: Ireland
• im: Isle of Man
• il: Israel
• it: Italy
• je: Jersey
• jm: Jamaica
• jp: Japan
• jo: Jordan
• kz: Kazakhstan
• ke: Kenya
• ki: Kiribati
• kp: Korea, Democratic People’s Republic of
• kr: Korea, Republic of
• kw: Kuwait
• kg: Kyrgyzstan
• la: Lao People’s Democratic Republic
• lv: Latvia
• lb: Lebanon
• ls: Lesotho
• lr: Liberia
• ly: Libyan Arab Jamahiriya
• li: Liechtenstein
• lt: Lithuania
• lu: Luxembourg
• mo: Macao
• mk: Macedonia, the Former Yugosalv Republic of
• mg: Madagascar
• mw: Malawi
• my: Malaysia
• mv: Maldives
• ml: Mali
• mt: Malta
• mh: Marshall Islands
• mq: Martinique
• mr: Mauritania
• mu: Mauritius
• yt: Mayotte
• mx: Mexico
• fm: Micronesia, Federated States of
• md: Moldova, Republic of
• mc: Monaco
• mn: Mongolia
• me: Montenegro
• ms: Montserrat
• ma: Morocco
• mz: Mozambique
• mm: Myanmar
• na: Namibia
• nr: Nauru
• np: Nepal
• nl: Netherlands
• an: Netherlands Antilles
• nc: New Caledonia
• nz: New Zealand
• ni: Nicaragua
• ne: Niger
• ng: Nigeria
• nu: Niue
• nf: Norfolk Island
• mp: Northern Mariana Islands
• no: Norway
• om: Oman
• pk: Pakistan
• pw: Palau
• ps: Palestinian Territory, Occupied
• pa: Panama
• pg: Papua New Guinea
• py: Paraguay
• pe: Peru
• ph: Philippines
• pn: Pitcairn
• pl: Poland
• pt: Portugal
• pr: Puerto Rico
• qa: Qatar
• re: Reunion
• ro: Romania
• ru: Russian Federation
• rw: Rwanda
• sh: Saint Helena
• kn: Saint Kitts and Nevis
• lc: Saint Lucia
• pm: Saint Pierre and Miquelon
• vc: Saint Vincent and the Grenadines
• ws: Samoa
• sm: San Marino
• st: Sao Tome and Principe
• sa: Saudi Arabia
• sn: Senegal
• rs: Serbia
• sc: Seychelles
• sl: Sierra Leone
• sg: Singapore
• sk: Slovakia
• si: Slovenia
• sb: Solomon Islands
• so: Somalia
• za: South Africa
• gs: South Georgia and the South Sandwich Islands
• es: Spain
• lk: Sri Lanka
• sd: Sudan
• sr: Suriname
• sj: Svalbard and Jan Mayen
• sz: Swaziland
• se: Sweden
• ch: Switzerland
• sy: Syrian Arab Republic
• tw: Taiwan, Province of China
• tj: Tajikistan
• tz: Tanzania, United Republic of
• th: Thailand
• tl: Timor-Leste
• tg: Togo
• tk: Tokelau
• to: Tonga
• tt: Trinidad and Tobago
• tn: Tunisia
• tr: Turkiye
• tm: Turkmenistan
• tc: Turks and Caicos Islands
• tv: Tuvalu
• ug: Uganda
• ua: Ukraine
• ae: United Arab Emirates
• uk: United Kingdom
• gb: United Kingdom
• us: United States
• um: United States Minor Outlying Islands
• uy: Uruguay
• uz: Uzbekistan
• vu: Vanuatu
• ve: Venezuela
• vn: Viet Nam
• vg: Virgin Islands, British
• vi: Virgin Islands, U.S.
• wf: Wallis and Futuna
• eh: Western Sahara
• ye: Yemen
• zm: Zambia
• zw: Zimbabwe

pip install arcade_youtube