[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Instagram User Tagged Posts](https://spiral.ai/integrations/gemini-cli/instagram-user-tagged-posts)

# How to Use Instagram User Tagged Posts in Gemini CLI

Fetch public posts that tag an Instagram account, including captions, media types, engagement counts, and media URLs. Use it to review a brand's Tagged tab and find content about its products.

|  |  |
| --- | --- |
| Model | Instagram User Tagged Posts |
| 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 User Tagged Posts in Gemini CLI

- Use Instagram tagged posts for @nike to collect up to 50 posts, then add a CSV export to this project with shortcode, caption, media type, and reported engagement counts.
- Use Instagram tagged posts for @lego to collect up to 30 posts and create a report in this repository grouping captions by explicitly named LEGO products.
- Use Instagram tagged posts for @patagonia to collect up to 40 posts and add a chart to this project comparing reported likes and comments by media type.
- Use Instagram tagged posts for @adidas to collect up to 50 posts and update this project's collector to deduplicate results by shortcode across runs.
- Use Instagram tagged posts for @gopro to collect up to 30 posts and build a review table in this project containing captions, media URLs, and engagement counts.

## How to set up Instagram User Tagged Posts 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 User Tagged Posts**: 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-tagged-posts",
    "input": {
      "user_id": "325734299"
    }
  }'
```

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

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

## Instagram User Tagged Posts tools and prices

- [Instagram · User Tagged Posts](https://spiral.ai/tools/scrapecreators/scrapecreators/instagram-user-tagged-posts) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | Cursor returned by the previous response. |

## What can you do with Instagram User Tagged Posts in Gemini CLI?

Build a brand-content report from Instagram tagged captions, media types, and engagement counts. A coding agent can add pagination and shortcode deduplication to the project so repeated collections produce a usable dataset.

### Review tagged campaign content

Filter returned captions for a campaign phrase or product name, then assemble matching posts and their engagement counts for a campaign review.

### Compare product conversations

Collect equal-sized samples from competing brands' Tagged tabs and compare product names and recurring caption themes within those samples.

### Find creative examples

Build a review list of tagged posts with captions and media URLs. Use the examples to prepare a creative brief for the brand's next campaign.

### Compare content formats

Separate a brand's returned tagged posts by media type and compare their reported likes and comments. Keep the findings scoped to the collected posts.

### Prepare a recurring brand digest

Compare retrieved post shortcodes with previous collections and summarize newly encountered tagged content, including its captions and engagement counts.

### Build a caption-based product feedback report

Extract explicit praise, complaints, and product-use descriptions from tagged captions. Include the supporting post shortcodes so reviewers can inspect the evidence.

## Overview

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

## Instagram User Tagged Posts in other agents

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

## More Gemini CLI guides

- [Instagram Search Reels](https://spiral.ai/integrations/gemini-cli/instagram-search-reels)
- [Instagram V1 Convert media ID to shortcode](https://spiral.ai/integrations/gemini-cli/instagram-v1-convert-media-id-to-shortcode)
- [Instagram Search Instagram Profiles](https://spiral.ai/integrations/gemini-cli/instagram-search-instagram-profiles)
- [Instagram V1 Get comment replies](https://spiral.ai/integrations/gemini-cli/instagram-v1-get-comment-replies)
- [Instagram Search Hashtag Posts](https://spiral.ai/integrations/gemini-cli/instagram-search-hashtag-posts)
- [Instagram V1 Get post by URL V2](https://spiral.ai/integrations/gemini-cli/instagram-v1-get-post-by-url-v2)

## Questions about Instagram User Tagged Posts in Gemini CLI

**Can Gemini CLI use Instagram User Tagged Posts?**

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

**How much does Instagram User Tagged Posts 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 User Tagged Posts in Gemini CLI?**

No. Spiral runs Instagram User Tagged Posts 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 User Tagged Posts in Gemini CLI?**

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

**Does Gemini CLI wait while Instagram User Tagged Posts runs?**

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

**Which Instagram posts does this return?**

It returns public posts from an account's Tagged tab. That coverage boundary makes it a source for tagged content, rather than a complete search of everything said about a brand.

**How many tagged posts can I retrieve at once?**

Each page contains up to 10 public posts. Larger collections require additional pages.

**How do I know when I have reached the end?**

Continue through the returned cursor until has_more is false. A single page represents only up to 10 posts, so it may cover just part of the available Tagged tab.

**What information comes with each tagged post?**

The documented output includes a shortcode, caption, media type, engagement counts, and media URLs. These support caption analysis, format comparisons, and a review list of tagged content.

**Does every tagged post have a view count?**

The documented response example has a null view count alongside numeric like and comment counts. A view total therefore cannot be assumed for every returned post.

