The Video Search tab in the Admin Panel is the central hub for configuring how your engine fetches, displays, and caches global video content. Whether you are targeting a Western audience or the massive Chinese market, this section allows you to bridge your platform with the world’s most powerful video networks through a simple, secure API integration.
🎬 Core Video Functionality & Logging
Administrators have granular control over the availability and technical monitoring of the video vertical:
- Feature Toggle: You can instantly enable or disable the entire video search vertical on your frontend.
- Advanced Logging: For technical optimization, you can enable Video Search Logging, which records all queries, API calls, and raw results. This is an essential tool for debugging connection issues or analyzing user interests.
- Provider-Specific Diagnostics: The logs capture raw JSON error messages directly from providers (e.g., “API Key Not Valid” or “Quota Exceeded”).
- Performance Tracking: It records exact API response times and cache hit/miss statistics for every query.
💾 High-Efficiency Video Caching
To maintain lightning-fast performance and keep API costs at zero after the initial search, the system utilizes a “Surgical Caching” model:
- Asset Localization: When enabled, the engine not only caches the search results but also downloads video thumbnails locally to your server.
- Adjustable Cache Duration: You can set the cache life for up to 365 days. Longer durations ensure that popular trending videos are served instantly from your own storage, bypassing external API delays and quotas.
- Response Speed: Localized caching reduces search times from 1–3 seconds down to just 50–100ms.
- Storage Requirements: Caching 10,000 unique videos (metadata and thumbnails) only requires roughly 150–300 MB of server space.
🌍 Dual-Market Provider Selection
The platform offers a strategic choice between two global video powerhouses to suit your specific regional goals:
- YouTube (Global Standard): Ideal for most international markets. This integration requires a YouTube API Key from the Google Cloud Console with the YouTube Data API v3 enabled.
- Douyin (Chinese TikTok): The go-to choice for sites accessible in China, where YouTube is restricted. This requires credentials from the Douyin Open Platform, including an API Key/Token and an optional App ID.
- Infinite Scaling on Free Tiers: While the YouTube API has a 10,000-unit daily limit, our Surgical Caching ensures you only “pay” the 100-unit cost once per unique query. If 1,000 people search for the same trending video, you only use 100 units total, allowing a small free API key to power a high-traffic engine indefinitely.
- The “Great Firewall” Solution: Douyin is essential for the Chinese market because YouTube is blocked in mainland China. This integration ensures your site stays 100% functional for 600+ million daily users without them needing a VPN.
⚙️ Technical Administration
The Video Search tab is designed for “Set and Forget” ease of use:
- Connection Testing: Both YouTube and Douyin configurations include a “Test Connection” button to verify your API credentials instantly before going live.
- Pagination Control: You can define exactly how many video results appear per page (between 1 and 50), allowing you to balance page load speed with content depth.
- Secure Storage: All API keys are stored securely and can be toggled to “Show/Hide” within the interface to prevent unauthorized viewing.
- API Key Masking: The admin panel includes a Show/Hide button for your API keys, so you can perform demos or record your screen without exposing your private credentials.
- Handshake Validation: The “Test Connection” button performs a live diagnostic check to ensure your server can “talk” to the API before you flip the switch to go live.
By mastering these settings, you transform your search engine into a high-performance video portal that provides a seamless viewing experience across any global border.
