Grouper: RSS manager, XML converter, website scraper
Web This Site

Grouper - Documentation


Getting Started: Free Download | Purchase | Install
Reference: Functions | Plugins | Themes
Etc.: Configure | Affiliates


YouTube plugin

The YouTube plugin works with the JSON plugin to convert YouTube search API results to RSS. It comes with a helper script to make configuring it for different searches easier.

Installation:
To use the YouTube plugin, json.php and json-youtube.php must be located in the "plugins" folder inside the folder containing grouper.php. This is their default location when Grouper Evolution is installed. You will also need to upload youtube2rss.php to your webserver after making the configuration changes noted below.

Configuration:
  1. The first step is to create a "project" in the Google Developer Console and get an API key.
    1. Sign in at https://console.developers.google.com/ using your Google account.
    2. From the "Select a project" list at the top, select "Create a project".
    3. Enter a name -- for example "Grouper".
    4. Click "Create".
    5. Make sure your new project is selected, and click "APIs" in the left sidebar.
    6. Click "YouTube Data API".
    7. Click "Enable API".
    8. Again, click "APIs" in the left sidebar.
    9. Click "Enabled APIs" at the top of the main content area.
    10. Disable any APIs that you don't want to use with this project (we suggest disabling all except the YouTube Data API).
    11. Click "Credentials" in the left sidebar.
    12. Under "Public API access", click "Create new Key".
    13. Copy the API key that is created.
  2. In the "********* CONFIGURATION **********" section of youtube2rss.php, find the line that says "$YouTubeAPIKey=GrouperYouTubeSetting('GrouperYouTubeAPIKey','put_your_api_key_here',1);" and paste your API key in where it says "put_your_api_key_here".
  3. Find the line that says "$path_to_grouper='/YOUR/PATH/TO/grouper/grouper.php';" and edit it so that it points to the location where you installed Grouper Evolution.

youtube2rss.php is now ready to upload to your webserver.

Use:
You can now generate RSS feeds from YouTube searches using the URL of youtube2rss.php on your webserver by specifying search terms and/or a YouTube channel ID, as in the following examples.

http://example.com/youtube2rss.php?query=internet+marketing
http://example.com/youtube2rss.php?channelid=UCoBVOCTfQ2I8gXtcyt2z-eA
http://example.com/youtube2rss.php?channelid=UCoBVOCTfQ2I8gXtcyt2z-eA&query=carp

By default, videos are sorted by date posted. You can specify other sort orders by adding an "order" argument to the URL. See the YouTube API documentation for valid values.

By default, a maximum of 15 videos are listed. You can specify a different number by adding an "maxresults" argument to the URL.