[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Instagram Search Instagram Profiles](https://spiral.ai/integrations/gemini-cli/instagram-search-instagram-profiles)

# How to Use Instagram Search Instagram Profiles in Gemini CLI

Get ranked account matches from Instagram's native search without Google results. Use it for account discovery; there is no pagination, and extra details for the first 10 matches are best-effort.

|  |  |
| --- | --- |
| Model | Instagram Search Instagram Profiles |
| 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 Search Instagram Profiles in Gemini CLI

- Use Instagram profile search for Patagonia. Add the ranked account matches to our research file and include available extra details.
- Scrape https://example.com/pricing with Instagram Search Instagram Profiles and turn it into a comparison table. Save the result in ./assets.
- Crawl the docs at https://docs.example.com with Instagram Search Instagram Profiles and summarize each section.
- Pull the latest posts from this blog with Instagram Search Instagram Profiles and list their titles and dates.
- Scrape the job listings at https://example.com/careers with Instagram Search Instagram Profiles and give me a CSV.

## How to set up Instagram Search Instagram Profiles 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 Search Instagram Profiles**: 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-search-profiles",
    "input": {
      "query": "fitness coach"
    }
  }'
```

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

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

## Instagram Search Instagram Profiles tools and prices

- [Instagram · Search Instagram Profiles](https://spiral.ai/tools/scrapecreators/scrapecreators/instagram-search-profiles) (ScrapeCreators): Up to $0.0013 per run.

## What can you do with Instagram Search Instagram Profiles in Gemini CLI?

Build a research table of Instagram account matches or post examples for a brand brief. A coding agent can write the returned results into project files and preserve the distinction between account discovery, exact hashtags, and topic posts.

### Research a brand campaign

Find account and entity matches for Nike, inspect native profile matches, collect examples under #JustDoIt, and explore running topic posts. Turn the returned results into a campaign research brief.

### Prepare a competitor discovery list

Search Patagonia and The North Face for account matches, review their associated hashtag examples, and explore outdoor topic posts. Keep account discovery and post examples distinct in the comparison.

### Build an editorial research brief

Research specialty coffee through public business account matches, #SpecialtyCoffee posts, and coffee topic results. Use the account names and returned content to propose angles for an industry newsletter.

### Prepare an event coverage brief

Find account matches for the Boston Marathon, collect #BostonMarathon post examples, and explore marathon topic posts. Assemble a source list for coverage of the public event.

### Review public business account matches

Compare search results for Blue Bottle Coffee, Stumptown Coffee, and Intelligentsia. Build a review table of returned account matches before choosing which businesses to research further.

## Overview

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

## Instagram Search Instagram Profiles in other agents

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

## More Gemini CLI guides

- [Instagram Search Hashtag Posts](https://spiral.ai/integrations/gemini-cli/instagram-search-hashtag-posts)
- [Instagram Search Reels](https://spiral.ai/integrations/gemini-cli/instagram-search-reels)
- [Instagram Reels search](https://spiral.ai/integrations/gemini-cli/instagram-reels-search)
- [Instagram User Tagged Posts](https://spiral.ai/integrations/gemini-cli/instagram-user-tagged-posts)
- [Instagram Reels by audio](https://spiral.ai/integrations/gemini-cli/instagram-reels-by-audio)
- [Instagram V1 Convert media ID to shortcode](https://spiral.ai/integrations/gemini-cli/instagram-v1-convert-media-id-to-shortcode)

## Questions about Instagram Search Instagram Profiles in Gemini CLI

**Can Gemini CLI use Instagram Search Instagram Profiles?**

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

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

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

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

**Does Gemini CLI wait while Instagram Search Instagram Profiles runs?**

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

**Does this search cover everything on Instagram?**

No. Hashtag discovery covers Google-indexed public posts and explicitly excludes a complete hashtag feed; account search returns one page, while profile search has no pagination.

**Why can a newly published post be missing?**

Hashtag discovery depends on Google's index, and general search can also use a Google-indexed fallback. A post that has not entered that index is outside those results.

**How far can I paginate Instagram searches?**

Hashtag discovery stops at Google results page 11. General account search returns one page, profile search has no pagination, and topic posts continue using the previous response's cursor with the same query.

**What is the difference between a topic and a hashtag?**

Topic results include a description, sources, suggested terms, a media count, and posts. Hashtag discovery finds Google-indexed public posts containing an exact hashtag.

**Can hashtag search supply reel view counts?**

No. ScrapeCreators removed video_view_count and video_play_count from hashtag search after Instagram changed the public data available to search results.

