> ## Documentation Index > Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt > Use this file to discover all available pages before exploring further. # YouTube search > Search YouTube videos, shorts and streams by keyword with YouTube's filters (upload date, type, length, features): title, description, views, likes, comments, duration, hashtags, subtitles and the channel's subscribers. 5 point per returned record. ## OpenAPI ````yaml /openapi.json post /functions/v1/run-youtube-search openapi: 3.0.0 info: title: NeuralVerge API version: 1.0.0 description: >- NeuralVerge API for AI research, search, extraction, and structured data source execution. servers: - url: https://api.neuralverge.ai description: NeuralVerge API security: - BearerAuth: [] tags: - name: AI Research description: Multi-step research workflows and the sessions they run in. - name: AI Extract description: Schema-driven extraction workflows. - name: Search description: Fast, synchronous web search with no session or polling. - name: Company intelligence description: Company profile lookups from company databases. - name: E-commerce & Marketplaces description: >- Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress, and Alibaba. - name: Enrichment description: Email and phone enrichment, validation, and discovery. - name: Product reviews description: >- Software and business reviews from Capterra, Gartner Peer Insights, and Trustpilot. - name: Social media description: LinkedIn profile, company, and people lookups. - name: Company Registries description: Company Registries data sources. - name: Startup & Funding Data description: Startup & Funding Data data sources. - name: Maps & Local Businesses description: Maps & Local Businesses data sources. paths: /functions/v1/run-youtube-search: post: tags: - Social media summary: YouTube search description: >- Search YouTube videos, shorts and streams by keyword with YouTube's filters (upload date, type, length, features): title, description, views, likes, comments, duration, hashtags, subtitles and the channel's subscribers. 5 point per returned record. requestBody: required: true content: application/json: schema: type: object properties: query: description: Search term. e.g. web scraping tutorial type: string max_results: description: Videos (up to 1000) type: integer minimum: 0 maximum: 1000 default: 10 max_results_shorts: description: Shorts (up to 1000) type: integer minimum: 0 maximum: 1000 default: 0 max_results_streams: description: Streams (up to 1000) type: integer minimum: 0 maximum: 1000 default: 0 sorting_order: description: >- Sorting order. Options: rating = Rating, date = Upload date, views = View count type: string enum: - rating - date - views date_filter: description: >- Upload date. Options: hour = Last hour, today = Today, week = This week, month = This month, year = This year type: string enum: - hour - today - week - month - year video_type: description: 'Type. Options: video = Video, movie = Film' type: string enum: - video - movie length_filter: description: >- Length. Options: under4 = Under 4 minutes, between420 = 4-20 minutes, plus20 = Over 20 minutes type: string enum: - under4 - between420 - plus20 features: description: Features type: array items: type: string enum: - hd - subtitles - creative_commons - 3d - live - purchased - 4k - '360' - location - hdr - vr180 download_subtitles: description: Download subtitles (when present on the video) type: boolean subtitles_language: description: >- Subtitle language. Options: any = Any, de = German, es = Spanish, fr = French, it = Italian, ja = Japanese, ko = Korean, nl = Dutch, pt = Portuguese, ru = Russian type: string enum: - any - de - es - fr - it - ja - ko - nl - pt - ru subtitles_format: description: >- Subtitle format. Options: vtt = WEBVTT, xml = XML, plaintext = Plain text type: string enum: - vtt - xml - plaintext required: - query example: query: web scraping tutorial max_results: 2 responses: '200': description: Run completed. content: application/json: example: session_id: 11111111-1111-1111-1111-111111111111 kind: youtube_search query: web scraping tutorial sorting_order: '' date_filter: '' video_type: '' length_filter: '' features: [] max_results: 2 max_results_shorts: 0 max_results_streams: 0 download_subtitles: false subtitles_language: en subtitles_format: srt partial: false human: |- # YouTube search - **Search term:** web scraping tutorial - **Limits:** 2 videos, 0 shorts, 0 streams - **Records returned:** 2 - **CodeHead:** @codehead01 · 104K subscribers - **Tinkernut:** @Tinkernut · 626K subscribers machine: total_items: 2 items: - id: hHQlcnubuFI url: https://www.youtube.com/watch?v=hHQlcnubuFI type: video title: Learn Web Scraping in 5 Minutes (NO PRIOR KNOWLEDGE) translated_title: null description: >- 👉 Get Rid of IP Blocking for just $1 with DataImpulse: https://dataimpulse.com/?utm_source=y... 👉Get 40% OFF CodeCrafters: https://app.codecrafters.io/join?via=... 👉Git gud at coding with Scrimba http description_links: - text: https://dataimpulse.com/?utm_source=y... url: >- https://dataimpulse.com/?utm_source=youtube&utm_medium=video&utm_campaign= - text: https://app.codecrafters.io/join?via=... url: https://app.codecrafters.io/join?via=codehead-01 - text: https://scrimba.com/?via=codehead url: https://scrimba.com/?via=codehead hashtags: - '#webdevelopment' - '#programming' - '#coding' date: '2026-03-05T15:01:30.000Z' duration: '00:04:53' view_count: 180754 likes: 6700 comments_count: 96 comments_turned_off: false thumbnail_url: https://i.ytimg.com/vi/hHQlcnubuFI/maxresdefault.jpg location: null is_monetized: null is_members_only: false is_paid_content: true is_age_restricted: null collaborators: [] subtitles: [] channel: id: UCFVteOob_YXJHPaGTqlDV2Q name: CodeHead username: codehead01 url: https://www.youtube.com/@codehead01 subscribers: 104000 total_videos: null total_views: null description: null description_links: [] location: null joined_date: null is_verified: null avatar_url: null banner_url: null order: 1 found_on_url: >- https://www.youtube.com/results?search_query=web+scraping+tutorial&sp=EgIQAQ%3D%3D source: web scraping tutorial - id: QhD015WUMxE url: https://www.youtube.com/watch?v=QhD015WUMxE type: video title: >- Beginners Guide To Web Scraping with Python - All You Need To Know translated_title: null description: >- The web is full of data. Lots and lots of data. Data prime for scraping. But manually going to a website and copying and pasting the data into a spreadsheet or database is tedious and a time consuming description_links: - text: https://github.com/gigafide/basic_pyt... url: https://github.com/gigafide/basic_python_scraping/ - text: https://www.python.org/downloads/ url: https://www.python.org/downloads/ - text: https://www.crummy.com/software/Beaut... url: >- https://www.crummy.com/software/BeautifulSoup/bs4/doc/ hashtags: [] date: '2021-11-27T13:00:24.000Z' duration: '00:07:36' view_count: 488179 likes: 13000 comments_count: 232 comments_turned_off: false thumbnail_url: https://i.ytimg.com/vi/QhD015WUMxE/maxresdefault.jpg location: null is_monetized: null is_members_only: false is_paid_content: false is_age_restricted: null collaborators: [] subtitles: [] channel: id: UCZDA1kA3y3EIg25BpcHSpwQ name: Tinkernut username: Tinkernut url: https://www.youtube.com/@Tinkernut subscribers: 626000 total_videos: null total_views: null description: null description_links: [] location: null joined_date: null is_verified: null avatar_url: null banner_url: null order: 0 found_on_url: >- https://www.youtube.com/results?search_query=web+scraping+tutorial&sp=EgIQAQ%3D%3D source: web scraping tutorial errors: [] total_points: 10 schema: type: object properties: session_id: type: string description: Session identifier for this run. kind: type: string description: Data source identifier for this endpoint. query: type: string sorting_order: type: string date_filter: type: string video_type: type: string length_filter: type: string features: type: array items: {} max_results: type: integer max_results_shorts: type: integer max_results_streams: type: integer download_subtitles: type: boolean subtitles_language: type: string subtitles_format: type: string partial: type: boolean description: >- True when the scrape stopped early and returned the records collected so far. human: type: string description: Markdown summary of the result, for display. machine: type: object properties: total_items: type: integer items: type: array items: type: object properties: id: type: string url: type: string type: type: string title: type: string translated_title: {} description: type: string description_links: type: array items: type: object properties: text: type: string url: type: string hashtags: type: array items: type: string nullable: true date: type: string duration: type: string view_count: type: integer likes: type: integer comments_count: type: integer comments_turned_off: type: boolean thumbnail_url: type: string location: {} is_monetized: {} is_members_only: type: boolean is_paid_content: type: boolean is_age_restricted: {} collaborators: type: array items: {} subtitles: type: array items: {} channel: type: object properties: id: type: string name: type: string username: type: string url: type: string subscribers: type: integer total_videos: {} total_views: {} description: {} description_links: type: array items: {} location: {} joined_date: {} is_verified: {} avatar_url: {} banner_url: {} order: type: integer found_on_url: type: string source: type: string errors: type: array items: {} description: Structured result payload. total_points: type: integer description: Points charged for this run. '400': description: Bad Request '401': description: Unauthorized '402': description: Payment Required '500': description: Internal Error components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.