# YouTube Niche Listing (`truefetch/youtube-niche-listing`) Actor Search YouTube by keyword — video title, channel name, contact email, subscriber count, view count, and 24 fields. Surface creator emails for outreach. $8.50 per 1,000. - **URL**: https://apify.com/truefetch/youtube-niche-listing.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Social media, Videos, News - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $4.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![YouTube Niche Listing](https://img.shields.io/badge/YouTube%20Niche%20Scraper-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) [![YouTube Channel Finder](https://img.shields.io/badge/YouTube%20Channel%20Finder-1F8A70?style=for-the-badge)](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) [![$0.0085 per Video](https://img.shields.io/badge/$0.0085%20per%20Video-2E8B57?style=for-the-badge)](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) [![Channels, Emails & Subscribers](https://img.shields.io/badge/Channels%20%7C%20Emails%20%7C%20Subscribers-555555?style=for-the-badge)](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## YouTube Niche Listing — YouTube Channel Finder: Channels, Emails & Subscribers **Search YouTube by keyword and extract video and channel profile data — with subscriber count, contact emails, channel description, channel links, video metrics, and tags — in clean structured JSON.** > **TL;DR (40-word answer):** YouTube Niche Listing is a no-login Apify Actor that searches YouTube by keyword at **$0.0085 per video result**, returning video metrics and full channel profile data including contact emails and subscriber count. Sort by relevance, view count, rating, or upload date. Last verified 2026-05-02. > **What it is NOT:** YouTube Niche Listing is _not_ a video downloader (see YouTube Video Downloader), _not_ a comment scraper, and _not_ a real-time live stream tracker — it searches and returns video + channel profile data. > **YouTube Niche Listing is an Apify Actor that searches YouTube for videos matching a keyword and returns full channel profiles including subscriber count, contact emails, and channel links.** Maintained by TrueFetch on the Apify Store. --- ### 🏷️ Why choose YouTube Niche Listing **YouTube Niche Listing is best for** influencer marketers, brand researchers, and AI agents who need to discover YouTube channels and contact creators in a specific niche. - **📧 Contact emails** — extracts emails from channel descriptions automatically. - **📊 Full video + channel data** — video metrics (views, likes, comments) AND channel metrics (subscribers, video count, tags, links) in one result. - **⚡ Pay-per-result pricing** — **$0.0085 per video result**. Free Apify plan includes $5/month credits ≈ 588 free results. - **🔃 Sort options** — sort results by `relevance`, `view_count`, `rating`, or `upload_date`. --- ### 🚀 Quick Start — run in 3 steps #### Run in Apify Console 1. **Open the Actor** — go to [YouTube Niche Listing on Apify](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** — provide a keyword, max results, and sort order. 3. **Click Start** — the Actor returns video + channel data in the dataset. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~youtube-niche-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "keyword": "AI tools for creators", "max_results": 50, "sort_by": "view_count" }' ```` #### Run via MCP (for AI agents) YouTube Niche Listing is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/youtube-niche-scraper` and pass the same JSON input as above. *** ### ⚙️ Input parameters | Parameter | Type | Required | Default | Description | Example | | ------------- | ------ | :------: | ------- | ------------------------------------------------------------------ | ------------------------- | | `keyword` | string | ✅ | — | YouTube search keyword. | `"AI tools for creators"` | | `max_results` | number | ✅ | — | Maximum number of video results to return (must be ≥ 1). | `50` | | `sort_by` | string | ✅ | — | Sort order: `relevance`, `view_count`, `rating`, or `upload_date`. | `"view_count"` | ```json { "keyword": "AI tools for creators", "max_results": 50, "sort_by": "view_count" } ``` *** ### 📦 Output dataset Each run writes one record per video to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. #### Video fields | Field | Type | Always present? | Description | Example | | ------------------------ | ------ | :-------------: | --------------------------- | ----------------------------------- | | `video_url` | string | optional | Full YouTube video URL. | `https://www.youtube.com/watch?v=…` | | `video_id` | string | optional | YouTube video ID. | `dQw4w9WgXcQ` | | `video_title` | string | optional | Video title. | `10 AI Tools Every Creator Needs` | | `video_description` | string | optional | Video description. | `In this video...` | | `video_duration_seconds` | number | optional | Duration in seconds. | `612` | | `video_published_at` | string | optional | ISO 8601 publish timestamp. | `2024-09-15T14:00:00+00:00` | | `video_view_count` | number | optional | View count. | `1200000` | | `video_like_count` | number | optional | Like count. | `45000` | | `video_comment_count` | number | optional | Comment count. | `3200` | | `video_categories` | array | optional | YouTube categories. | `["Science & Technology"]` | | `video_tags` | array | optional | Video tags. | `["AI", "tools", "creators"]` | #### Channel fields | Field | Type | Always present? | Description | Example | | --------------------- | ------- | :-------------: | ------------------------------------------ | --------------------------------------- | | `channel_name` | string | optional | Channel name. | `Tech With Tim` | | `channel_handle` | string | optional | Channel @handle. | `@TechWithTim` | | `channel_url` | string | optional | Channel URL. | `https://www.youtube.com/@TechWithTim` | | `channel_description` | string | optional | Channel description. | `Programming tutorials and AI content.` | | `channel_tags` | array | optional | Channel tags. | `["python", "AI"]` | | `channel_links` | array | optional | External links from channel profile. | `[{"url": "https://..."}]` | | `contact_emails` | array | optional | Emails extracted from channel description. | `["hello@techwithim.com"]` | | `channel_avatar_url` | string | optional | Channel avatar URL. | `https://yt3.ggpht.com/...` | | `channel_banner_url` | string | optional | Channel banner URL. | `https://yt3.ggpht.com/...` | | `channel_is_verified` | boolean | optional | Whether the channel is YouTube-verified. | `true` | | `subscriber_count` | number | optional | Subscriber count. | `850000` | | `channel_view_count` | number | optional | Total channel view count. | `50000000` | | `channel_video_count` | number | optional | Total videos published. | `320` | #### Sample output ```json { "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "video_title": "10 AI Tools Every Creator Needs", "video_view_count": 1200000, "channel_name": "Tech With Tim", "channel_handle": "@TechWithTim", "subscriber_count": 850000, "contact_emails": ["hello@techwithim.com"] } ``` *** ### 💡 Use cases #### For influencer marketers finding YouTube creators in a niche - **Problem:** a brand wants to find and contact 100 YouTube creators in the "sustainable fashion" niche. - **How YouTube Niche Listing solves it:** search for `sustainable fashion` sorted by `view_count`, set `max_results: 100`. - **Outcome:** 100 channels with contact emails for **$0.85**. #### For AI researchers benchmarking YouTube content in a topic - **Problem:** a researcher wants to analyze video engagement metrics for AI tutorial content. - **How YouTube Niche Listing solves it:** search `AI tutorial` sorted by `rating`, set `max_results: 200`. - **Outcome:** 200 video/channel records at **$1.70**. #### For AI agents discovering YouTube creators - **Problem:** an LLM agent needs YouTube channel data to recommend creators to follow. - **How YouTube Niche Listing solves it:** call via [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) with a niche keyword. - **Outcome:** structured channel data grounded in real YouTube search results. *** ### 💰 Pricing, limits, and performance | Fact | Value | | --------------------------- | ------------------------------------------------------ | | Pricing model | Pay-per-result (event: `result`) | | Per-video-result price | **$0.0085 per video = $8.50 per 1,000** | | Min results per run | 1 | | Free-tier monthly allowance | $5 Apify credits ≈ **~588 free video results / month** | | Output fields per video | **24** | | Login / cookies required | **No** — works without a YouTube account | | Export formats | JSON, JSONL, CSV, Excel, XML, RSS, dataset API | *** ### ⚖️ Compared with alternatives | Capability | **YouTube Niche Listing** | Manual browsing | YouTube Data API v3 | | ------------------------------------------------- | :-----------------------: | :-------------: | :------------------: | | Keyword search + full channel profiles | ✅ | ❌ | partial | | Contact email extraction from channel description | ✅ | manual | ❌ | | Pay-per-result pricing | **$0.0085/result** | N/A | quota-based | | Setup time to first result | **< 60 seconds** | minutes | API key setup needed | **Verdict.** YouTube Niche Listing is ideal for marketers and researchers who need channel profiles AND contact emails from YouTube searches without managing API quotas. *** ### ⚠️ Common mistakes to avoid 1. **Missing `keyword` field.** Required — provide a non-empty search keyword. 2. **Missing `max_results` field.** Required — provide an integer ≥ 1. 3. **Missing `sort_by` field.** Required — must be one of: `relevance`, `view_count`, `rating`, `upload_date`. 4. **Invalid `sort_by` value.** Use exactly one of the four allowed strings. *** ### 🛠️ Troubleshooting | Problem | Likely cause | Fix | | --------------------------- | ---------------------------------- | ----------------------------------------------------------- | | `Missing keyword` | `keyword` key not in input. | Add `"keyword": "your niche"` to input. | | `Keyword cannot be empty` | Empty string provided for keyword. | Provide a non-empty search term. | | `Missing max results` | `max_results` key not in input. | Add `"max_results": 50` to input. | | `Missing sort by` | `sort_by` key not in input. | Add `"sort_by": "relevance"` to input. | | `Sort by must be one of...` | Invalid sort value. | Use: `relevance`, `view_count`, `rating`, or `upload_date`. | | Empty `contact_emails` | Channel description has no email. | Normal — not all channels publish contact emails publicly. | *** ### ❓ FAQ #### What data does YouTube Niche Listing return? Video data (URL, title, description, duration, views, likes, comments, tags) plus full channel data (name, handle, URL, description, subscriber count, total views, video count, contact emails, channel links, avatar, banner, verification). #### How much does YouTube Niche Listing cost? **$0.0085 per video result**. The Apify Free plan includes $5/month credits ≈ ~588 free results. #### Does YouTube Niche Listing require a YouTube API key? No — the Actor works without any YouTube API credentials or login. #### Can I schedule YouTube Niche Listing to run automatically? Yes. Use Apify [Schedules](https://docs.apify.com/platform/schedules?fpr=aiagentapi) to monitor a niche on a recurring basis and push new results via [Webhooks](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi). *** ### 🔌 Integrations YouTube Niche Listing plugs straight into the Apify ecosystem: - **Schedules** — run weekly to track new videos and channels in your niche ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** — POST results to your CRM or outreach tool on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** — `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** — call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** — Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### 🧱 Sister Actors from TrueFetch #### Jobs - [Best Job Listing](https://apify.com/truefetch/best-job-listing?fpr=aiagentapi) - [Glassdoor Job Listing](https://apify.com/truefetch/glassdoor-job-listing?fpr=aiagentapi) - [Glints Company Profile](https://apify.com/truefetch/glints-company-profile?fpr=aiagentapi) - [Glints Job Listing](https://apify.com/truefetch/glints-job-listing?fpr=aiagentapi) - [Indeed Job Listing](https://apify.com/truefetch/indeed-job-listing?fpr=aiagentapi) - [JobStreet Company Profile](https://apify.com/truefetch/jobstreet-company-profile?fpr=aiagentapi) - [JobStreet Job Listing](https://apify.com/truefetch/jobstreet-job-listing?fpr=aiagentapi) - [LinkedIn Job Listing](https://apify.com/truefetch/linkedin-job-listing?fpr=aiagentapi) - [StepStone Company Profile](https://apify.com/truefetch/stepstone-company-profile?fpr=aiagentapi) - [StepStone Job Listing](https://apify.com/truefetch/stepstone-job-listing?fpr=aiagentapi) #### Shopping & Deals - [Amazon Product Listing](https://apify.com/truefetch/amazon-product-listing?fpr=aiagentapi) - [Amazon Store Profile](https://apify.com/truefetch/amazon-store-profile?fpr=aiagentapi) - [Argos Product Listing](https://apify.com/truefetch/argos-product-listing?fpr=aiagentapi) - [ASOS Product Listing](https://apify.com/truefetch/asos-product-listing?fpr=aiagentapi) - [eBay Listing](https://apify.com/truefetch/ebay-listing?fpr=aiagentapi) - [eBay Seller Profile](https://apify.com/truefetch/ebay-seller-profile?fpr=aiagentapi) - [Flipkart Product Listing](https://apify.com/truefetch/flipkart-product-listing?fpr=aiagentapi) - [John Lewis Product Listing](https://apify.com/truefetch/john-lewis-product-listing?fpr=aiagentapi) - [Lidl Product Listing](https://apify.com/truefetch/lidl-product-listing?fpr=aiagentapi) - [Magalu Product Listing](https://apify.com/truefetch/magalu-product-listing?fpr=aiagentapi) - [MediaMarkt Product Listing](https://apify.com/truefetch/mediamarkt-product-listing?fpr=aiagentapi) - [Mercado Livre Product Listing](https://apify.com/truefetch/mercado-livre-product-listing?fpr=aiagentapi) - [Nykaa Product Listing](https://apify.com/truefetch/nykaa-product-listing?fpr=aiagentapi) - [OTTO Product Listing](https://apify.com/truefetch/otto-product-listing?fpr=aiagentapi) - [Target Product Listing](https://apify.com/truefetch/target-product-listing?fpr=aiagentapi) - [TradeIndia Product Listing](https://apify.com/truefetch/tradeindia-product-listing?fpr=aiagentapi) - [TradeIndia Supplier Profile](https://apify.com/truefetch/tradeindia-supplier-profile?fpr=aiagentapi) - [Walmart Product Listing](https://apify.com/truefetch/walmart-product-listing?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Listing](https://apify.com/truefetch/autotrader-car-listing?fpr=aiagentapi) - [AutoTrader Dealer Profile](https://apify.com/truefetch/autotrader-dealer-profile?fpr=aiagentapi) - [Cars.com Car Listing](https://apify.com/truefetch/carscom-car-listing?fpr=aiagentapi) - [Cars.com Dealer Profile](https://apify.com/truefetch/carscom-dealer-profile?fpr=aiagentapi) - [Webmotors Car Listing](https://apify.com/truefetch/webmotors-car-listing?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Profile](https://apify.com/truefetch/magicbricks-builder-profile?fpr=aiagentapi) - [MagicBricks Property Listing](https://apify.com/truefetch/magicbricks-property-listing?fpr=aiagentapi) - [US Property Listing](https://apify.com/truefetch/us-property-listing?fpr=aiagentapi) - [Zillow Property Listing](https://apify.com/truefetch/zillow-property-listing?fpr=aiagentapi) #### Local Business & Food - [BBB Business Profile](https://apify.com/truefetch/bbb-business-profile?fpr=aiagentapi) - [BBB Review](https://apify.com/truefetch/bbb-review?fpr=aiagentapi) - [Google Maps Business Listing](https://apify.com/truefetch/google-maps-business-listing?fpr=aiagentapi) - [Reclame Aqui Company Profile](https://apify.com/truefetch/reclame-aqui-company-profile?fpr=aiagentapi) - [Zomato Restaurant Menu](https://apify.com/truefetch/zomato-restaurant-menu?fpr=aiagentapi) - [Zomato Restaurant Listing](https://apify.com/truefetch/zomato-restaurant-listing?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing](https://apify.com/truefetch/kleinanzeigen-listing?fpr=aiagentapi) - [Kleinanzeigen Seller Profile](https://apify.com/truefetch/kleinanzeigen-seller-profile?fpr=aiagentapi) - [OLX Listing](https://apify.com/truefetch/olx-listing?fpr=aiagentapi) - [OLX Seller Profile](https://apify.com/truefetch/olx-seller-profile?fpr=aiagentapi) #### Social Media - [LinkedIn Company Profile](https://apify.com/truefetch/linkedin-company-profile?fpr=aiagentapi) - [LinkedIn Person Profile](https://apify.com/truefetch/linkedin-person-profile?fpr=aiagentapi) - [Instagram Explore Post Post](https://apify.com/truefetch/instagram-explore-post?fpr=aiagentapi) - [Instagram Profile Post](https://apify.com/truefetch/instagram-profile-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community Member](https://apify.com/truefetch/reddit-community-member?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram Video Transcript](https://apify.com/truefetch/instagram-video-transcript?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Profile Video](https://apify.com/truefetch/tiktok-profile-video?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Listing](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article](https://apify.com/truefetch/medium-article?fpr=aiagentapi) - [Medium Writer Profile](https://apify.com/truefetch/medium-writer-profile?fpr=aiagentapi) *** ### 📞 Support, changelog, last updated #### Support - 💬 **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - 📧 **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - 📖 **Actor page & docs:** [apify.com/truefetch/youtube-niche-listing](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** manually searching YouTube for niche creators and extracting their contact info takes days. YouTube Niche Listing returns hundreds of channels with emails for under $2. → [Try it free with $5 of Apify credits](https://apify.com/truefetch/youtube-niche-listing?fpr=aiagentapi). #### Changelog - **2026-05-02** — README rewritten for SEO + GEO; documented all inputs, output structure, pricing, troubleshooting, and FAQ. - **2026-03** — Added `sort_by` sort options (relevance, view\_count, rating, upload\_date). - **2026-02** — Initial release: YouTube niche keyword search Actor. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/truefetch/youtube-niche-listing#software", "name": "YouTube Niche Listing", "description": "Apify Actor that searches YouTube by keyword at $0.0085 per result, returning full video metrics and channel profiles including subscriber count and contact emails.", "applicationCategory": "BusinessApplication", "operatingSystem": "Web, Cloud", "url": "https://apify.com/truefetch/youtube-niche-listing", "offers": { "@type": "Offer", "price": "0.0085", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What data does YouTube Niche Listing return?", "acceptedAnswer": { "@type": "Answer", "text": "Video data (URL, title, description, duration, views, likes, comments, tags) plus full channel data (name, handle, URL, description, subscriber count, total views, video count, contact emails, channel links, avatar, banner, verification)." } }, { "@type": "Question", "name": "How much does YouTube Niche Listing cost?", "acceptedAnswer": { "@type": "Answer", "text": "$0.0085 per video result. The Apify Free plan includes $5/month credits — enough for ~588 free results." } }, { "@type": "Question", "name": "Does YouTube Niche Listing require a YouTube API key?", "acceptedAnswer": { "@type": "Answer", "text": "No — the Actor works without any YouTube API credentials or login." } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com" }, { "@type": "ListItem", "position": 2, "name": "Social Media", "item": "https://apify.com/store?category=SOCIAL_MEDIA" }, { "@type": "ListItem", "position": 3, "name": "YouTube Niche Listing", "item": "https://apify.com/truefetch/youtube-niche-listing" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) · 💬 [Telegram Group](https://t.me/Apify_Actor) · 📧 [Support](https://t.me/AiAgentApi) # Actor input Schema ## `keyword` (type: `string`): Search YouTube videos by keyword. Each result includes the matched video plus the related channel profile. ## `sort_by` (type: `string`): Choose one YouTube search sort mode. ## `max_results` (type: `integer`): Maximum number of matched videos to return from search results. ## Actor input object example ```json { "keyword": "marketing", "sort_by": "relevance", "max_results": 1 } ``` # Actor output Schema ## `results` (type: `string`): Keyword-matched YouTube video results with full channel details, contact info, and social links # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keyword": "marketing", "sort_by": "relevance", "max_results": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/youtube-niche-listing").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keyword": "marketing", "sort_by": "relevance", "max_results": 1, } # Run the Actor and wait for it to finish run = client.actor("truefetch/youtube-niche-listing").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "marketing", "sort_by": "relevance", "max_results": 1 }' | apify call truefetch/youtube-niche-listing --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/youtube-niche-listing", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Niche Listing", "description": "Search YouTube by keyword — video title, channel name, contact email, subscriber count, view count, and 24 fields. Surface creator emails for outreach. $8.50 per 1,000.", "version": "1.0", "x-build-id": "1YWxl2R8gXferiBTr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~youtube-niche-listing/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-youtube-niche-listing", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/truefetch~youtube-niche-listing/runs": { "post": { "operationId": "runs-sync-truefetch-youtube-niche-listing", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/truefetch~youtube-niche-listing/run-sync": { "post": { "operationId": "run-sync-truefetch-youtube-niche-listing", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "max_results", "sort_by", "keyword" ], "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Search YouTube videos by keyword. Each result includes the matched video plus the related channel profile." }, "sort_by": { "title": "Sort By", "enum": [ "relevance", "view_count", "rating", "upload_date" ], "type": "string", "description": "Choose one YouTube search sort mode." }, "max_results": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of matched videos to return from search results." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```