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

# How to Use Instagram video transcript in Gemini CLI

Get AI-generated speech text for an Instagram post or Reel, with each video's ID, shortcode, and timing segments when available. Use it to summarize spoken instructions, search dialogue, or review product claims.

|  |  |
| --- | --- |
| Model | Instagram video transcript |
| 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 video transcript in Gemini CLI

- Use Instagram video transcript on the public @nasa Reel URLs in this project's research list, then create a searchable index of the spoken explanations.
- Use Instagram video transcript for the public @lego video links in our campaign fixtures and generate a table of spoken product names with the source shortcode.
- Use Instagram video transcript on the public @ted Reel links in our content queue and add a topic summary beside each video's transcript.
- Use Instagram video transcript for the public @patagonia video URLs in our research file and collect passages that describe product care.
- Use Instagram video transcript on the public @duolingo Reel URLs in our sample dataset and build a review page showing opening dialogue and available phrase timing.

## How to set up Instagram video transcript 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 video transcript**: 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-media-transcript",
    "input": {
      "url": "<url>"
    }
  }'
```

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

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

## Instagram video transcript tools and prices

- [Instagram · Transcript](https://spiral.ai/tools/scrapecreators/scrapecreators/instagram-media-transcript) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cache_max_age | 1d, 3d, 7d, 14d, 30d | — | If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching) |

## What can you do with Instagram video transcript in Gemini CLI?

Build a searchable collection of spoken instructions from selected public Instagram videos. A coding agent can store each video's ID, shortcode, speech text, and available timing segments in your project's data model.

### Search spoken product details

Turn selected public brand Reels into searchable speech text so a team can find demonstrations, product names, and usage instructions.

### Summarize educational videos

Convert spoken explanations from selected public educational Reels into concise study notes with links to the source videos.

### Review spoken campaign claims

Extract product claims from public campaign videos and assemble passages for an editor to check against the original audio.

### Compare opening lines

Compare the opening spoken passages across a selected set of public creator or business Reels to study questions, demonstrations, and introductions.

### Draft notes from owned videos

Use speech from your business's Instagram videos to draft help articles, internal notes, or newsletter outlines for editorial review.

### Build a spoken mention digest

Check a supplied list of public business videos for spoken brand or product mentions and collect matching passages in a recurring report.

### Prepare an editing review

Use available phrase timing to locate passages in Instagram videos, then review the approximate positions against the audio before making cuts.

## Overview

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

## Instagram video transcript in other agents

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

## More Gemini CLI guides

- [Instagram username change count](https://spiral.ai/integrations/gemini-cli/instagram-username-change-count)
- [Kick clip details](https://spiral.ai/integrations/gemini-cli/kick-clip-details)
- [Instagram user, hashtag, and place search](https://spiral.ai/integrations/gemini-cli/instagram-user-hashtag-and-place-search)
- [Kick clip transcript](https://spiral.ai/integrations/gemini-cli/kick-clip-transcript)
- [Instagram user search](https://spiral.ai/integrations/gemini-cli/instagram-user-search)
- [Komi creator page](https://spiral.ai/integrations/gemini-cli/komi-creator-page)

## Questions about Instagram video transcript in Gemini CLI

**Can Gemini CLI use Instagram video transcript?**

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

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

No. Spiral runs Instagram video transcript 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 video transcript in Gemini CLI?**

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

**Does Gemini CLI wait while Instagram video transcript runs?**

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

**What Instagram content does the transcript endpoint cover?**

It transcribes videos in Instagram posts and Reels. ScrapeCreators documents public data extraction, so its coverage should not be read as access to private Instagram content.

**Does it return the caption written below the post?**

The returned text is generated from the video's audio. The author-written Instagram caption is a separate kind of text.

**Does it include timestamps?**

The current documentation includes phrase or sentence segments with start and end positions in seconds relative to each video. AI timing is approximate, and the timing field can be null when speech or timing is unavailable.

**Is every returned transcript newly generated?**

A response served from the cache comes from an earlier scrape. Its cached_at timestamp identifies when that copy was scraped.

**Can long Instagram videos fail to produce a transcript?**

Yes. The endpoint's current description explicitly warns that long videos may time out.

