YouTube · Setup guide
How to Create a YouTube Data API Key
StreamBruh uses your YouTube Data API v3 key for public video searches and channel upload checks. Google Cloud quotas and API key restrictions can affect these scheduled checks.
Step-by-step setup
Create or select a Google Cloud project
Sign in to Google Cloud Console with a Google account. Create a project for these notifications or select a project you manage. Check that the intended project is active in the console header.
Enable YouTube Data API v3
In APIs & Services → Library, search for YouTube Data API v3 and enable it for that project. Creating a key alone does not enable the API.
Create an API key
Open APIs & Services → Credentials, choose Create credentials → API key, and copy the generated key. Restrict its API access to YouTube Data API v3. Keep the key out of public pages and source control.
StreamBruh calls Google from its server, not from a visitor’s browser. A website or HTTP-referrer restriction will block those server requests. If StreamBruh support confirms a stable public egress IP for the VPS, you can additionally restrict the key to that IP; otherwise keep the YouTube API restriction and monitor usage.
Save the key in StreamBruh
Open Bot & integrations, paste the key into YouTube API Key, and save. A saved key is masked. Leave the field blank during later edits if you want to keep the existing key.
Choose searches or channels
A YouTube search notification follows new public videos matching a search term; its language setting is a relevance preference rather than a guarantee, and comma-separated blocked words exclude titles containing those terms. A channel notification accepts a YouTube @handle link, channel ID link, handle, or channel ID supported by the form.
Select a Discord destination channel, customize the message, and save. Checks run on a schedule. Search requests and channel checks consume YouTube API quota at different rates; results also depend on YouTube availability.
Check your setup
- YouTube Data API v3 is enabled in the same project as the key.
- The key’s API restriction includes YouTube Data API v3 and its client restriction permits the VPS.
- A channel link resolves or a search configuration saves, and the bot can send to the selected Discord channel.
Troubleshooting
API key rejected
Confirm the key belongs to the selected project, YouTube Data API v3 is enabled, and its restrictions allow requests from the VPS. Browser-referrer restrictions do not match server-side calls.
Quota exhausted
Review YouTube Data API usage and quota in Google Cloud Console. Reduce unnecessary searches or request a quota extension through Google if eligible; retry after quota becomes available.
No video posted
Check whether a new public video matches the search or channel since the last check, whether blocked words exclude its title, and whether the Discord channel remains sendable. Scheduled checks are not instant.