[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [YouTube Search Typeahead](https://spiral.ai/integrations/gemini-cli/youtube-search-typeahead)

# How to Use YouTube Search Typeahead in Gemini CLI

Get live suggestions from YouTube's search dropdown, including suggested queries and channel matches with public identifiers. Use it to find search wording or recognize a suggested channel before researching published videos.

|  |  |
| --- | --- |
| Model | YouTube Search Typeahead |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with YouTube Search Typeahead in Gemini CLI

- Use YouTube search suggestions for 'Raspberry Pi'. Save the suggested text and suggestion type in this project's topic research file.
- Scrape https://example.com/pricing with YouTube Search Typeahead and turn it into a comparison table. Save the result in ./assets.
- Crawl the docs at https://docs.example.com with YouTube Search Typeahead and summarize each section.
- Pull the latest posts from this blog with YouTube Search Typeahead and list their titles and dates.
- Scrape the job listings at https://example.com/careers with YouTube Search Typeahead and give me a CSV.

## How to set up YouTube Search Typeahead 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 Search Typeahead**: 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": "scrapecreators",
    "model": "scrapecreators/youtube-search-typeahead",
    "input": {
      "query": "mr beast"
    }
  }'
```

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

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

## YouTube Search Typeahead tools and prices

- [YouTube · Search Typeahead](https://spiral.ai/tools/scrapecreators/scrapecreators/youtube-search-typeahead) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with YouTube Search Typeahead in Gemini CLI?

Build a YouTube research view for a specific topic, populated with returned video records or suggested searches. Your coding agent can turn that material into a reviewable table or topic taxonomy in the project.

### Plan a tutorial brief

Research Blender tutorials through suggested searches, keyword results, or #blender videos. Turn the returned wording and video titles into a shortlist of tutorial topics to review.

### Research product video topics

Explore Sony camera topics through search suggestions, product keyword results, or #sonyalpha videos. Organize the returned material into reviews, demonstrations, and tutorials for an editorial brief.

### Prepare an event research brief

Explore CES through suggested search phrases, keyword results, or #ces videos. Build a review queue of product announcements and event coverage using the returned text and links where available.

### Build a topic taxonomy

Use returned searches or video titles about Arduino to propose categories such as beginner projects, sensors, and troubleshooting. Review the actual returned wording before adding categories to a content library.

### Find public creator channels to review

Collect channels attached to returned Raspberry Pi videos, or inspect channel suggestions when YouTube supplies them. Produce a shortlist for a person to review for educational relevance.

## Overview

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

## YouTube Search Typeahead in other agents

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

## More Gemini CLI guides

- [YouTube Playlist](https://spiral.ai/integrations/gemini-cli/youtube-playlist)
- [YouTube Shorts search results](https://spiral.ai/integrations/gemini-cli/youtube-shorts-search-results)
- [YouTube Comments](https://spiral.ai/integrations/gemini-cli/youtube-comments)
- [YouTube Video comments Alexandria](https://spiral.ai/integrations/gemini-cli/youtube-video-comments-alexandria)
- [YouTube Channel shorts Alexandria](https://spiral.ai/integrations/gemini-cli/youtube-channel-shorts-alexandria)
- [YouTube Video details Alexandria](https://spiral.ai/integrations/gemini-cli/youtube-video-details-alexandria)

## Questions about YouTube Search Typeahead in Gemini CLI

**Can Gemini CLI use YouTube Search Typeahead?**

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

**How much does YouTube Search Typeahead cost in Gemini CLI?**

Up to $0.0013 per run. 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 ScrapeCreators account to use YouTube Search Typeahead in Gemini CLI?**

No. Spiral runs YouTube Search Typeahead on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up YouTube Search Typeahead in Gemini CLI?**

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

**Does Gemini CLI wait while YouTube Search Typeahead runs?**

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

**Can YouTube discovery find private videos?**

Private videos do not appear in YouTube's search results. These discovery tools cannot provide a complete inventory of a channel's private uploads.

**Does one response contain every matching YouTube video?**

Keyword and hashtag searches return result pages with continuation tokens for more results. Autocomplete returns suggested searches and channel matches, so it is not a video inventory.

**What information identifies a video result?**

Keyword and hashtag video results include a title, URL, thumbnail, and channel details. They also include public views, publication information, and duration.

**Where does YouTube look for hashtags?**

YouTube's hashtag results include videos carrying the hashtag in either the title or description. A hashtag does not have to appear visibly in the title to match.

**Are autocomplete matches always video titles?**

YouTube's dropdown can suggest queries or channels. Channel suggestions can include a public channel ID, handle, name, and thumbnail.

