Mattering Automations YouTube integration

Connect the YouTube Data API to Mattering Automations: search, video stats, channel stats, and comment threads as read-only workflow steps and agent tools.

Get the credential Connect Verify Node reference Troubleshooting

The Mattering Automations YouTube integration covers the public read surface of the YouTube Data API v3: search for videos, channels, or playlists, pull a video's statistics, read channel metadata, and fetch comment threads.

Setup is one Google Cloud API key. It is deliberately the public-data tier, so nothing here can touch a channel, upload, or manage anything, which makes it safe to hand to agents for research and monitoring.

Before you start

A Google Cloud project with the YouTube Data API v3 enabled.
A Mattering workspace with access to the Automations app.

Create or reuse a Google API key

The connector authenticates with a Google Cloud API key sent as a query parameter. One key serves every Google API-key integration on Mattering.

In the Google Cloud console, select your project and enable the YouTube Data API v3 (search for it in the API Library).

Open APIs and Services > Credentials and click Create credentials > API key, or reuse the key you already use for other Mattering Google integrations.

One Google API key serves every Google API-key integration on Mattering (PageSpeed, YouTube, Translate, and the rest of the family). Each API just needs enabling on the key's project.

Copy the key (it starts with AIza).

Connect YouTube to Mattering

In Mattering Automations, open Connectors and click Add Connector.

Choose YouTube Data from the list.

Click Create new credential, paste the API key, and save. The credential is stored encrypted in Google Secret Manager.

Click Connect. All four YouTube nodes appear in your canvas palette.

Verify it works

Open an automation canvas and drop YouTube Search onto it. Set a query and run a test step: a successful response returns matching videos with ids and snippets.

Feed a returned video id into YouTube Get Video for statistics, or a channel id into YouTube Get Channel, to confirm the read chain end to end.

Node reference

4 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 4

YouTube Get Channel

gapi_yt_get_channel

Get snippet and statistics for a channel by id, handle, or username.

YouTube Get Video

gapi_yt_get_video

Get snippet, statistics, and content details for one or more videos.

YouTube List Comments

gapi_yt_list_comments

List top-level comment threads on a video.

YouTube Search

gapi_yt_search

Search YouTube for videos, channels, or playlists.

Using the integration

On the automation canvas

Track competitor channel stats on a schedule, mine comment threads for content ideas, or search a keyword daily and diff the results to catch new videos. Feed the output into a Mattering database or an AI summary step.

Read-only by design

The API key covers public data only. Uploading, playlist management, and channel administration need OAuth scopes this connector does not request, so an agent holding this credential can read but never touch a channel.

From AI assistants over MCP

All four nodes speak MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can research YouTube through the same nodes your workflows use.

Troubleshooting

Calls fail with a quota exceeded error

Google grants YouTube Data API projects a default 10,000 units per day per its documentation, and calls cost different units (search is 100 units, most reads cost 1). A daily monitoring workflow fits comfortably; heavy search loops need quota awareness or a quota increase request.

The node reports the API is not enabled

Enable the YouTube Data API v3 on the key's project in the Google Cloud API Library, and confirm the key's API restrictions include it.

Get Video returns an empty list for a real video

Pass the video id in the id field (not a URL). The search node returns ids under items[].id.videoId; use that value.

The YouTube MCP

What connecting YouTube unlocks for AI agents and automations, with common uses and FAQs.

More guides

All Automations documentation

Every integration guide, plus how connectors, credentials, and workflows fit together.

YouTube is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.