[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Instagram popular reels](https://spiral.ai/integrations/gemini-cli/instagram-popular-reels)

# How to Use Instagram popular reels in Gemini CLI

Find popular Instagram reels published within the last seven days, with captions, links, media, and available engagement counts. Use the sample to gather recent content examples and compare posts for an editorial brief.

|  |  |
| --- | --- |
| Model | Instagram popular reels |
| 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 Instagram popular reels in Gemini CLI

- Use Instagram popular reels to populate our project's editorial reference table with reel links, captions, publication dates, and available counts. Add a local caption filter for Nike mentions.
- Fetch Instagram popular reels and write a script that merges results by reel identifier into our existing research dataset. Flag captions mentioning Patagonia for editorial review.
- Use Instagram popular reels to create a CSV export of the returned links, account names, dates, and available engagement counts. Include a column indicating whether each caption mentions UFC.
- Fetch Instagram popular reels and add a comparison view to our content research project. Let editors highlight captions mentioning Adidas and sort the returned posts by available play counts.
- Use Instagram popular reels to generate a research report in our project for LEGO content planning. Select relevant returned captions, include their original links, and report if the sample has no relevant examples.

## How to set up Instagram popular reels 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 Instagram popular reels**: 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/instagram-reels-trending",
    "input": {}
  }'
```

Then paste one of the prompts above: Gemini CLI finds Instagram popular reels on Spiral, shows the price and runs it.

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

## Instagram popular reels tools and prices

- [Instagram · Trending Reels](https://spiral.ai/tools/scrapecreators/scrapecreators/instagram-reels-trending) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with Instagram popular reels in Gemini CLI?

Build a browsable reference list of recent Instagram reels inside your project's editorial tool. Use reel identifiers to merge overlapping batches and retain captions, links, dates, and available counts.

### Prepare an editorial brief

Turn returned captions and reel links into a shortlist of recent examples relevant to a brand's next content meeting.

### Compare caption approaches

Group the sample's captions by opening line, question, or call to action, with links to the original posts.

### Find brand mentions in the sample

Check returned captions for names such as Nike or Patagonia and list matching posts. Report when the sample contains no matches.

### Build a daily discovery digest

Compare successive batches by reel identifier and summarize newly encountered posts for an editorial team.

### Compare engagement within a batch

Place available play, like, and comment counts beside each returned reel to help editors choose examples for review.

### Maintain a research reference list

Save selected reel links, captions, publication dates, and account names as references for content planning.

## Overview

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

## Instagram popular reels in other agents

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

## More Gemini CLI guides

- [Instagram places by city](https://spiral.ai/integrations/gemini-cli/instagram-places-by-city)
- [Instagram popular topic posts](https://spiral.ai/integrations/gemini-cli/instagram-popular-topic-posts)
- [Instagram place details](https://spiral.ai/integrations/gemini-cli/instagram-place-details)
- [Instagram post and reel details](https://spiral.ai/integrations/gemini-cli/instagram-post-and-reel-details)
- [Instagram nearby location search](https://spiral.ai/integrations/gemini-cli/instagram-nearby-location-search)
- [Instagram post and reel search](https://spiral.ai/integrations/gemini-cli/instagram-post-and-reel-search)

## Questions about Instagram popular reels in Gemini CLI

**Can Gemini CLI use Instagram popular reels?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Instagram popular reels like any built-in tool.

**How much does Instagram popular reels 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 Instagram popular reels in Gemini CLI?**

No. Spiral runs Instagram popular reels on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Instagram popular reels in Gemini CLI?**

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

**Does Gemini CLI wait while Instagram popular reels runs?**

Instagram popular reels runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**What part of Instagram does this cover?**

Discovery uses Instagram's public Popular pages and current featured topics. The results are a sample of recent popular reels, rather than Instagram's official global trending ranking.

**How recent are the reels?**

The publication window is the last seven days. If Instagram supplies too few verified recent reels, the endpoint can return a 503 response.

**How many reels can I get?**

Each response contains up to 12 reels. Repeated calls can overlap, so they do not guarantee 12 additional posts.

**What information accompanies each reel?**

The documented output includes a reel link, caption, publication date, media URLs, available engagement counts, and account information. This provides post-level material for comparing the returned examples.

**Why can play counts be lower than the Instagram app shows?**

The provider returns public Instagram-side play counts and excludes Facebook views. Instagram's app can display a combined Instagram and Facebook total for a cross-posted reel.

