[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [YouTube channel description](https://spiral.ai/integrations/gemini/youtube-channel-description)

# How to Use YouTube channel description in Gemini

Returns channel descriptions, subscriber and video counts, views, creation dates, and social links. Use it for channel research, allowing two requests to retrieve the complete description data.

|  |  |
| --- | --- |
| Model | YouTube channel description |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with YouTube channel description in Gemini

- Use YouTube channel description for @GoogleDevelopers and summarize its description, subscriber count, video count, creation date, and social links.
- Use YouTube channel description to look this up and give me the result as a table.
- Pull the latest numbers from YouTube channel description and tell me what changed since last week.
- Check YouTube channel description and summarize what you find in three bullet points.
- Pull the newest data from YouTube channel description and give me the result as a table.

## How to set up YouTube channel description in Gemini

Pick the way that suits you. Each takes about two minutes.

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run YouTube channel description**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "tikhub",
    "model": "tikhub/youtube-web-v2-get-channel-description",
    "input": {
      "channel_id": "UCeu6U67OzJhV1KwBansH3Dg"
    }
  }'
```

Then paste one of the prompts above: Gemini finds YouTube channel description on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini

## YouTube channel description tools and prices

- [YouTube Web V2 · Get channel description](https://spiral.ai/tools/tikhub/tikhub/youtube-web-v2-get-channel-description) (TikHub): $0.0013 per request.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| channel_id |  | — | Channel ID, can be obtained from channel URL via get_channel_id endpoint |
| need_format |  | true | Whether to clean and format the data |
| country_code |  | US | Country code |
| language_code |  | zh-CN | Language code |
| continuation_token |  | — | Continuation token for getting advanced info like channel creation date |

## What can you do with YouTube channel description in Gemini?

Prepare a YouTube channel briefing with source links and concrete examples from public content. A chat app can organize the returned channel information, publishing records, or community discussion into a readable comparison.

### Compare competing channels

Research NASA and ESA publishing: resolve channel identities, compare descriptions, discover relevant search results, and review videos, Shorts, and community announcements. Read post comments and replies for recurring audience questions, then attach recognizable channel links to the comparison.

### Prepare a product launch briefing

Build a briefing around a Google product announcement. Confirm the publishing channels and their descriptions, find related coverage through search, inventory videos and Shorts, and examine community announcements with their comment threads. Include channel links so editors can check the sources.

### Research creator sponsorship fit

Find public technology channels, reconcile their URLs, and review their descriptions and publishing topics. Compare video titles, Shorts, community posts, and aggregate discussion themes to prepare a sponsorship shortlist with source links. Use raw or structured search according to the research workflow.

### Plan an educational content series

Research Python teaching channels and their public catalogs. Use channel descriptions and identity lookups to organize sources, search for existing lessons, and compare videos with Shorts. Review community posts, comments, and replies for questions worth addressing in a lesson outline.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All Gemini guides](https://spiral.ai/integrations/gemini)

## YouTube channel description in other agents

- [Amp](https://spiral.ai/integrations/amp/youtube-channel-description)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/youtube-channel-description)
- [Claude](https://spiral.ai/integrations/claude-desktop/youtube-channel-description)
- [Claude Code](https://spiral.ai/integrations/claude-code/youtube-channel-description)
- [Cline](https://spiral.ai/integrations/cline/youtube-channel-description)
- [Codex](https://spiral.ai/integrations/codex/youtube-channel-description)
- [Cursor](https://spiral.ai/integrations/cursor/youtube-channel-description)
- [Devin](https://spiral.ai/integrations/devin/youtube-channel-description)
- [dots](https://spiral.ai/integrations/dots/youtube-channel-description)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/youtube-channel-description)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/youtube-channel-description)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/youtube-channel-description)
- [goose](https://spiral.ai/integrations/goose/youtube-channel-description)
- [Grok](https://spiral.ai/integrations/grok/youtube-channel-description)
- [Grok Build](https://spiral.ai/integrations/grok-build/youtube-channel-description)
- [Hermes](https://spiral.ai/integrations/hermes/youtube-channel-description)
- [Instinct](https://spiral.ai/integrations/instinct/youtube-channel-description)
- [Manus](https://spiral.ai/integrations/manus/youtube-channel-description)
- [Muse](https://spiral.ai/integrations/muse/youtube-channel-description)
- [Muse Code](https://spiral.ai/integrations/muse-code/youtube-channel-description)
- [n8n](https://spiral.ai/integrations/n8n/youtube-channel-description)
- [Notion](https://spiral.ai/integrations/notion/youtube-channel-description)
- [OpenClaw](https://spiral.ai/integrations/openclaw/youtube-channel-description)
- [opencode](https://spiral.ai/integrations/opencode/youtube-channel-description)
- [Perplexity](https://spiral.ai/integrations/perplexity/youtube-channel-description)
- [Raycast](https://spiral.ai/integrations/raycast/youtube-channel-description)
- [VS Code](https://spiral.ai/integrations/vscode/youtube-channel-description)
- [Windsurf](https://spiral.ai/integrations/windsurf/youtube-channel-description)
- [Zapier](https://spiral.ai/integrations/zapier/youtube-channel-description)

## More Gemini guides

- [YouTube channel content search](https://spiral.ai/integrations/gemini/youtube-channel-content-search)
- [YouTube channel handle and links](https://spiral.ai/integrations/gemini/youtube-channel-handle-and-links)
- [YouTube channel community posts](https://spiral.ai/integrations/gemini/youtube-channel-community-posts)
- [YouTube channel information](https://spiral.ai/integrations/gemini/youtube-channel-information)
- [YouTube channel URL lookup](https://spiral.ai/integrations/gemini/youtube-channel-url-lookup)
- [YouTube channel live streams](https://spiral.ai/integrations/gemini/youtube-channel-live-streams)

## Questions about YouTube channel description in Gemini

**Can Gemini use YouTube channel description?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run YouTube channel description like any built-in tool.

**How much does YouTube channel description cost in Gemini?**

$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.

**Do I need a TikHub account to use YouTube channel description in Gemini?**

No. Spiral runs YouTube channel description on its own TikHub account. You sign in to Spiral once and never paste a key.

**How long does it take to set up YouTube channel description in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while YouTube channel description runs?**

YouTube channel description runs in the background. Gemini starts the run, checks on it and gives you the json when it's ready.

**Does YouTube search cover private and unlisted videos?**

Private videos do not appear in YouTube search. Unlisted videos also stay out of search unless someone adds them to a public playlist.

**How fresh are YouTube engagement counts?**

YouTube says metrics may take the first few hours after a video is published to appear. Counts on a new upload can therefore be incomplete.

**Is a YouTube handle the same as a channel name?**

Handles are unique identifiers that start with @ and are distinct from channel names. Each channel can have only one handle.

**Do older YouTube custom URLs still work?**

Existing custom URLs continue to work and redirect to the channel’s handle-based URL. YouTube no longer allows new custom URLs or changes to existing custom URLs.

**Is YouTube content available in every country?**

Video owners can restrict availability to certain countries or regions, usually for licensing reasons. YouTube can also block content to comply with local laws.

