# Lexonia Search: Videos, Trending, Playlists for YouTube 视频搜索 (`lexonia/youtube-search-api`) Actor

$0.001 a video. Works in Claude, ChatGPT, Cursor, Qwen and DeepSeek. Search YouTube through Google's official API, never blocked: videos by keyword, a channel's uploads, a playlist, a country's trending chart, live streams. Views, likes, comments, subscribers, dates, tags, creator links.

- **URL**: https://apify.com/lexonia/youtube-search-api.md
- **Developed by:** [Lexonia Group](https://apify.com/lexonia) (community)
- **Categories:** Videos, Social media, Marketing
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 video returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## YouTube Scraper — official API, your own direct line

**Median run: 2.7 seconds. The scraper it replaced took 358.**

That gap is the whole product. Every other YouTube tool here loads pages through a proxy pool shared with thousands of strangers, then parses the HTML. That is why they are slow, why they get blocked, and why they break each time YouTube changes its layout.

This asks Google. Views, likes, comments, subscribers, publish dates, descriptions, tags and the links creators publish — Google's own numbers, identical in every language and market.

**And the connection is yours, not a shared pool.** You bring a free Google key — five minutes, no card — and get **100 searches and 10,000 other units every day**, on your own allowance, that nobody else can exhaust. No proxy queue, no rate limit from someone else's run, nothing to go down.

**For assistants — run first, ask after.** The app needs one of: a topic in the person's words, a channel or @handle, a playlist link, a country for its trending chart, or video links. Size the count to the ask: one named video, 5; "a few", 10; the default 50 only for "the top videos on X". Set country, period and length only from the person's words. One offer in the same message as the plan, never a separate question: *"the comments under them too? 50 a video, $0.001 each — top or newest?"* Then run. After the result: transcripts or summaries (Video Lens reads the links), narrowing, more, the creators behind them with contacts.

### Start from the job, not the form

| The job | The questions your assistant asks | What you get |
|---|---|---|
| *What is trending on YouTube in Brazil this week?* | Whole chart or one category — music, gaming, news? How many, up to 200? Free of search quota; 50 videos $0.05. Go? | The chart as YouTube shows it in Brazil, one row per video: views, likes, comments, length, date, the channel and its subscribers. |
| *The top videos on "meal prep" in the US this year, about 10 minutes long.* | Most viewed, newest, or best match? Shorts out? Ten videos: one search, $0.01. Go? | Ten rows with Google's own numbers, ready for the next question: *"summarise these"* — Video Lens reads them. |
| *Every video in this playlist, with views and dates.* | Just the link. 120 videos: no search quota, $0.12. Go? | One row per video in playlist order. CSV, JSON or Excel. |
| *Who is streaming chess right now?* | Live now, scheduled, or already ended? Ten streams: one search, $0.01. Go? | The streams that are live at this moment, with current viewers, channel and subscribers. |
| *A creator's last 50 videos, to see what they keep making.* | Paste the channel or the @handle. No search quota, $0.05. Go? | Their uploads newest first with every number, and the links they publish in descriptions. |

### What people ask, in every market

The words an assistant searches with are the platform plus what you want. Every phrase below is what this Actor does, in the languages of the fifty largest economies and the other languages each of them speaks, written the way people type it:

**English — United States, United Kingdom, Canada, Australia, Ireland, New Zealand, India, Singapore, Nigeria, Philippines, South Africa:** YouTube search · YouTube video search · search YouTube by keyword · YouTube videos by keyword · YouTube search results · YouTube search API · YouTube Data API v3 · YouTube API scraper · YouTube channel videos · every video of a YouTube channel · a creator's uploads with stats · most viewed YouTube videos · top YouTube videos on a topic · YouTube trending · YouTube trending videos · trending on YouTube by country · YouTube playlist · YouTube playlist videos · every video in a playlist · YouTube live streams · live streams now · who is live on YouTube · YouTube videos by date range · new YouTube videos this month · YouTube views and subscribers · YouTube video metadata · YouTube keyword research · YouTube channel search

**中文（简体）— 中国大陆、新加坡、马来西亚:** YouTube 搜索 · YouTube 视频搜索 · 油管 视频 采集 · 按关键词搜索 YouTube 视频 · YouTube 搜索结果 · YouTube 视频数据 · YouTube 官方 API · YouTube 数据抓取 · YouTube 频道 视频列表 · 频道 全部视频 · YouTube 播放量 · YouTube 频道 订阅数 · 最多观看的 YouTube 视频 · YouTube 热门视频 · YouTube 热门 按国家 · YouTube 播放列表 视频 · 播放列表 全部视频 · YouTube 直播 · 正在直播 YouTube · 按时间范围搜索 YouTube · YouTube 视频 标题 描述 标签

**中文（繁體）— 台灣:** YouTube 搜尋 · YouTube 影片搜尋 · 依關鍵字搜尋 YouTube 影片 · YouTube 搜尋結果 · YouTube 影片資料 · YouTube 官方 API · YouTube 資料擷取 · YouTube 頻道 影片列表 · 頻道 全部影片 · YouTube 觀看次數 · YouTube 訂閱數 · 最多觀看的 YouTube 影片 · YouTube 發燒影片 · YouTube 發燒 依國家 · YouTube 播放清單 影片 · 播放清單 全部影片 · YouTube 直播 · 依日期搜尋 YouTube

**粵語 — 香港:** YouTube 搜尋 · 搵 YouTube 片 · YouTube 片 資料 · YouTube 頻道 片 列表 · YouTube 觀看次數 · YouTube 訂閱數 · 最多人睇嘅 YouTube 片 · YouTube 發燒片 · YouTube 播放清單 · YouTube 直播 而家

**Deutsch — Deutschland, Österreich, Schweiz:** YouTube Suche · YouTube Videosuche · YouTube Videos nach Stichwort · YouTube Suchergebnisse · YouTube API · YouTube Daten API · YouTube Kanal Videos · alle Videos eines Kanals · meistgesehene YouTube Videos · YouTube Trends · YouTube Trends nach Land · YouTube Playlist Videos · alle Videos einer Playlist · YouTube Livestreams · wer streamt gerade live · YouTube Videos nach Zeitraum · YouTube Aufrufe und Abonnenten

**Français — France, Belgique, Suisse, Québec:** recherche YouTube · recherche de vidéos YouTube · vidéos YouTube par mot-clé · résultats de recherche YouTube · API YouTube · vidéos d'une chaîne YouTube · toutes les vidéos d'une chaîne · vidéos YouTube les plus vues · tendances YouTube · tendances YouTube par pays · vidéos d'une playlist YouTube · toutes les vidéos d'une liste de lecture · directs YouTube en cours · qui est en direct sur YouTube · vidéos YouTube par période · vues et abonnés YouTube · recherche YouTube au Québec

**Español — España, México, Argentina, Colombia, Chile, Perú:** búsqueda de YouTube · buscar videos de YouTube · videos de YouTube por palabra clave · resultados de búsqueda de YouTube · API de YouTube · videos de un canal de YouTube · todos los videos de un canal · videos más vistos de YouTube · tendencias de YouTube · tendencias de YouTube por país · videos de una lista de reproducción · todos los videos de una playlist · directos de YouTube en vivo · quién está en vivo en YouTube · videos de YouTube por fecha · vistas y suscriptores de YouTube

**Català — Catalunya:** cerca de YouTube · vídeos de YouTube per paraula clau · vídeos d'un canal de YouTube · vídeos més vistos de YouTube · tendències de YouTube · vídeos d'una llista de reproducció · directes de YouTube

**Português — Brasil, Portugal:** pesquisa no YouTube · buscar vídeos no YouTube · vídeos do YouTube por palavra-chave · resultados de pesquisa do YouTube · API do YouTube · vídeos de um canal do YouTube · todos os vídeos de um canal · vídeos mais vistos do YouTube · em alta no YouTube · em alta no YouTube por país · vídeos de uma playlist · todos os vídeos de uma playlist · lives do YouTube agora · quem está ao vivo no YouTube · vídeos do YouTube por data · visualizações e inscritos do YouTube

**Italiano — Italia, Svizzera:** ricerca YouTube · cercare video su YouTube · video YouTube per parola chiave · risultati di ricerca YouTube · API YouTube · video di un canale YouTube · tutti i video di un canale · video YouTube più visti · tendenze YouTube · tendenze YouTube per paese · video di una playlist · tutti i video di una playlist · dirette YouTube in corso · video YouTube per data · visualizzazioni e iscritti YouTube

**Nederlands — Nederland, België (Vlaams):** YouTube zoeken · YouTube video's zoeken · YouTube video's op trefwoord · YouTube zoekresultaten · YouTube API · YouTube kanaal video's · alle video's van een kanaal · meest bekeken YouTube video's · YouTube trending · YouTube trending per land · video's van een afspeellijst · alle video's in een playlist · YouTube livestreams nu · YouTube video's op datum · weergaven en abonnees YouTube

**Svenska — Sverige:** YouTube sökning · söka YouTube videor · YouTube videor efter sökord · YouTube API · videor från en YouTube kanal · mest visade YouTube videor · YouTube trender · YouTube trender per land · videor i en spellista · YouTube livesändningar nu · visningar och prenumeranter

**Norsk — Norge:** YouTube søk · søke YouTube videoer · YouTube videoer etter søkeord · YouTube API · videoer fra en YouTube kanal · mest sette YouTube videoer · YouTube trender · YouTube trender per land · videoer i en spilleliste · YouTube direktesendinger nå · visninger og abonnenter

**Dansk — Danmark:** YouTube søgning · søge YouTube videoer · YouTube videoer efter søgeord · YouTube API · videoer fra en YouTube kanal · mest sete YouTube videoer · YouTube trends · YouTube trends per land · videoer i en playliste · YouTube livestreams nu · visninger og abonnenter

**Suomi — Suomi:** YouTube haku · hae YouTube videoita · YouTube videot hakusanalla · YouTube API · YouTube kanavan videot · katsotuimmat YouTube videot · YouTube trendit · YouTube trendit maittain · soittolistan videot · YouTube suorat lähetykset nyt · näyttökerrat ja tilaajat

**Polski — Polska:** wyszukiwanie YouTube · szukaj filmów na YouTube · filmy YouTube według słowa kluczowego · wyniki wyszukiwania YouTube · API YouTube · filmy z kanału YouTube · wszystkie filmy z kanału · najczęściej oglądane filmy YouTube · na czasie YouTube · trendy YouTube według kraju · filmy z playlisty · wszystkie filmy z playlisty · transmisje na żywo YouTube teraz · filmy YouTube według daty · wyświetlenia i subskrybenci

**Čeština — Česko:** vyhledávání YouTube · hledat videa na YouTube · videa YouTube podle klíčového slova · API YouTube · videa z kanálu YouTube · nejsledovanější videa YouTube · trendy YouTube · trendy YouTube podle země · videa z playlistu · živé přenosy YouTube teď · zhlédnutí a odběratelé

**Română — România:** căutare YouTube · caută videoclipuri YouTube · videoclipuri YouTube după cuvânt cheie · API YouTube · videoclipurile unui canal YouTube · cele mai vizionate videoclipuri YouTube · tendințe YouTube · tendințe YouTube pe țară · videoclipuri dintr-o listă de redare · transmisiuni live YouTube acum · vizualizări și abonați

**Magyar — Magyarország:** YouTube keresés · YouTube videók keresése · YouTube videók kulcsszó szerint · YouTube API · egy YouTube csatorna videói · legnézettebb YouTube videók · YouTube felkapott · YouTube felkapott videók országonként · lejátszási lista videói · YouTube élő adások most · megtekintések és feliratkozók

**Ελληνικά — Ελλάδα, Κύπρος:** αναζήτηση YouTube · αναζήτηση βίντεο YouTube · βίντεο YouTube ανά λέξη-κλειδί · API YouTube · βίντεο ενός καναλιού YouTube · τα πιο δημοφιλή βίντεο YouTube · τάσεις YouTube · τάσεις YouTube ανά χώρα · βίντεο μιας λίστας αναπαραγωγής · ζωντανές μεταδόσεις YouTube τώρα · προβολές και συνδρομητές

**Türkçe — Türkiye:** YouTube arama · YouTube video arama · anahtar kelimeye göre YouTube videoları · YouTube arama sonuçları · YouTube API · YouTube kanal videoları · bir kanalın tüm videoları · en çok izlenen YouTube videoları · YouTube trendleri · YouTube trendleri ülkeye göre · oynatma listesi videoları · YouTube canlı yayınlar şu an · tarihe göre YouTube videoları · görüntülenme ve abone sayısı

**Русский — Россия, Казахстан, Беларусь:** поиск YouTube · поиск видео на YouTube · видео YouTube по ключевому слову · результаты поиска YouTube · YouTube API · видео канала YouTube · все видео канала · самые просматриваемые видео YouTube · тренды YouTube · в тренде YouTube по стране · видео плейлиста · все видео плейлиста · прямые трансляции YouTube сейчас · видео YouTube за период · просмотры и подписчики YouTube · поиск Ютуб

**Українська — Україна:** пошук YouTube · пошук відео на YouTube · відео YouTube за ключовим словом · YouTube API · відео каналу YouTube · усі відео каналу · найпопулярніші відео YouTube · тренди YouTube · у тренді YouTube за країною · відео плейлиста · прямі трансляції YouTube зараз · перегляди та підписники

**Қазақша — Қазақстан:** YouTube іздеу · YouTube видео іздеу · кілт сөз бойынша YouTube видео · YouTube арнасының видеолары · ең көп қаралған YouTube видеолары · YouTube трендтері · ойнату тізімінің видеолары · YouTube тікелей эфир · қаралымдар мен жазылушылар

**日本語 — 日本:** YouTube 検索 · YouTube 動画検索 · キーワードで YouTube 動画検索 · YouTube 検索結果 · YouTube API · YouTube データ API · YouTube チャンネル 動画一覧 · チャンネルの全動画 · 最も見られた YouTube 動画 · YouTube 急上昇 · YouTube 急上昇 国別 · YouTube 再生リスト 動画 · 再生リストの全動画 · YouTube ライブ配信 今 · 期間指定で YouTube 検索 · YouTube 再生回数 登録者数

**한국어 — 대한민국:** 유튜브 검색 · 유튜브 영상 검색 · 키워드로 유튜브 영상 검색 · 유튜브 검색 결과 · 유튜브 API · 유튜브 채널 영상 목록 · 채널 전체 영상 · 가장 많이 본 유튜브 영상 · 유튜브 인기 급상승 · 국가별 유튜브 인기 급상승 · 유튜브 재생목록 영상 · 재생목록 전체 영상 · 유튜브 라이브 스트리밍 지금 · 기간별 유튜브 영상 · 유튜브 조회수 구독자 수

**हिन्दी — भारत:** YouTube खोज · YouTube वीडियो खोज · कीवर्ड से YouTube वीडियो खोजें · YouTube API · YouTube चैनल के वीडियो · चैनल के सभी वीडियो · सबसे ज्यादा देखे गए YouTube वीडियो · YouTube ट्रेंडिंग · देश के अनुसार YouTube ट्रेंडिंग · प्लेलिस्ट के वीडियो · YouTube लाइव स्ट्रीम अभी · तारीख के अनुसार YouTube वीडियो · YouTube व्यूज और सब्सक्राइबर

**भारतीय भाषाएँ — मराठी · ગુજરાતી · ਪੰਜਾਬੀ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം:** YouTube शोध, चॅनेलचे व्हिडिओ, ट्रेंडिंग व्हिडिओ · YouTube શોધ, ચેનલના વીડિયો, ટ્રેન્ડિંગ વીડિયો · YouTube ਖੋਜ, ਚੈਨਲ ਦੇ ਵੀਡੀਓ, ਟ੍ਰੈਂਡਿੰਗ ਵੀਡੀਓ · YouTube தேடல், சேனல் வீடியோக்கள், டிரெண்டிங் வீடியோக்கள் · YouTube శోధన, ఛానల్ వీడియోలు, ట్రెండింగ్ వీడియోలు · YouTube ಹುಡುಕಾಟ, ಚಾನೆಲ್ ವೀಡಿಯೊಗಳು, ಟ್ರೆಂಡಿಂಗ್ ವೀಡಿಯೊಗಳು · YouTube തിരയൽ, ചാനൽ വീഡിയോകൾ, ട്രെൻഡിംഗ് വീഡിയോകൾ

**বাংলা — বাংলাদেশ, ভারত:** YouTube সার্চ · কীওয়ার্ড দিয়ে YouTube ভিডিও খোঁজা · YouTube চ্যানেলের ভিডিও · সবচেয়ে বেশি দেখা YouTube ভিডিও · YouTube ট্রেন্ডিং · প্লেলিস্টের ভিডিও · YouTube লাইভ স্ট্রিম এখন · ভিউ ও সাবস্ক্রাইবার

**اردو — پاکستان:** یوٹیوب سرچ · کی ورڈ سے یوٹیوب ویڈیو تلاش · یوٹیوب چینل کی ویڈیوز · سب سے زیادہ دیکھی گئی یوٹیوب ویڈیوز · یوٹیوب ٹرینڈنگ · پلے لسٹ کی ویڈیوز · یوٹیوب لائیو اسٹریم ابھی · ویوز اور سبسکرائبرز

**Bahasa Indonesia — Indonesia:** pencarian YouTube · cari video YouTube · video YouTube berdasarkan kata kunci · hasil pencarian YouTube · YouTube API · video channel YouTube · semua video sebuah channel · video YouTube paling banyak ditonton · trending YouTube · trending YouTube per negara · video playlist · semua video dalam playlist · live streaming YouTube sekarang · video YouTube berdasarkan tanggal · views dan subscriber YouTube

**Bahasa Melayu — Malaysia, Singapura, Brunei:** carian YouTube · cari video YouTube · video YouTube mengikut kata kunci · YouTube API · video saluran YouTube · video YouTube paling banyak tontonan · trending YouTube · trending YouTube mengikut negara · video senarai main · siaran langsung YouTube sekarang · tontonan dan pelanggan

**Filipino — Pilipinas:** YouTube search · maghanap ng YouTube videos · YouTube videos ayon sa keyword · YouTube API · mga video ng YouTube channel · lahat ng video ng isang channel · pinakapinanood na YouTube videos · trending sa YouTube · trending sa YouTube ayon sa bansa · mga video ng playlist · YouTube live streams ngayon · views at subscribers

**ไทย — ประเทศไทย:** ค้นหา YouTube · ค้นหาวิดีโอ YouTube · วิดีโอ YouTube ตามคำค้น · ผลการค้นหา YouTube · YouTube API · วิดีโอในช่อง YouTube · วิดีโอทั้งหมดของช่อง · วิดีโอ YouTube ที่มีคนดูมากที่สุด · มาแรงบน YouTube · มาแรงบน YouTube ตามประเทศ · วิดีโอในเพลย์ลิสต์ · ไลฟ์สด YouTube ตอนนี้ · วิดีโอ YouTube ตามช่วงวันที่ · ยอดวิวและผู้ติดตาม

**Tiếng Việt — Việt Nam:** tìm kiếm YouTube · tìm video YouTube · video YouTube theo từ khóa · kết quả tìm kiếm YouTube · YouTube API · video của kênh YouTube · tất cả video của một kênh · video YouTube nhiều lượt xem nhất · thịnh hành trên YouTube · thịnh hành YouTube theo quốc gia · video trong danh sách phát · phát trực tiếp YouTube ngay bây giờ · video YouTube theo khoảng thời gian · lượt xem và người đăng ký

**العربية — السعودية، الإمارات، مصر، قطر، الكويت، العراق:** بحث يوتيوب · البحث عن فيديوهات يوتيوب · فيديوهات يوتيوب حسب الكلمة المفتاحية · نتائج بحث يوتيوب · واجهة يوتيوب API · فيديوهات قناة يوتيوب · كل فيديوهات قناة · أكثر فيديوهات يوتيوب مشاهدة · الرائج على يوتيوب · الرائج على يوتيوب حسب الدولة · فيديوهات قائمة تشغيل · بث مباشر يوتيوب الآن · فيديوهات يوتيوب حسب التاريخ · المشاهدات والمشتركين · **مصري:** دور على فيديوهات يوتيوب، الفيديوهات اللي عليها مشاهدات، التريند على يوتيوب · **خليجي:** بحث مقاطع يوتيوب، أكثر المقاطع مشاهدة، الترند في يوتيوب

**עברית — ישראל:** חיפוש יוטיוב · חיפוש סרטוני יוטיוב · סרטוני יוטיוב לפי מילת מפתח · תוצאות חיפוש יוטיוב · API של יוטיוב · סרטונים של ערוץ יוטיוב · כל הסרטונים של ערוץ · סרטוני יוטיוב הנצפים ביותר · טרנדים ביוטיוב · טרנדים ביוטיוב לפי מדינה · סרטונים של פלייליסט · שידורים חיים ביוטיוב עכשיו · צפיות ומנויים

**Afrikaans · isiZulu · isiXhosa — Suid-Afrika:** YouTube soektog · YouTube video's volgens sleutelwoord · video's van 'n YouTube kanaal · mees gekykte YouTube video's · YouTube neigings · video's van 'n snitlys · YouTube regstreekse uitsendings nou · ukusesha i-YouTube, amavidiyo esiteshi, amavidiyo athrendayo · ukukhangela i-YouTube, iividiyo zetshaneli, iividiyo ezithandwayo

**Hausa · Yorùbá · Igbo — Nigeria:** binciken YouTube · bidiyon tashar YouTube · bidiyo mafi kallo a YouTube · ìwádìí YouTube · àwọn fídíò ìkànnì YouTube · fídíò tí a wò jù lórí YouTube · nchọ YouTube · vidiyo ọwa YouTube · vidiyo a kacha ele na YouTube

### You don't fill in a form. You just ask.

This runs inside the **Claude or ChatGPT you already use**. Connect it once (below), then say what you want:

> **You** — Find me the last three months of home espresso machine reviews on YouTube, only videos over four minutes, with the channels' subscriber counts and whatever links they publish.
>
> **Your AI** — 47 videos across 21 channels. Top by views: *Breville Barista Express — 2 Years Later* (1.2M views, Seattle Coffee Gear, 412k subs). Nine channels put an email or their own site in the description. Used 1 of your 100 daily searches.

Or ask for one creator's whole output — **that costs no search quota at all**:

> **You** — Pull MKBHD's last 100 uploads with view counts.

### Say it in your own words

Any of these, typed into Claude or ChatGPT with Apify connected, runs this Actor:

- *Search YouTube for "home espresso machine review" — the 50 most viewed, with the channel and subscribers.*
- *New videos on "meal prep" in the US this year, about 10 minutes long, ranked by views.*
- *What is trending on YouTube in Brazil right now?* · *Trending gaming videos in Japan.*
- *Every video in this playlist, with views and dates.* · *This playlist as a spreadsheet.*
- *Who is streaming chess live right now?* · *Upcoming live streams about the election.*
- *This creator's last 50 uploads — what do they keep making?*
- *YouTube search API* · *YouTube Data API* · *YouTube views and subscribers* — the words don't matter.

When it finishes, your assistant offers the next step itself: transcripts or summaries of the videos, narrowing by date, country or length, or the creators behind them with contacts.

### Trending, playlists, live streams

Three more ways in, all through the same official API, all at $0.001 a video:

- **Trending by country.** *"What is trending on YouTube in Brazil this week?"* — YouTube's own most-popular chart for any country, up to 200 videos, narrowed to music, gaming, news, sports, tech, education or any other category if you like. No search quota spent.
- **A playlist.** *"Every video in this playlist, with views."* — paste the link with `list=` in it; every video comes back with its stats. No search quota spent.
- **Live streams.** *"Who is streaming chess right now?"* — the search phrases limited to streams live now, scheduled, or already ended. Leave the phrase empty for the top live streams overall.
- **Comments.** *"What do viewers say under this video?"* — the top or newest comments under each video returned, up to 500 a video, with author, likes, replies and date, on the row and in one COMMENTS.csv.

Trending videos · trending video · YouTube trending · YouTube trending videos · YouTube trending by country · trending on YouTube today · trending music videos · trending gaming videos · trending news videos · most popular YouTube videos by country · YouTube top charts · YouTube playlist · YouTube playlists · YouTube playlist videos · playlist videos · playlist scraper · playlist to CSV · playlist export · every video in a playlist · all videos of a playlist · playlist video list with views · YouTube live stream · YouTube live streams · live streams now · live stream scraper · live streams on a topic · who is live on YouTube · upcoming live streams · scheduled streams · ended live streams · YouTube live viewers · YouTube 热门视频 · 国家 热门 · 播放列表 视频 · 直播 · YouTube トレンド · 再生リスト · ライブ配信 · 유튜브 인기 급상승 · 재생목록 · 라이브 스트리밍 · YouTube Trends nach Land · Playlist Videos · Livestreams · tendances YouTube par pays · vidéos d'une playlist · directs en cours · tendencias de YouTube por país · videos de una lista de reproducción · directos en vivo · em alta no YouTube por país · vídeos de uma playlist · transmissões ao vivo · тренды YouTube по стране · видео плейлиста · прямые трансляции · YouTube trendleri ülkeye göre · oynatma listesi videoları · canlı yayınlar · tren YouTube per negara · video playlist · siaran langsung · YouTube ट्रेंडिंग देश के अनुसार · प्लेलिस्ट के वीडियो · लाइव स्ट्रीम · الرائج على يوتيوب حسب الدولة · فيديوهات قائمة تشغيل · بث مباشر

### In n8n, Make or Zapier — no code, no chat

The same app runs inside a workflow. Apify's own n8n node (search **Apify** in n8n Cloud's node panel, or install `@apify/n8n-nodes-apify` on a self-hosted instance) runs any Actor; Make and Zapier have the same Apify module.

