YouTube General search with filters API

Search YouTube with advanced filters. Supports filtering by upload time, video duration, content type, features, and sort order.

View Docs

GET/v1/youtube/get_general_search

search_querystringrequired

Search keyword

language_codestringoptional

Language code. Recommended: zh-CN (Chinese), en-US (English) Options: "zh-CN", "en-US", "ja-JP", "ko-KR", etc.

country_codestringoptional

Country code, affects the region of search results. Options: "US", "JP", "GB", etc.

time_zonestringoptional

Time zone Examples: America/Los_Angeles, Asia/Shanghai

upload_timestringoptional

Upload time filter. Options: hour: uploaded in the last hour today: uploaded today week: uploaded this week month: uploaded this month year: uploaded this year

durationstringoptional

Video duration filter. Options: short: short videos (under 4 minutes) medium: medium-length videos (4-20 minutes) long: long videos (over 20 minutes)

content_typestringoptional

Content type filter. Options: video: videos channel: channels playlist: playlists movie: movies

featurestringoptional

Feature filter. Options: hd: HD video 4k: 4K video subtitles: subtitled live: live streams creative_commons: Creative Commons license 360: 360-degree video vr180: VR180 video 3d: 3D video hdr: HDR video location: has location info purchased: purchased content

sort_bystringoptional

Sort order. Options: relevance: most relevant (default) upload_date: upload date view_count: view count rating: rating

continuation_tokenstringoptional

Pagination token

YouTube API Use Cases

General search with filters Data Collection

Retrieve general search with filters data from YouTube at scale for analytics and research.

Competitive Intelligence

Monitor YouTube activity and benchmark against competitors using real-time data.

Automation & Integration

Integrate YouTube general search with filters data into your product, dashboard, or data pipeline.

Frequently Asked Questions

Is the YouTube API official?

No, KeyAPI provides an unofficial YouTube API that lets you access YouTube data through our platform. We handle the complexities of data collection so you can focus on building your application.

How current is the data?

We provide real-time data from YouTube. When you make a request, we fetch the latest information available.

How do credits work?

Each API endpoint consumes credits. Most endpoints cost just 1 credit. All pricing is transparent in our API documentation with no hidden fees.

Can I use this for AI model training?

Yes. KeyAPI provides structured, AI-ready data ideal for training datasets, fine-tuning LLMs, and building AI pipelines. Our historical archives are particularly valuable for large-scale training workloads.

Start for free — no credit card required

Ready to unlock unified
social intelligence?

Join the growing community of developers, AI builders, automation engineers, and global businesses who trust KeyAPI for reliable, scalable social media data access.

View Documentation