Title: Youtube Video Search
Author: mauriya
Published: <strong>2012-يىلى 12-يانۋار</strong>
Last modified: 2026-يىلى 2-ئىيۇل

---

قىستۇرما ئىزدە

![](https://ps.w.org/youtube-post-search/assets/icon-128x128.png?rev=1932612)

# Youtube Video Search

 يازغۇچى [mauriya](https://profiles.wordpress.org/mauriya/)

[چۈشۈر](https://downloads.wordpress.org/plugin/youtube-post-search.3.2.3.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/youtube-post-search/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/youtube-post-search/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/youtube-post-search/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/youtube-post-search/#developers)

 [قوللاش](https://wordpress.org/support/plugin/youtube-post-search/)

## چۈشەندۈرۈش

[**Live Demo **](https://demo.mauriya.me/youtube-search/)

**Youtube Video Search turns any page on your site into a live YouTube search engine**—
with your own channel’s videos front and center.

Type a keyword, get real thumbnails, view counts, and a click-to-play embedded player
that queues up the rest of the results as a playlist. No page reload, no leaving
your site.

It was built with one audience in mind: **YouTube creators, video bloggers, course/
membership sites, and media or review sites** who want visitors to discover their
video content without bouncing over to youtube.com — and without a dozen manually-
embedded iframes to maintain.

#### Why creators use it

 * **Your channel comes first.** Add your channel(s) once. Every search checks your
   channel for matches before anyone sees a public result — or restrict search to
   your channel only, with one checkbox. Either way, your content is what visitors
   find.
 * **Drop it in anywhere, no code required.** A Gutenberg block, a classic widget,
   a shortcode, or a template tag — pick whichever fits how you build. All four 
   are the exact same search box under the hood, so behavior never differs between
   them.
 * **It actually helps your SEO**, not just your visitors. Your latest uploads are
   rendered as real, crawlable links directly in the page’s HTML on page load — 
   not hidden behind a search box that only JavaScript can fill in. Every video 
   listing carries schema.org VideoObject structured data (the same markup Google
   uses for video rich results), and a machine-readable JSON feed of your channel
   is available for your own tools or AI integrations.
 * **Modern, mobile-first design.** A responsive card grid, automatic dark mode,
   and a fluid video player that looks right from a phone to a widescreen monitor—
   no theme-specific CSS fighting required.
 * **Your API key never leaves your server.** Every YouTube Data API request is 
   proxied through your own site; visitors‹ browsers never see your key, unlike 
   plugins that print it straight into page JavaScript.

#### Features

 * Gutenberg block — search, insert, done. Live preview in the editor.
 * Classic widget for any sidebar/footer widget area.
 * `[youtubesearch]` shortcode with optional heading/placeholder attributes.
 * `ytps_render_search()` template tag for theme developers.
 * Multiple instances on one page (e.g. widget + block together) work independently,
   out of the box.
 * Configure one or more of your own channels; matched videos are shown first, or
   exclusively, your choice.
 * Server-rendered, crawlable «latest videos» grid + schema.org JSON-LD for SEO —
   no JavaScript required for search engines to see real content.
 * A cached JSON REST feed of your channel’s videos (`/wp-json/ytps/v1/videos`) 
   for your own tooling or AI agents.
 * Real-time search suggestions, debounced search-as-you-type, keyboard accessible.
 * Modern, mobile-responsive card grid with automatic dark mode.
 * Works with or without an API key configured (shows a friendly notice to visitors
   instead of breaking).
 * No third-party CDN dependencies (no Bootstrap, no external jQuery) — uses WordPress
   core’s own bundled scripts.

#### Requirements

 * WordPress 6.4+
 * PHP 8.0+
 * A free YouTube Data API v3 key from Google Cloud Console (the plugin installs
   and displays fine without one; search itself needs a key)

### Growing your channel with this plugin

A few ways creators get the most out of a searchable video wall:

 * **Give it a real page.** Create a «Videos» or «Watch» page, add the block, link
   to it from your main navigation. That’s a page search engines can actually index
   and rank — a bare embed on your homepage isn’t.
 * **Prioritize your channel, don’t restrict it (usually).** Leaving «Channel Restriction»
   unchecked means a visitor searching a topic in your niche sees your videos first,
   with relevant public results as a fallback — better for discovery than an empty
   result set when your channel hasn’t covered that exact keyword yet.
 * **Use headings.** Every placement method accepts an optional heading («Watch 
   Our Tutorials,» «Search Our Recipes,» etc.) — it renders as a real on-page `<
   h2>`, which helps both visitors scanning the page and search engines understand
   what the section is.
 * **Combine placements.** Sitewide widget in the footer for casual browsing, plus
   a focused block on your most important content pages — they don’t conflict.
 * **Let the structured data work for you.** You don’t need to do anything extra
   here — once a channel is configured, the schema.org markup and crawlable links
   are automatic.

## ئېكران كەسمىسى

[⌊The search box with live results — modern, responsive card grid.⌉⌊The search box
with live results — modern, responsive card grid.⌉[

The search box with live results — modern, responsive card grid.

[⌊Real-time search suggestions as you type.⌉⌊Real-time search suggestions as you
type.⌉[

Real-time search suggestions as you type.

[⌊Settings screen: API key, channel targeting, and the How to Use panel.⌉⌊Settings
screen: API key, channel targeting, and the How to Use panel.⌉[

Settings screen: API key, channel targeting, and the How to Use panel.

## بۆلەك

بۇ قىستۇرما 1 بۆلەك تەمىنلەيدۇ.

 *   YouTube Video Search A searchable YouTube video wall. Prioritizes your own 
   channel(s) if configured in Settings > Youtube API Setting.

## ئورنىتىش

#### Quick start

 1. Upload the plugin to `/wp-content/plugins/`, or install it through the Plugins 
    screen in your dashboard.
 2. Activate the plugin.
 3. Go to **Settings  Youtube API Setting**.
 4. Enter a YouTube Data API v3 key. Don’t have one? Click the «Get a free API key»
    link on that page — it takes about two minutes in Google Cloud Console (enable 
    the «YouTube Data API v3», then create an API key under Credentials).
 5. (Recommended for creators) Enter your channel — a `@handle`, a full channel URL,
    or a channel name — and choose whether your channel’s videos should be shown first
    alongside public results, or exclusively.
 6. Place the search box using whichever method fits your workflow:
 7.  * **Block editor:** click **+**, search «YouTube Video Search», insert.
     * **Widget:** **Appearance  Widgets**, add «YouTube Video Search» to any widget
       area.
     * **Shortcode:** paste `[youtubesearch]` into any post, page, or text widget.
     * **Theme file:** add `<?php if ( function_exists( 'ytps_render_search' ) ) { 
       ytps_render_search(); } ?>` to a template.

Full copy-paste snippets and SEO tips are also available right on the Settings  
Youtube API Setting screen after activation, under «How to Use This Plugin.»

#### Getting an API key (step by step)

 1. Go to [Google Cloud Console](https://console.cloud.google.com/apis/credentials).
 2. Create a project (or select an existing one).
 3. Go to **APIs & Services  Library**, search for «YouTube Data API v3», and click**
    Enable**.
 4. Go to **APIs & Services  Credentials**, click **Create Credentials  API key**.
 5. Copy the key and paste it into Settings  Youtube API Setting on your site.

The free tier covers most small-to-medium sites comfortably; the plugin batches 
API calls (search + statistics in as few requests as possible, cached where it makes
sense) to keep quota use efficient.

## FAQ

### Does the plugin work before I add an API key?

Yes. The search box displays normally; searches will show a short notice asking 
visitors to check back later until an API key is added.

### Is my API key visible to visitors?

No. It’s stored in the WordPress options table and used only in server-side requests.
It’s never printed into page HTML or JavaScript — a meaningful difference from plugins
that embed the key directly in the page source, where anyone can view-source and
lift it.

### How does channel priority work?

If you list your channel(s) and leave «Only show videos from the channel(s)» unchecked,
a search first checks each configured channel for matches, places those at the top
of the results, then fills remaining slots with public search results for the same
keyword. Checking that box hides public results entirely and searches your channel(
s) only.

### Can I list more than one channel?

Yes, up to 5, one per line or comma-separated. Each can be a `@handle`, a full channel
URL, or a channel ID.

### Is this actually good for SEO?

The plugin renders your channel’s latest videos as real, indexable HTML on page 
load (with genuine `<a href>` links to YouTube, not JavaScript-only content), and
includes schema.org VideoObject structured data automatically. That’s a meaningfully
different starting point than a plugin whose entire result set only exists after
a visitor manually searches. It’s not a guarantee of rankings — no plugin can promise
that — but it gives search engines real content to work with.

### What’s the JSON feed for?

When you configure a channel, the plugin exposes `/wp-json/ytps/v1/videos` — a cached,
schema.org-shaped JSON list of that channel’s latest uploads. It’s meant for your
own use: custom integrations, other tools on your site, or AI agents/crawlers that
prefer structured data over parsing rendered HTML.

### Can I use the block and widget on the same page?

Yes. Each instance (block, widget, shortcode) works independently — search state,
results, and the video player don’t interfere with each other even if several are
on the same page.

### What happened to the dislike count?

YouTube removed public dislike counts from the Data API in December 2021. The like
indicator reflects a like-to-view ratio instead.

### Does this work with my theme?

The plugin ships its own self-contained styles (no Bootstrap, no external CDN) and
uses standard WordPress hooks for blocks/widgets, so it should work with any properly-
coded theme. If something looks off, it’s almost always a CSS specificity conflict—
the support forum is the place to flag it.

## باھالاشلار

![](https://secure.gravatar.com/avatar/38b20e51d5ac59e7ad3c67dfcaa4d6c9cde23ab91cdea4bbea6d47f449b91038?
s=60&d=retro&r=g)

### 󠀁[Excellent!!](https://wordpress.org/support/topic/excellent-6676/)󠁿

 [naomibuch](https://profiles.wordpress.org/naomibuch/) 2018-يىلى 7-سېنتەبىر

Works perfectly! Many thanks to the developer

![](https://secure.gravatar.com/avatar/445742f47fb9b1bc93a22513f73c5753298c9364e136f5f3b59f8b0898908a03?
s=60&d=retro&r=g)

### 󠀁[More Options](https://wordpress.org/support/topic/more-options-16/)󠁿

 [toast09](https://profiles.wordpress.org/toast09/) 2018-يىلى 1-سېنتەبىر

The plugin is awesome. Can you please add youtube channel option as well. Thanks

![](https://secure.gravatar.com/avatar/e13fe6c2b8a0212c078c220c896b880e7eeeb79d7a2c6fe83a44d7e78eb138f8?
s=60&d=retro&r=g)

### 󠀁[Nice search](https://wordpress.org/support/topic/nice-search-3/)󠁿

 [macuser09](https://profiles.wordpress.org/macuser09/) 2017-يىلى 8-ئاۋغۇست

This youtube video search script worked like a charm for my blog. Is compatible 
with any themes, I have. Thanks

 [ 3 باھالاشنىڭ ھەممىنى ئوقۇش ](https://wordpress.org/support/plugin/youtube-post-search/reviews/)

## تۆھپىكار ۋە ئىجادكار

«Youtube Video Search» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا 
تۆھپە قوشقان.

تۆھپىكار

 *   [ mauriya ](https://profiles.wordpress.org/mauriya/)

[«Youtube Video Search» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/youtube-post-search)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/youtube-post-search/)،
[SVN خەزىنە](https://plugins.svn.wordpress.org/youtube-post-search/) تەكشۈرۈپ ياكى
[RSS](https://plugins.trac.wordpress.org/log/youtube-post-search/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/youtube-post-search/)
گە مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

#### 3.2.2

 * Fix: the search input field’s CSS selector still referenced the old markup structure
   from before multi-instance support was added (`#query` instead of `.ytps-query`),
   so it never matched and the input rendered unstyled — visible as an oversized,
   empty-looking search bar with a plain browser-default text box instead of the
   intended compact search field. Styling now applies correctly.
 * Fix: added missing styling for the optional heading text (block/widget/shortcode`
   heading` attribute).

#### 3.2.1

 * Fix: reverted the main plugin file name from `youtube-post-search.php` back to`
   youtubepostsearch.php`. The 3.2.0 rewrite renamed it, which broke the update 
   path for sites with the plugin already installed and active — WordPress tracks
   active plugins by exact file path, and the old path no longer existed after updating,
   silently stopping the plugin from loading. Fresh installs of 3.2.0 were unaffected;
   in-place updates from an earlier version were not. If you experienced the search
   box not working after updating to 3.2.0, updating to 3.2.1 resolves it with no
   configuration changes needed.

#### 3.2.0

 * New: Gutenberg block («YouTube Video Search») with live editor preview and per-
   instance heading/placeholder options.
 * New: classic widget for sidebars and footer widget areas.
 * New: multiple instances (block + widget + shortcode) now work correctly together
   on the same page — each has independent search state and playlist.
 * New: SEO — the search box now server-renders your configured channel’s latest
   uploads as real, crawlable `<a href>` links with schema.org VideoObject JSON-
   LD, instead of starting as an empty box that only fills in after a visitor searches.
 * New: cached JSON REST feed at `/wp-json/ytps/v1/videos` for your channel’s videos,
   with a `<link rel="alternate">` discovery tag in the page head.
 * New: live search results also carry client-side schema.org structured data as
   they load.
 * New: «How to Use This Plugin» reference panel added directly to the Settings 
   screen — copy-paste snippets for all four placement methods plus SEO/growth tips.
 * Improvement: video cards are now real anchor links (work with JavaScript disabled,
   support ctrl/cmd-click to open in a new tab), progressively enhanced to open 
   inline when JavaScript is available.
 * Improvement: added `uploadDate` (from the API’s `publishedAt`) to structured 
   data output.

#### 3.1.0

 * Redesigned front end: modern CSS Grid card layout, fluid down to mobile widths,
   automatic dark-mode support, animated loading state, debounced search-as-you-
   type.
 * Video player is now fully responsive via CSS aspect-ratio instead of JavaScript
   width calculations.
 * New: configure one or more of your own YouTube channels. Matching videos from
   those channels are shown first, ahead of public search results for the same keyword.
 * New: «Only show videos from the channel(s)» checkbox to restrict search entirely
   to your configured channel(s).
 * New: results now display the source channel name, and channel-sourced cards carry
   a badge.
 * Channel names/@handles/URLs are resolved to canonical channel IDs once on settings
   save (not on every search), keeping front-end search fast and quota-light.

#### 3.0.0

 * Full rewrite for WordPress 6.4–7.0, PHP 8.0–8.3.
 * Security: API key is no longer printed into front-end HTML/JS; all YouTube API
   calls are proxied server-side via a nonce-protected AJAX endpoint.
 * Security: settings form now uses a nonce and capability check; all output is 
   escaped and all input is sanitized.
 * Fix: plugin options are no longer deleted on simple deactivation (moved to uninstall.
   php, WordPress-standard behavior).
 * Removed dependency on Bootstrap CDN; replaced with a small self-contained stylesheet.
 * Removed dependency on jQuery/jQuery UI CDN; now uses WordPress core’s bundled
   copies.
 * Removed the hardcoded shared demo API key.
 * Removed deprecated dislikeCount usage (no longer returned by the YouTube API).
 * Autocomplete suggestions now proxied server-side (fixes mixed-content failures
   on HTTPS sites).
 * Performance: video statistics for a search’s results are now fetched in a single
   batched API call instead of one call per video.

#### 2.2.7

 * Numbers of comments.

#### 2.2.6

 * Star rating.

#### 2.2.5

 * Libraries updated.

## Meta

 *  Version **3.2.3**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **2 ھەپتە بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10+**
 *  WordPress نەشرى ** 6.4 ياكى يۇقىرى **
 *  **7.0.1** دا سىنالغان
 *  PHP نەشرى ** 8.0 ياكى يۇقىرى **
 *  تىل
 * [English (US)](https://wordpress.org/plugins/youtube-post-search/)
 * بەلگە
 * [Gutenberg block](https://ug.wordpress.org/plugins/tags/gutenberg-block/)[video gallery](https://ug.wordpress.org/plugins/tags/video-gallery/)
   [video search](https://ug.wordpress.org/plugins/tags/video-search/)[youtube](https://ug.wordpress.org/plugins/tags/youtube/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/youtube-post-search/advanced/)

## دەرىجە

 5/5 يۇلتۇز

 *  [  3 5-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/youtube-post-search/reviews/?filter=5)
 *  [  0 4-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/youtube-post-search/reviews/?filter=4)
 *  [  0 3-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/youtube-post-search/reviews/?filter=3)
 *  [  0 2-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/youtube-post-search/reviews/?filter=2)
 *  [  0 1-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/youtube-post-search/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/youtube-post-search/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/youtube-post-search/reviews/)

## تۆھپىكار

 *   [ mauriya ](https://profiles.wordpress.org/mauriya/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/youtube-post-search/)

## ئىئانە

بۇ قىستۇرمىنىڭ ياخشىلىنىشىنى قوللامسىز؟

 [ بۇ قىستۇرمىغا ئىئانە قىلىش ](https://www.paypal.me/ryanmahato)