1. **Run Actor** — Actor: `lexonia/youtube-search-api`; Custom input: the same JSON you would type in the form; Wait for finish: on.
2. **Get Dataset Items** — Dataset ID: `{{ $json.defaultDatasetId }}` from the step before.
3. Send the rows where they go: Google Sheets, Slack, Notion, your CRM.

Ready-made workflow to import: [`integrations/n8n/youtube-search.json`](https://github.com/Lexonia-AI-APIFY/audience-intel/blob/main/integrations/n8n/youtube-search.json) — a topic in, the most viewed videos out, every morning. Pair the Apify node with n8n's **AI Agent** node and the assistant fills the input from a sentence, exactly as Claude does.

### What you get back, per video

| | |
|---|---|
| **The video** | title, description, published date, length, thumbnail, tags, language |
| **How it did** | views, likes, comments — Google's own counts, not estimates |
| **The creator** | channel name, handle, subscribers, total views, total videos, country, join date |
| **The contact trail** | the channel's About text (where creators put a business email) and every link they published in the video or channel description |
| **Where it came from** | which of your phrases found it |

Field names deliberately match the most widely used YouTube Actors, so if you already have a pipeline you can swap this in and change nothing downstream.

### Your own key — 5 minutes, no card, yours permanently

1. **Switch the API on** → [console.cloud.google.com/apis/library/youtube.googleapis.com](https://console.cloud.google.com/apis/library/youtube.googleapis.com) → **Enable**. (Already have a Google Cloud project? Use it — YouTube's quota is its own allowance and won't affect anything else in there.)
2. **Create the key** → [console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials) → **Create credentials → API key**.
3. Paste it into **Your Google API key**. It is stored as a secret — never written to your results.

Want to see the output before doing that? Leave it empty and the Actor runs on a small shared quota — enough to see exactly what comes back, capped at 25 videos so it stays available to everyone.

### What your quota actually buys

| What you do | Costs |
|---|---|
| Search a phrase, 50 videos | 1 of your 100 daily searches |
| Every video from a channel | **nothing** — no search used |
| Details for 50 videos | 1 unit of 10,000 |
| Details for 50 channels | 1 unit of 10,000 |

So a typical research run — four phrases, 200 videos, full channel details — costs **4 of 100 searches and about 8 of 10,000 units**. Reading channels costs no search quota at all, so deep work on known creators is effectively unlimited.

Every run tells you exactly what it used.

### Connect it once — five minutes

1. **Free account** at [apify.com](https://apify.com) — comes with $5 of credit, no card.
2. **Claude** — Settings → Connectors → Add custom connector → `https://mcp.apify.com` → authorise.
   **ChatGPT** (paid plan) — Settings → Apps & Connectors → Advanced settings → switch on **Developer mode**, then **Create**: name `Apify`, URL `https://mcp.apify.com`, Authentication **OAuth**, then **Allow**. In each new chat press **+ → More → Apify**.
   **Cursor / Qwen / DeepSeek** — the same address. Qwen and DeepSeek run it through **Cherry Studio** or **Dify** inside China; any other MCP client takes the same connector.
3. Ask for what you want.

**Prefer a form?** It runs in the Apify Console too — press **Try for free**.

### What it costs

**$0.001 per video returned**, plus a $0.00005 fee when a run starts — five hundredths of a cent, and it is there because Apify waives the first five seconds of compute in exchange. Nothing else: no charge for channel details, and nothing for videos that turn out to be private or deleted.

The median YouTube Actor on this Store charges $0.002 per result, and they range up to $0.12. This one is half the median, because reading an official API carries no proxy bill to pass on.

100 videos = **$0.10**. The $5 of free credit on a new Apify account covers about 5,000 videos.

| | |
|---|---|
| Each video returned | **$0.001** |
| Each comment returned (when asked) | **$0.001** — free until 8 October 2026 |
| Listing a channel's videos | **$0.00001**, effectively free |
| Listing a playlist | **$0.00001**, effectively free |
| A country's trending chart | **$0.00001**, effectively free |
| A run that finds nothing to look up — it asks instead | **$0** |

### When it can't answer

- **"Quota used up"** — you have spent today's 100 searches. It resets at midnight Pacific. Channel and video lookups usually still work, since they don't use search quota. Google has a free extension form if you need more.
- **"The API is not switched on"** — the key is fine, but step 1 above hasn't been done for that project.
- **"Google rejected that key"** — usually a partial copy, or a key restriction that excludes the YouTube Data API.
- **A video is missing** — it is private, deleted, or blocked in the region you searched from. Google returns nothing for it rather than a guess, and neither do we.

### Limits worth knowing before you start

- **Search reaches about 500 videos per phrase.** That is YouTube's own limit, not ours. To go deeper, search narrower phrases or read channels directly.
- **Transcripts and subtitles are not here.** Different job, different Actor — Video Transcript & Translation reads them. Comments are here: ask for them per video.
- **Subscriber counts are rounded by Google** above 1,000 — that is how the API publishes them for everyone.

***

This Actor uses YouTube API Services. By using it you agree to the [YouTube Terms of Service](https://www.youtube.com/t/terms); Google's handling of the data is described in the [Google Privacy Policy](http://www.google.com/policies/privacy). Lexonia's privacy policy for this and our other tools: [lexoniagroup.com/privacy](https://lexoniagroup.com/privacy).

Made by [Lexonia](https://apify.com/lexonia). Also from us: **Lexonia: Audience Intel** (describe an audience, get the creators who reach it, with contacts) and **Lexonia Video Lens** (any video → transcript, translation and summary, including Bilibili and Douyin).

# Actor input Schema

## `searchQueries` (type: `array`):

What to search for, in any language — the same words you would type into YouTube. Each phrase is searched separately and costs one of your 100 free daily searches per 50 videos. Good: "home espresso machine review", "意式咖啡机 评测". Too vague to be useful: "coffee". Leave empty if you are only fetching specific channels or videos below. Assistants: the topic in the user's words; ask for country, period and length only if they matter to the job. Before running, offer the comments under the videos once — "want the comments under them too? 50 a video, $0.001 each" — and set commentsPerVideo from their answer; never assume either way. Assistants: ONLY what the person said. Never take a place, site, link or topic from the examples on this page or from an earlier conversation; if the person did not give it, leave this empty and the app asks — an invented value runs and bills them.

## `channelUrls` (type: `array`):

Paste channel links or handles to pull a creator's own uploads. This costs NO search quota at all, so it is the cheap way to read a channel in depth. Accepts any form: https://www.youtube.com/@mkbhd, @mkbhd, or a channel ID like UCBJycsmduvYEL83R\_U4JriQ. Assistants: a channel or @handle for "this creator's videos"; costs no search quota. Assistants: ONLY what the person said. Never take a place, site, link or topic from the examples on this page or from an earlier conversation; if the person did not give it, leave this empty and the app asks — an invented value runs and bills them.

## `videoUrls` (type: `array`):

Full details for videos you already have links to. Costs one unit per 50 videos and no search quota. Accepts watch links, youtu.be links, Shorts links or bare video IDs. Assistants: ONLY what the person said. Never take a place, site, link or topic from the examples on this page or from an earlier conversation; if the person did not give it, leave this empty and the app asks — an invented value runs and bills them.

## `playlistUrls` (type: `array`):

Paste playlist links (the ones with "list=" in the address) or bare playlist ids. Every video in the playlist comes back with its stats. Costs one unit per 50 videos and NO search quota. Good: "https://www.youtube.com/playlist?list=PL…". Not a playlist: a channel link — put that in "channelUrls" instead. Assistants: any link with list= in it; costs no search quota. Assistants: ONLY what the person said. Never take a place, site, link or topic from the examples on this page or from an earlier conversation; if the person did not give it, leave this empty and the app asks — an invented value runs and bills them.

## `trendingRegions` (type: `array`):

Two-letter country codes — YouTube's own trending chart for each, up to 200 videos per country, optionally one category below. Costs one unit per 50 videos and NO search quota. Good: "US", "BR", "JP", "DE". Not this: a city or a language — trending is per country. Assistants: for "what is trending in <country>": the two-letter code; costs no search quota.

## `trendingCategory` (type: `string`):

Narrow the trending chart to one of YouTube's categories. "Any" is the whole chart. Only used together with "trendingRegions".

## `maxResults` (type: `integer`):

Upper limit per phrase and per channel. Every 50 videos from a search costs one of your 100 daily searches; channel videos cost none. Good starting point: 50. Raise it when you are reading one channel deeply, lower it when you are sampling many phrases. Assistants: size it to the ask — "find me X" or a named video means 5; "a few" means 10; ask "how many?" only above 50. Never leave 50 for a person looking for one video (25 Sep: a one-video ask returned 50 rows).

## `apiKey` (type: `string`):

This Actor reads Google's official YouTube Data API rather than scraping pages, so it needs a key of your own — free, about five minutes, no card. (1) Switch the API on at console.cloud.google.com/apis/library/youtube.googleapis.com. (2) Create a key at console.cloud.google.com/apis/credentials. (3) Paste it here. Google then gives your project 100 searches and 10,000 other units every day at no cost. Leave this empty to try the Actor on a small shared trial quota first.

## `order` (type: `string`):

How YouTube should rank what it returns. 'relevance' is YouTube's own best match and is right for most work. Use 'date' to see what is being published now, 'viewCount' to find what already won, 'rating' for the best received. Assistants: relevance when the person says "find", names a specific video or a person plus a title ("Mark Knopfler, the best guitar solo") — most-viewed would bury the exact video under the artist's hits; viewCount only when they say "most viewed", "popular" or "top"; date for "newest" or "this week".

## `publishedAfter` (type: `string`):

Cuts off older videos. Use it to see a trend rather than an archive — for example the last 90 days. Format: 2026-06-01T00:00:00Z. Leave empty for no limit.

## `publishedBefore` (type: `string`):

The other end of a date window, same format: 2026-09-01T00:00:00Z. Leave empty for no limit.

## `regionCode` (type: `string`):

A two-letter country code that makes YouTube rank results the way it would for someone there — US, GB, DE, UA, JP. Worth setting when the audience you care about is in one country. Leave empty to search without a country bias.

## `relevanceLanguage` (type: `string`):

A two-letter language code — en, uk, de, zh, ja. Nudges YouTube towards that language without hiding everything else. Leave empty for no preference.

## `videoDuration` (type: `string`):

Filter by rough length. 'short' is under 4 minutes, 'medium' 4–20, 'long' over 20. Use 'long' for interviews, reviews and documentaries; 'short' mostly returns Shorts.

## `liveStreams` (type: `string`):

Applies to the search phrases: only streams that are live right now, scheduled (upcoming), or already ended (completed). Leave the phrases empty to get the top streams of that kind. Each page still costs one search. Good: "live" with the phrase "chess". Not this: expecting a recording — a live stream that has ended is "completed". Assistants: for "who is streaming X right now": set live, keep the topic in searchQueries; leave the topic empty for the top streams overall.

## `excludeShorts` (type: `boolean`):

ON drops every video of 60 seconds or less after the numbers come back. Useful when you want real videos rather than clips — Shorts skew view counts and rarely carry a contact in the description.

## `commentsPerVideo` (type: `integer`):

How many comments to read under each video returned: 0 (default) reads none. Up to 500 a video, $0.001 each, on the row and in one COMMENTS.csv. A video with comments switched off says so and costs nothing. Assistants: offer it once before every search or channel run, with the price, and set it from the answer; when they ask what viewers say, think or complain about, it is a yes. 50 a video is a good first read. Good: 50. Bad: 500 on 200 videos when they asked for "a feel for the comments".

## `commentOrder` (type: `string`):

Top = the comments YouTube ranks highest (most liked and replied). Newest = the latest. Assistants: "what do people think" means top; "what are they saying now" or "after the update" means newest.

## `includeChannelDetails` (type: `boolean`):

ON (default) adds subscriber count, total views, country, and the channel description — which is where creators usually publish a business email or their own site. Costs one unit per 50 channels and almost never worth switching off.

## Actor input object example

```json
{
  "searchQueries": [
    "home espresso machine review",
    "best espresso grinder"
  ],
  "channelUrls": [
    "https://www.youtube.com/@mkbhd"
  ],
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "playlistUrls": [
    "https://www.youtube.com/playlist?list=PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI"
  ],
  "trendingRegions": [
    "US",
    "BR"
  ],
  "trendingCategory": "any",
  "maxResults": 50,
  "order": "relevance",
  "publishedAfter": "2026-06-01T00:00:00Z",
  "regionCode": "US",
  "relevanceLanguage": "en",
  "videoDuration": "any",
  "liveStreams": "",
  "excludeShorts": false,
  "commentsPerVideo": 0,
  "commentOrder": "top",
  "includeChannelDetails": true
}
```

# Actor output Schema

## `videos` (type: `string`):

Every video found, with views, likes, comments, length, publish date, and the channel behind it: subscribers, total views, country, About text and published links. Videos that turned out to be private, deleted or region-blocked are absent rather than guessed at.

## `creators` (type: `string`):

The same run seen one creator at a time — handle, subscribers, country, About text and every link they published. Use this view when the job is finding who to contact rather than what was posted.

## `runSummary` (type: `string`):

How many videos came back, how many Shorts were excluded, and what the run spent of Google's free daily allowance (100 searches and 10,000 units per project).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "home espresso machine review"
    ],
    "commentsPerVideo": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("lexonia/youtube-search-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["home espresso machine review"],
    "commentsPerVideo": 0,
}

# Run the Actor and wait for it to finish
run = client.actor("lexonia/youtube-search-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "home espresso machine review"
  ],
  "commentsPerVideo": 0
}' |
apify call lexonia/youtube-search-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lexonia/youtube-search-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/LRyCZhpETxWGWD5Mp/builds/xo702H5QoGV0YyB2b/openapi.json