[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Instagram popular topic posts](https://spiral.ai/integrations/opencode/instagram-popular-topic-posts)

# How to Use Instagram popular topic posts in opencode

Fetch an Instagram topic's description, sources, suggested terms, media count, and paginated posts. Use it to explore a topic and gather content examples beyond an exact hashtag.

|  |  |
| --- | --- |
| Model | Instagram popular topic 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 popular topic posts in opencode

- Use Instagram popular topic posts for trail running. Create a Markdown brief with the topic description, sources, suggested terms, and returned posts.
- Scrape https://example.com/pricing with Instagram popular topic posts and turn it into a comparison table. Save the result in ./assets.
- Crawl the docs at https://docs.example.com with Instagram popular topic posts and summarize each section.
- Pull the latest posts from this blog with Instagram popular topic posts and list their titles and dates.
- Scrape the job listings at https://example.com/careers with Instagram popular topic posts and give me a CSV.

## How to set up Instagram popular topic posts in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 popular topic 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-search-popular",
    "input": {
      "query": "basketball"
    }
  }'
```

Then paste one of the prompts above: opencode finds Instagram popular topic posts on Spiral, shows the price and runs it.

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

## Instagram popular topic posts tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | The opaque cursor returned by the previous response. Use it with the same query to fetch the next page of posts. |

## What can you do with Instagram popular topic posts in opencode?

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.

### Collect content examples for a creative brief

Compare #TrailRunning post captions with trail running topic results. Summarize recurring subjects and retain the returned post links as examples for an outdoor brand's creative team.

## Overview

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

## Instagram popular topic posts in other agents

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

## More opencode guides

- [Instagram popular reels](https://spiral.ai/integrations/opencode/instagram-popular-reels)
- [Instagram post and reel details](https://spiral.ai/integrations/opencode/instagram-post-and-reel-details)
- [Instagram places by city](https://spiral.ai/integrations/opencode/instagram-places-by-city)
- [Instagram post and reel search](https://spiral.ai/integrations/opencode/instagram-post-and-reel-search)
- [Instagram place details](https://spiral.ai/integrations/opencode/instagram-place-details)
- [Instagram post comments](https://spiral.ai/integrations/opencode/instagram-post-comments)

## Questions about Instagram popular topic posts in opencode

**Can opencode use Instagram popular topic posts?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Instagram popular topic posts like any built-in tool.

**How much does Instagram popular topic posts cost in opencode?**

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

**Do I need a ScrapeCreators account to use Instagram popular topic posts in opencode?**

No. Spiral runs Instagram popular topic 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 popular topic posts in opencode?**

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

**Does opencode wait while Instagram popular topic posts runs?**

Instagram popular topic posts runs in the background. opencode 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.

