[Integrations](https://spiral.ai/integrations) › [Grok](https://spiral.ai/integrations/grok) › [Instagram Reels](https://spiral.ai/integrations/grok/instagram-reels)

# How to Use Instagram Reels in Grok

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.

|  |  |
| --- | --- |
| Model | Instagram 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 Reels in Grok

- Use Instagram account reels to compare @nike and @adidas over the past 30 days. Show median available plays, likes, and comments, plus the number of returned reels analyzed.
- Use Instagram account reels for @duolingo to show its five most-commented returned reels from the past 60 days, with shortcodes, publication dates, and thumbnails.
- Use Instagram account reels for @lego to count returned reels by week over the past eight weeks and identify the busiest publishing week.
- Use Instagram account reels for @redbull to rank returned reels from the past 14 days by available play counts and list any reels that could not be ranked.
- Use Instagram account reels for @patagonia to make a review table for the past 30 days with shortcodes, publication dates, thumbnails, likes, and comments.

## How to set up Instagram Reels in Grok

Pick the way that suits you. Each takes about two minutes.

### Use the Grok connector

1. **Add a custom connector**: In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

3. **Check that it is connected**: Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

### Use the Spiral skill

1. **Send Grok 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 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-user-reels",
    "input": {
      "trim": false
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/grok

## Instagram Reels tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| trim |  | — | Set to true for a trimmed down version of the response |
| handle |  | — | Instagram handle. Use user_id for faster response times. |
| max_id |  | — | Max id to get more reels. Get 'max_id' from previous response. |
| user_id |  | — | Instagram user id. Use this for faster response times. |
| require_play_counts |  | false | 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](https://scrapecreators.com/blog/instagram-play-counts-missing). |

## What can you do with Instagram Reels in Grok?

Compare public brands' reel performance in a table with plays, likes, comments, and publication dates. A chat assistant can explain the differences while identifying missing play counts and the exclusion of pinned reels.

### 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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Grok guides](https://spiral.ai/integrations/grok)

## Instagram Reels in other agents

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

## More Grok guides

- [Instagram Highlights list](https://spiral.ai/integrations/grok/instagram-highlights-list)
- [Instagram Reels by audio](https://spiral.ai/integrations/grok/instagram-reels-by-audio)
- [Instagram Get Reels By Audio Id](https://spiral.ai/integrations/grok/instagram-get-reels-by-audio-id)
- [Instagram Reels search](https://spiral.ai/integrations/grok/instagram-reels-search)
- [Instagram Explore sections](https://spiral.ai/integrations/grok/instagram-explore-sections)
- [Instagram Search Hashtag Posts](https://spiral.ai/integrations/grok/instagram-search-hashtag-posts)

## Questions about Instagram Reels in Grok

**Can Grok use Instagram Reels?**

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

**How much does Instagram Reels cost in Grok?**

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 Grok plan is separate.

**Do I need a ScrapeCreators account to use Instagram Reels in Grok?**

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 Grok?**

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

**Does Grok wait while Instagram Reels runs?**

Instagram Reels runs in the background. Grok 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.

