[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Instagram profile post count](https://spiral.ai/integrations/codex/instagram-profile-post-count)

# How to Use Instagram profile post count in Codex

Fetch the post count for an Instagram profile, with scaled estimates possible when Instagram abbreviates large totals. Use it to compare public brand accounts or add a count to a report without collecting individual posts.

|  |  |
| --- | --- |
| Model | Instagram profile post count |
| 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 profile post count in Codex

- Use Instagram profile post count to fetch @nike's current total and add it to the brand record in this project, preserving whether the result is estimated.
- Use Instagram profile post count for @nike, @adidas, and @puma, then populate this project's comparison table with their returned totals.
- Use Instagram profile post count for @nasa and add today's result to the project's saved observations so we can compare future counts.
- Use Instagram profile post count to retrieve @natgeo's total and update the report component to display an estimate label when appropriate.
- Use Instagram profile post count for @patagonia and compare the result with its last saved count in this project; show the net change only when both counts are exact.

## How to set up Instagram profile post count in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

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

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 profile post count**: 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-profile-post-count",
    "input": {
      "handle": "lifestyleperfume"
    }
  }'
```

Then paste one of the prompts above: Codex finds Instagram profile post count on Spiral, shows the price and runs it.

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

## Instagram profile post count tools and prices

- [Instagram · Profile Post Count](https://spiral.ai/tools/scrapecreators/scrapecreators/instagram-profile-post-count) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| allow_estimated |  | — | Set to true to return scaled estimates when Instagram abbreviates counts for profiles with more than 10,000 posts. Defaults to false; false or omitted returns an uncharged 422 when only an estimate is available. |

## What can you do with Instagram profile post count in Codex?

Add Instagram post counts to a brand comparison tool or client reporting project. Keep exact and estimated totals distinct in the project's stored records and displayed results.

### Compare brand content totals

Compare the current profile post counts for Nike, Adidas, and Puma, with estimated totals clearly marked.

### Prepare a campaign baseline

Save a public brand account's post count before a campaign, then compare it with a later lookup to report the net change.

### Refresh an agency account report

Add current Instagram post counts to a report covering clients' public business accounts.

### Review public publisher accounts

Build a count comparison for National Geographic, NASA, and Smithsonian before deciding which accounts need a closer content review.

### Monitor changes in brand totals

Compare repeated lookups for a public brand account and flag increases or decreases for an analyst to review.

### Maintain a business account directory

Refresh the Instagram post-count column in a directory of public company accounts, preserving the distinction between exact and estimated totals.

## Overview

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

## Instagram profile post count in other agents

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

## More Codex guides

- [Instagram profile links and HD avatar by ID](https://spiral.ai/integrations/codex/instagram-profile-links-and-hd-avatar-by-id)
- [Instagram profile search](https://spiral.ai/integrations/codex/instagram-profile-search)
- [Instagram profile highlights](https://spiral.ai/integrations/codex/instagram-profile-highlights)
- [Instagram profile summary](https://spiral.ai/integrations/codex/instagram-profile-summary)
- [Instagram profile embed HTML](https://spiral.ai/integrations/codex/instagram-profile-embed-html)
- [Instagram profile with 12 recent posts](https://spiral.ai/integrations/codex/instagram-profile-with-12-recent-posts)

## Questions about Instagram profile post count in Codex

**Can Codex use Instagram profile post count?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Instagram profile post count like any built-in tool.

**How much does Instagram profile post count cost in Codex?**

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

**Do I need a ScrapeCreators account to use Instagram profile post count in Codex?**

No. Spiral runs Instagram profile post count 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 profile post count in Codex?**

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

**Does Codex wait while Instagram profile post count runs?**

Instagram profile post count runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**What does the Instagram post-count lookup return?**

It retrieves the post count for one Instagram profile. Use it when the number is the result you need, such as a public brand account's count in a comparison table.

**Are large Instagram post counts exact?**

Instagram may abbreviate counts above 10,000 posts. A returned scaled estimate represents that abbreviated total, so keep it labeled as an estimate in comparisons.

**How fresh is the Instagram count?**

ScrapeCreators says it fetches the latest information available when you make the request. That describes retrieval from Instagram at request time, rather than a published daily update schedule.

**What is the public-data boundary?**

ScrapeCreators describes its service as retrieving publicly available information on demand. Keep uses focused on public business and creator profiles.

**Can Instagram counts be included in a commercial report?**

ScrapeCreators permits commercial use, resale, redistribution, and repackaging of its output. Its terms also leave compliance with Instagram's terms and applicable laws to you.

