Overview
The YouTube integration allows Enterpret to ingest comments from your YouTube channel's videos. Once connected, Enterpret will:
Pull comments and replies from all public videos on your channel.
Automatically backfill the last 90 days of comment history.
Continuously sync new comments as they are posted.
Revisit recent videos to pick up new comments and replies.
Filter out spam comments so your analysis stays clean and actionable.
Each comment is analyzed by Enterpret's AI to extract topics, sentiment, and themes, giving you a structured understanding of your audience's voice.
Prerequisites
Before setting up the YouTube integration, make sure you have the following:
Google Account: You must have a Google account that owns or manages the YouTube channel you want to connect.
YouTube Channel: The Google account must have an active YouTube channel associated with it.
Channel Permissions: You must be the owner of the YouTube channel. Manager or editor roles on YouTube do not grant the OAuth permissions required for this integration.
Comments Enabled: Comments must be enabled on the videos you want to analyze. Videos with comments disabled will be gracefully skipped. They won't cause errors, but no data will be collected from them.
Enterpret Account: You must have an active Enterpret account with permission to manage integrations.
Setting Up the Integration
Follow these steps to connect your YouTube channel:
Step 1: Navigate to Integrations
In the Enterpret app, click on your profile icon in the bottom-left corner of the sidebar.
From the menu, click Integrations.
Step 2: Add a New Integration
Click the New Integration button at the top of the Integrations page.
In the search bar, type YouTube to find the integration.
Click Continue on the YouTube card and choose feedback integration.
Step 3: Authenticate with Google
You will be redirected to Google's OAuth consent screen.
Sign in with the Google account that owns the YouTube channel you want to connect.
Click Allow to grant Enterpret access.
Step 4: Confirm the Connection
You will be redirected back to Enterpret. Please select General user feedback and click on "Save Changes"
The integration will appear in your Integrations list, showing the channel name and a connected status.
Enterpret will immediately begin syncing your channel's comment data, starting with a 90-day backfill.
That's it. No additional configuration is required.
Permissions and OAuth Scopes
When you connect your YouTube channel, Google will ask you to authorize specific permissions. Here is exactly what Enterpret requests and why.
OAuth Scope Requested:
youtube.force-ssl: Allows Enterpret to view your YouTube account data, including your channel information, video metadata, and comments. This is the standard scope required by the YouTube Data API to read channel and comment data over a secure (SSL) connection.
What does this permission allow?
With this scope, Enterpret can:
Read your channel information, to identify which channel you are connecting and display its name.
Read your video metadata (titles, descriptions, and publish dates), so comments can be associated with the correct video context.
Read comments and replies, the core data that Enterpret analyzes to surface insights.
What Enterpret will never do:
Enterpret will never post comments on your behalf.
Enterpret will never modify or delete your videos, comments, playlists, or any other content. • Enterpret will never upload content to your channel.
Enterpret will never change channel settings or subscriptions.
Enterpret does not access private or unlisted videos beyond what the authenticated account can see.
Although the OAuth scope technically permits write operations, Enterpret exclusively uses read-only API calls. The youtube.force-ssl scope is the YouTube Data API's standard scope for accessing comment data over SSL, and a narrower read-only alternative is not available for the comment APIs Enterpret needs.
Why not a read-only scope?
Google's YouTube Data API does offer a youtube.readonly scope, but it does not grant access to the comment-related endpoints (commentThreads.list and comments.list) that Enterpret requires. The youtube.force-ssl scope is the minimum scope that provides access to comment data.
What Data Does Enterpret Collect?
Channel Information:
Channel ID: Uniquely identifies your channel for the integration.
Channel Name: Displayed in the Enterpret dashboard to identify the source.
Video Metadata (for each video on your channel):
Video Title: Provides context for the comments being analyzed.
Video Description: Additional context for understanding comment themes.
Published Date: Used for time-based filtering and analysis.
Video URL: Direct link back to the source video in reports and dashboards.
Comments and Replies (for each comment and reply on your videos):
Comment Text: The primary content analyzed for insights, sentiment, and themes.
Author Display Name: Identifies the commenter (public YouTube display name only).
Like Count: Signals comment engagement and relevance.
Published Date: Enables time-series analysis and trend detection.
Reply Threading: Preserves conversation context. Each reply includes its parent comments for accurate analysis.
What Enterpret does NOT collect:
Subscriber lists or subscriber data
Watch history or analytics/revenue data
Private messages
Video view counts or performance metrics
Email addresses or personal contact information
Unlisted or private video content beyond what the authenticated account can access
Multiple Channels
Yes, you can connect multiple YouTube channels to Enterpret.
Each YouTube channel is set up as a separate integration. To connect additional channels:
Follow the same setup steps above.
When prompted to authenticate with Google, sign in with the Google account that owns the additional channel.
Each channel will appear as its own integration entry in your Integrations list.
Important notes on multiple channels:
Each integration is tied to a specific YouTube channel, identified by its unique Channel ID during the OAuth flow.
If the Google account you authenticate with has multiple YouTube channels (brand accounts), the integration will connect to the primary channel associated with that account.
To connect a YouTube Brand Account channel, make sure you switch to that brand account in YouTube before starting the OAuth flow, or sign in with the Google account that directly owns the brand account.
How the Sync Works
Once connected, Enterpret automatically manages the data sync for you. Here's what happens behind the scenes:
Initial Backfill:
Enterpret backfills the last 90 days of comments from all videos on your channel. The backfill processes videos chronologically, collecting all comments and replies for each video.
Depending on the volume of comments on your channel, the initial backfill may take anywhere from a few minutes to several hours.
Ongoing Sync:
After the initial backfill, Enterpret continuously checks for new videos and new comments on your channel.
Enterpret also revisits recent videos to pick up newly posted comments and replies on existing videos.
Up to 50 of your most recently active videos are tracked for ongoing comment monitoring.
The sync runs automatically. No manual action is needed.
Other important notes:
Comments disabled on a video: The video is skipped gracefully. Other videos continue to sync.
Video is deleted or made private: The video is automatically removed from tracking.
YouTube API rate limit reached: Enterpret backs off and retries automatically. No data is lost.
OAuth token expires: Tokens are refreshed automatically in the background. You do not need to re-authenticate.
Re-authenticating the Integration
If your integration's authentication expires or you need to refresh credentials:
Go to Integrations in Enterpret.
Find your YouTube integration and click on it.
Follow the re-authentication prompts to sign in with Google again.
Important: When re-authenticating, you must sign in with the same Google account that owns the same YouTube channel as the original integration. If you authenticate with a different channel, the re-authentication will fail. This safeguard prevents accidental data mixing between channels.
If you need to switch to a different channel, create a new integration instead.
Frequently Asked Questions
Do I need a YouTube Premium or YouTube Partner account?
No. The integration works with any standard YouTube channel. You do not need YouTube Premium, YouTube Partner Program membership, or any paid YouTube features.
2. Can I choose which videos to sync?
No. Enterpret syncs comments from all public videos on the connected channel. You can use Enterpret's filtering and segmentation features within the dashboard to focus your analysis on specific videos or time periods.
3. How far back does the initial sync go?
Enterpret backfills the last 90 days of comments by default. Comments older than 90 days are not included in the initial sync. If you need us to do more than that, you can contact our team.
4. How quickly do new comments appear in Enterpret?
New comments are picked up during the next sync cycle. Enterpret periodically polls your channel for new content, so new comments will typically appear within a few hours of being posted.
5. Will connecting Enterpret affect my YouTube channel in any way?
No. Enterpret is entirely read-only in practice. It will not post comments, change settings, affect your video rankings, or interact with your audience in any way.
6. Does Enterpret collect comments from YouTube Shorts?
Yes. YouTube Shorts are treated as regular videos by the YouTube Data API. If Shorts have comments enabled, those comments will be collected and analyzed like any other video.
7. What happens if I revoke access from my Google account?
If you revoke Enterpret's access from your Google account (via Google Account Permissions at myaccount.google.com/permissions), the integration will stop syncing. Any data already collected in Enterpret will remain available, but no new comments will be fetched. You can re-authorize at any time by re-authenticating the integration in Enterpret.
8. Can I connect a channel I manage but don't own?
No. You must sign in with the Google account that owns the YouTube channel. Manager or editor-level access to a channel does not grant the OAuth permissions required by the YouTube Data API for this integration.
9. Is my data secure?
Yes. All communication between Enterpret and YouTube uses encrypted HTTPS connections. Your OAuth credentials (access tokens and refresh tokens) are encrypted at rest within Enterpret's infrastructure. Enterpret follows industry-standard security practices for credential storage and data handling.
Troubleshooting:
"No YouTube channel found" error during setup:
This means the Google account you authenticated with does not have a YouTube channel. Make sure you are signing in with the correct Google account, and that the account has an active YouTube channel.
2. Comments from certain videos are missing: If specific videos don't show comments in Enterpret, check whether:
Comments are disabled on those videos (Enterpret skips videos with comments disabled).
The videos are private or unlisted (only accessible if the authenticated account can view them).
The videos were published more than 90 days ago and were not included in the initial backfill.
3. I connected the wrong channel:
If you connected the wrong YouTube channel, you can disable the integration from the Integrations page and create a new one with the correct Google account.
If you need further assistance, contact Enterpret support at [email protected].