[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [YouTube video format details](https://spiral.ai/integrations/gemini-cli/youtube-video-format-details)

# How to Use YouTube video format details in Gemini CLI

Returns available video formats with quality labels, resolution, bitrate, and format IDs; media URL fields are empty. Use it to compare formats before requesting playback links.

|  |  |
| --- | --- |
| Model | YouTube video format details |
| 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 video format details in Gemini CLI

- Use YouTube video format details for https://www.youtube.com/watch?v=dQw4w9WgXcQ and build a table of returned format IDs, quality labels, resolutions, and bitrates.
- Use YouTube video format details to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from YouTube video format details and tell me what changed since last week.
- Check YouTube video format details and summarize what you find in three bullet points.
- Pull the newest data from YouTube video format details and give me the result as a table.

## How to set up YouTube video format details in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 video format details**: 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-video-streams",
    "input": {
      "video_id": "dQw4w9WgXcQ"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds YouTube video format details on Spiral, shows the price and runs it.

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

## YouTube video format details tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| video_id |  | — | Video ID |
| video_url |  | — | Ignored if video_id is provided) |

## What can you do with YouTube video format details in Gemini CLI?

Build a YouTube reference table or media format inspector from returned channel, video, or stream records. A coding agent can map those records into the project's UI and handle empty titles, paginated channel results, and expiring media links.

### Build an educational video catalog

Find public educational publishers, enrich a supplied list of lesson URLs with video descriptions and attribution, and record available media formats for lessons approved for reuse.

### Prepare a campaign reference pack

Find brand and public creator channels, document supplied campaign videos, and compare stream formats for footage the production team has permission to use.

### Compare media delivery options

Compare available resolutions, bitrates, and combined or separate audio/video formats for supplied public videos. Produce a format shortlist with playback or selected download links where needed.

### Prepare an approved media handoff

Attach video identity and publisher attribution to a media handoff, inspect available formats, and supply selected stream links with their expiration values and required headers.

### Investigate video ingestion failures

Check whether a supplied video has extractable metadata, inspect its available formats, and distinguish empty format URLs from expired playback links or download links tied to a different network exit.

## Overview

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

## YouTube video format details in other agents

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

## More Gemini CLI guides

- [YouTube video details with fallback extraction](https://spiral.ai/integrations/gemini-cli/youtube-video-details-with-fallback-extraction)
- [YouTube video playback links](https://spiral.ai/integrations/gemini-cli/youtube-video-playback-links)
- [YouTube video details and transcript](https://spiral.ai/integrations/gemini-cli/youtube-video-details-and-transcript)
- [YouTube video search](https://spiral.ai/integrations/gemini-cli/youtube-video-search)
- [YouTube video details](https://spiral.ai/integrations/gemini-cli/youtube-video-details)
- [YouTube video sponsor detection](https://spiral.ai/integrations/gemini-cli/youtube-video-sponsor-detection)

## Questions about YouTube video format details in Gemini CLI

**Can Gemini CLI use YouTube video format details?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run YouTube video format details like any built-in tool.

**How much does YouTube video format details cost in Gemini CLI?**

$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 CLI plan is separate.

**Do I need a TikHub account to use YouTube video format details in Gemini CLI?**

No. Spiral runs YouTube video format details 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 video format details in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while YouTube video format details runs?**

YouTube video format details runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does YouTube expose private videos publicly?**

Private videos and playlists are visible only to the owner and people the owner chooses. They do not appear in YouTube search results.

**How much does one YouTube channel search page cover?**

TikHub documents roughly 10–20 channels per page. Results exclude videos and playlists, and YouTube determines their order and quantity.

**How quickly do YouTube engagement counts appear?**

YouTube says metrics can take time to appear during the first few hours after publication. A newly published video's public counts may therefore lag its activity.

**Is a public YouTube video available in every country?**

No. Video owners can restrict availability to particular countries or regions, usually because of licensing rights.

**Are YouTube playback links permanent?**

TikHub documents a typical playback link lifetime of about six hours. An expired link needs to be generated again.

