BotGhost Documentation
Support ServerYouTubeMarketplaceBotGhost PremiumSign in
  • Welcome to BotGhost
  • Guidelines & Privacy
  • Changelogs 2025
    • Changelogs 2024
    • Changelogs 2023
  • BotPanel Documentation
  • Getting Started
    • Create Your First Bot
      • Create Your Second Bot
    • Invite Your Bot
    • Standard Practices
      • Advanced Practices
    • Mobile Application (PWA)
  • Support
    • BotGhost Support
    • Frequently Asked Questions
  • Premium & Priority Hosting
    • Priority Hosting
    • Our Premium Features
    • Plans & Payment Methods
    • Manage Your Subscription
    • Upgrade Your Bot
    • Refund & Cancellation Policy
    • Beta Features
  • General Settings and Collaboration
    • Settings
    • Collab
    • Status
    • Active Developer Badge
    • Marketplace
  • Custom Commands & Events
    • Command & Event Builder
      • Sharing Commands and Events
      • Advanced Options
    • Actions
      • Message Actions
        • Send or Edit a Message
          • Button
          • Select Menu
        • Edit a Button or Select Menu
        • Send a Form
        • Delete a Message
        • Publish a Message
        • React to a Message
        • Pin a Message
      • Custom Variable Actions
        • Set Variable
        • Run Equation on Variable
        • Delete Variable
      • API Actions
        • Send an API Request
        • Execute an IFTTT Trigger
      • Loop Actions
        • Run a Loop
        • Stop a Loop
      • Voice Actions
        • Join a Voice Channel
        • Leave a Voice Channel
        • Voice Move a Member
        • Voice Kick a Member
        • Voice Mute or Unmute a Member
        • Voice Deafen or Undeafen a Member
      • Role Actions
        • Add Roles
        • Remove Roles
        • Create a role
        • Delete a role
        • Edit Role
      • Channel Actions
        • Create a channel
        • Edit a channel
        • Delete a channel
      • Thread and Forum Actions
        • Create a Thread
        • Edit a Thread
        • Delete a Thread
      • Server Actions
        • Kick a member
        • Ban a member
        • Timeout a member
        • Change a members nickname
        • Purge Messages
        • Create Server Invite
      • Other Actions
        • Wait before running another action
        • Manipulate some text
        • Send an error log message
        • Set a unique variable
        • Change the Bot's Status
        • Note
      • [LEGACY] Reply Actions
        • Plain Text Reply
        • Embed Reply
        • Random Reply
        • Send a message to a channel
        • Direct Message a User
        • Send a Message with attached buttons
          • Buttons
        • Send a message with a select menu
          • Menu Option
    • Conditions
      • Comparison Condition
      • Permission Condition
      • Chance Condition
      • Channel Condition
      • Role Condition
      • User Condition
      • Premium Check Condition
    • Options
      • Text Option
      • Number Option
      • User Option
      • Channel Option
      • Role Option
      • Choice Option
      • Attachment Option
    • Events
      • Timed Events
      • Webhooks
    • Data Storage
      • Collections
      • Objects
    • IFTTT
    • Variables
  • Server Management
    • Moderation
    • Discord Automod
    • Tickets
    • Welcomer
    • Verification
    • Statistic Channels
    • Modmail
    • Auto-React
    • Sticky Roles
    • Emoji Manager
    • Polls Filter
    • Automod
    • Logging
  • Messages
    • Timed Messages
    • Reaction Roles
    • Autoresponder
    • Embed Builder
    • Sticky Messages
    • Polls
    • Global Chat
    • Media Channels
  • AI
    • ChatGPT
    • Image Generation
  • Game Integrations
    • Roblox Verification
  • Social Integrations
    • YouTube
    • Twitch
  • Community Engagement
    • Leveling
    • Temp Voice Channels
    • Suggestions
    • Invite Tracker
    • Starboard
    • Question Of The Day
    • Giveaways
  • Fun Modules
    • Economy & Minigames
    • Birthdays
    • Counting
  • Utility
    • Translation
    • Weather
Powered by GitBook
On this page
  • Credentials Setup
  • Settings
  • Credentials Setup
  • Upload Notifications
  • Tracked Uploads
  • Search Filters
  • Variables
  • Commands
  • Events

Was this helpful?

  1. Social Integrations

YouTube

Get notifications about uploaded YouTube videos, and search for any YouTube data!

Last updated 1 month ago

Was this helpful?

This module is only available to users with a .

BotGhost provides a module for its users. This module will allow bot users to search for YouTube videos and channels, and see notifications of new uploads.

