Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Social Media

How to Use Instagram Reels in Gemini CLI

Get a public account's reels with publication times, play counts, likes, comments, thumbnails, and video URLs. Use it to compare a brand's video performance or publishing pace; captions and pinned reels are excluded.

Prompts to try with Instagram Reels in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Instagram account reels for @nike and add a CSV export to this project's reporting script with shortcodes, publication times, plays, likes, and comments.

Instagram ReelsGemini CLI
Try asking
  • Use Instagram account reels for @duolingo and build a weekly publishing chart in this project from the last 90 days of returned reels, excluding pinned reels from the stated coverage.

  • Use Instagram account reels for @lego and add a thumbnail review table to this project's dashboard, sorted by available comment counts.

  • Use Instagram account reels for @redbull and update the project's collector to paginate through returned reels from the past 30 days and deduplicate them by shortcode.

  • Use Instagram account reels for @patagonia and write a comparison against the project's saved snapshot, showing changes in available play, like, and comment counts for matching shortcodes.

How to set up Instagram 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Instagram Reels

    One request; the result comes back by polling or a webhook.

    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-user-reels",
        "input": {
          "trim": false
        }
      }'

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

Instagram Reels providers and prices

Spiral runs Instagram Reels through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Instagram · Reels
scrapecreators/instagram-user-reels

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Trimon or off

Set to true for a trimmed down version of the response

Require play countson or offoff

Only the literal query value 'true' enables this check. It requires a numeric, nonnegative play_count on every returned Reel, in both full responses (items[].media.play_count) and trim=true responses (items[].play_count); a real 0 is valid. A missing, null, nonnumeric or negative play_count returns HTTP 503 without charging credits instead of a paid partial success. It does not require ig_play_count or view counts. With the default false, counts remain best-effort: usable reels are still billable even with missing play counts. This checks presence and numeric validity; it does not guarantee count accuracy or agreement with Instagram Insights. Retrying does not guarantee that Instagram will return the missing counts. Why counts can be missing.

Every API field of Instagram · Reels is on its tool page: open its card above.

What can you do with Instagram Reels in Gemini CLI?

Build a brand Reels report with publication times, thumbnails, and available engagement counts. A coding agent can add pagination and shortcode-based comparisons to your project's reporting code.

Compare brand video performance

Compare returned reels from Nike and Adidas using median plays, likes, and comments over the same publication window. Report how many reels have usable play counts.

Measure publishing cadence

Use publication times to count a brand's returned reels by week and identify gaps in its publishing schedule. Label the counts as excluding pinned reels.

Review a launch window

For a brand's known product launch date, compare plays, likes, and comments on returned reels published before and after launch. Use dates to define the window without assuming which reels promoted the product.

Build a creative review shortlist

Select a public brand's strongest returned reels by available plays or comments, then assemble their shortcodes and thumbnails for a human creative review.

Track changes in reel performance

Compare saved observations of the same reel shortcodes to measure changes in available play, like, and comment counts. Keep reels with unavailable counts out of play-growth rankings.

Create a media review inventory

Build a review table of a public business's returned reels with shortcodes, publication times, thumbnails, and available video URLs. Use it to organize an editorial or campaign audit.

Questions about Instagram Reels in Gemini CLI

Can Gemini CLI use Instagram Reels?

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

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

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

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

Does Gemini CLI wait while Instagram Reels runs?

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

Does this include every reel and its caption?

It retrieves public Instagram reels, but pinned reels and captions are excluded. That makes the results an incomplete inventory of an account's Reels content.

Why can play counts differ from Instagram's displayed totals?

Returned play counts exclude Facebook views, which matters for reels cross-posted to Facebook. ScrapeCreators also warns that play counts can be inaccurate.

Are play counts always available?

No. ScrapeCreators documents that a count can be available in one request and unavailable in the next, so repeated retrieval does not ensure consistent metric coverage.

How do I retrieve older reels?

Results are paginated. Use the continuation value returned by the previous response to request the next page.

How current are the results?

ScrapeCreators says it fetches the latest available Instagram information when you make a Reels request. That describes retrieval freshness, rather than a fixed daily or weekly update schedule.

Get started

Start using Instagram Reels in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options