[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [YouTube trending Shorts](https://spiral.ai/integrations/gemini-cli/youtube-trending-shorts)

# How to Use YouTube trending Shorts in Gemini CLI

Fetch about 48 YouTube Shorts with titles, links, channel details, publish dates, durations, and public engagement counts. Use it to discover content ideas across channels; repeat calls can return new Shorts.

|  |  |
| --- | --- |
| Model | YouTube trending Shorts |
| 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 trending Shorts in Gemini CLI

- Use YouTube trending Shorts to populate a review table in this project with titles, channel names, links, durations, and views. Highlight basketball examples for a Nike content brief.
- Use YouTube trending Shorts three times and add a deduplicated report to this project. Select cooking examples for a Tasty editorial review and include their public counts.
- Use YouTube trending Shorts to build a duration comparison report for science-related results relevant to NASA. Show titles, links, publish dates, and views.
- Use YouTube trending Shorts and add a title-format summary to this project's reporting page. Focus on soccer results for an adidas brief and link every example.
- Use YouTube trending Shorts to create a channel shortlist for a LEGO partnership review. Select relevant returned videos and show their titles, links, likes, and views.

## How to set up YouTube trending Shorts 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 trending Shorts**: 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-shorts-trending",
    "input": {}
  }'
```

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

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

## YouTube trending Shorts tools and prices

- [YouTube · Trending Shorts](https://spiral.ai/tools/scrapecreators/scrapecreators/youtube-shorts-trending) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with YouTube trending Shorts in Gemini CLI?

Build an editorial review table from YouTube Shorts titles, links, durations, and public counts. Your coding agent can add deduplication and topic comparisons to the project's reporting tools.

### Prepare a content planning brief

Collect Shorts relevant to basketball, cooking, or science from the returned results. Give editors example titles, links, durations, and public counts to inform original ideas.

### Build a creator discovery shortlist

Group relevant Shorts by public channel and shortlist creators for a partnership review. Include the videos that explain each choice.

### Compare video lengths

Compare durations and public engagement across Shorts about the same topic. Use the results to propose length tests for your next production cycle.

### Review title patterns

Sort returned titles into questions, challenges, demonstrations, and other editorial formats. Attach example links and counts so an editor can inspect the evidence.

### Maintain a discovery digest

Collect results on a schedule and remove previously seen video IDs. Summarize newly encountered Shorts for a public brand or creator's editorial team.

### Compare engagement within a batch

Calculate likes and comments per thousand views for returned Shorts with the required counts. Rank comparable topics to choose examples for a manual review.

## Overview

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

## YouTube trending Shorts in other agents

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

## More Gemini CLI guides

- [YouTube transcript](https://spiral.ai/integrations/gemini-cli/youtube-transcript)
- [YouTube video and Shorts details](https://spiral.ai/integrations/gemini-cli/youtube-video-and-shorts-details)
- [YouTube structured search results](https://spiral.ai/integrations/gemini-cli/youtube-structured-search-results)
- [YouTube video captions](https://spiral.ai/integrations/gemini-cli/youtube-video-captions)
- [YouTube signed playback URL](https://spiral.ai/integrations/gemini-cli/youtube-signed-playback-url)
- [YouTube video comment replies](https://spiral.ai/integrations/gemini-cli/youtube-video-comment-replies)

## Questions about YouTube trending Shorts in Gemini CLI

**Can Gemini CLI use YouTube trending Shorts?**

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

**How much does YouTube trending Shorts 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 trending Shorts in Gemini CLI?**

No. Spiral runs YouTube trending Shorts 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 trending Shorts in Gemini CLI?**

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

**Does Gemini CLI wait while YouTube trending Shorts runs?**

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

**How many Shorts does one call return?**

ScrapeCreators documents about 48 Shorts per request. Repeat calls can return new Shorts, so use that number as an approximate batch size.

**How fresh are the results?**

ScrapeCreators says it fetches the latest available YouTube information when requested. Its documentation also says repeat requests can return new Shorts.

**Does this include private creator analytics?**

The data covers public Shorts metadata and engagement counts. Private Studio measurements such as retention and viewed-versus-swiped-away are outside its scope.

**What does a Shorts view count measure?**

YouTube counts a view when a Short starts playing. A public view count therefore does not establish that viewers watched the whole video.

**Why might engagement counts stop changing?**

YouTube checks engagement for legitimacy and may temporarily slow, freeze, or revise counts. A fresh retrieval can still contain a counter that YouTube is validating.