Credentials Setup

In this area, you can set up the module with your API key.

The YouTube module requires you to create an application on the Google Cloud Console, to communicate with the YouTube API. Follow the steps below to retrieve your API key, and paste it into the settings of the module:

1
2

Enter a name for your project, then click on 'Create'.

3

Click on the search tab at the top of your screen and search for the YouTube Data API V3. Then click on the API listed under 'Marketplace'.

4

Click on the blue 'Enable' button.

5

In the top-right corner, click 'Create Credentials'.

6

Select 'Public Data' and then click on the 'Next' button.

7

Click the copy button on the right of the API key.

8

Head back to the module on your bot's dashboard, and paste your API key. Press 'Save Changes'.


Settings

Credentials Setup

Here you may setup the API keys required for your module to work.

YouTube API Key

Paste your YouTube API Key here. Learn how to get a YouTube API key in the Credentials Setup section of this page.

Upload Notifications

In this area, you can set up (a) new upload tracker(s) to receive notifications for newly uploaded videos from Youtube channels.

Announcement Channel

From this dropdown, you may choose which channel new uploads will be announced in.

YouTube Channel Handle

In this field, input the handle of the YouTube channel you are tracking uploads for. The handle can be found by opening the channel in a browser and checking the URL.

Search Filter

From this dropdown you can choose the type of notification you would like to receive.

Filter Type
Details

All Uploads

If selected, you will receive notifications for all uploaded videos from the channel.

Uploads Matching Query

If this option is selected then only notifications for videos that match the query input will be posted.

Search Query

In this field you can input a term in which the bot will only search and post notifications based off that query. This setting is only visible with Search Filter set to "Uploads Matching Query.

Notification Roles

From this selection you can choose server roles that will be pinged once a notification is posted.

YouTube Upload Notification

Automatically Crosspost Message

If this toggle is enabled then notifications posted in an announcement channel chosen from Announcement Channel will automatically get published to all servers / channels that follow the channel.

To save the upload tracker's settings, you need to click "Add" in the bottom-right corner of the settings.

Tracked Uploads

In this area, you can view, edit, and delete the settings for the upload tracker(s) you added above.

When adding a new upload tracker, it and its settings will appear in this section. All upload trackers will be ordered by the number in which they were created.

To view, edit, and delete the settings you selected above for that tracker, simply click the dropdown arrow next to the upload tracker you wish to do so for.

To save the edits you made on the upload tracker's settings, you need to click "Edit" in the bottom-right corner of the settings.

Search Filters

In this area, you can customize the filters used in search results of the /youtube-search command and search query trackers.

YouTube Safesearch Type

In this section you can change the filter sensitivity for the command. It can be changed from having no filter, to having a highly sensitive one that won't allow inappropriate content.

Definition Requirement

From this dropdown you can define the quality of the searched content.

Duration Requirement

From this dropdown you can define the duration of the searched content.

Variables

Here is some module variables that can be used to customize Upload Notifications.

Variable
Details

{video_title}

Displays the video title.

{video_thumbnail}

Displays the video thumbnail

{video_channel}

Displays the video channel name

{video_description}

Displays the video description

{video_url}

Links the url for the video.


Commands

In this area, you can view and modify the commands of the YouTube module. Below you may find some information on each command of the module.

/youtube-channel
/youtube-search

Events

In this area, you can view and modify the events of the YouTube module. Below you may find some information on each event of the module.

YouTube Handler

This event handles your upload trackers according to the settings for them you specified.


It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intended.

Additionally, a copy of the edited commands / events will be created if you update the module.

Open the page. If prompted, sign into or create a Google account, or click the name of the account you wish to use.

Do not share this API key with anyone. It is linked to your Google Account, and you are responsible for its use. If you or others misuse this key, it could lead to account restrictions. You can learn more about this at .

In this section you can customize the message for the notifications that will be posted. Module can be used to customize this.

This command is what your users can run to search for a YouTube channel.

This command is what your users can run to search for a YouTube search query.

Google Cloud Console project creation
https://console.cloud.google.com/terms
variables
YouTube
How to create a YouTube API key - tutorial video
Premium Subscription
Project Creation page for Google Cloud Console
API/Service Details page for Google Cloud Console
Create Credentials (Credential Type) page for Google Cloud Console
Create Credentials (Your Credentials) page for Google Cloud Console
Credentials Setup in the YouTube module
Tracked Uploads portion of the YouTube module
Search Filters portion of the YouTube module
Commands of the YouTube module
Events of the YouTube module