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

# How to Use Instagram creator profile in Codex

Get an Instagram creator's bio, follower and media counts, verification status, account type, and niche classification. Use it to check a known creator's profile; audience demographics and growth curves are excluded.

|  |  |
| --- | --- |
| Model | Instagram creator profile |
| Available through | Alexandria |
| Category | Social Media |
| Price | Up to $0.087295 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Instagram creator profile in Codex

- Use Instagram creator profile for @gordonramsay and populate our internal review record with the returned bio, follower count, verification status, and niche.
- Use Instagram creator profile to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Instagram creator profile and tell me what changed since last week.
- Check Instagram creator profile and summarize what you find in three bullet points.
- Pull the newest data from Instagram creator profile and give me the result as a table.

## How to set up Instagram creator profile 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 creator profile**: 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": "alexandria",
    "model": "influencers-club/instagram/creator-enrich",
    "input": {
      "url": "<url>"
    }
  }'
```

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

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

## Instagram creator profile tools and prices

- [Influencers.club · Enrich Instagram creator](https://spiral.ai/tools/alexandria/influencers-club/instagram/creator-enrich) (Alexandria): Up to $0.087295 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| email_required | must_have, preferred | — | email required |

## What can you do with Instagram creator profile in Codex?

Build an internal creator research view with profile evidence, connected accounts, or recent Instagram content. Add the returned records to the project's existing review workflow so campaign decisions link back to public accounts and posts.

### Build a campaign shortlist

Find US outdoor creators, check their profiles, inspect recent posts and individual campaign examples, and map their connected accounts. Produce an internal shortlist with evidence for each recommendation.

### Review a creator before a partnership

Compare potential partners through search, verify profile information, review recent content, examine selected posts, and identify connected accounts. Give the partnership team a source-linked review of public creator activity.

### Research examples for a content brief

Discover cooking creators, use profile niches to narrow the list, and review recent recipe posts and selected reels. Include connected accounts as possible places to extend the campaign.

### Refresh an internal creator roster

Recheck partner profiles and connected accounts, review recent posts, and inspect selected content for the next campaign. Search for additional creators in the same market to keep the roster useful.

### Consolidate duplicate creator records

Check profile information and verified connected accounts before combining records in an internal partnership database. Use returned links as evidence rather than assuming matching usernames belong to the same creator.

## Overview

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

## Instagram creator profile in other agents

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

## More Codex guides

- [Instagram creator posts](https://spiral.ai/integrations/codex/instagram-creator-posts)
- [Instagram creator search](https://spiral.ai/integrations/codex/instagram-creator-search)
- [Instagram creator connected accounts](https://spiral.ai/integrations/codex/instagram-creator-connected-accounts)
- [Instagram detailed profile by username](https://spiral.ai/integrations/codex/instagram-detailed-profile-by-username)
- [Instagram comment translations](https://spiral.ai/integrations/codex/instagram-comment-translations)
- [Instagram hashtag posts](https://spiral.ai/integrations/codex/instagram-hashtag-posts)

## Questions about Instagram creator profile in Codex

**Can Codex use Instagram creator profile?**

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

**How much does Instagram creator profile cost in Codex?**

Up to $0.087295 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 an Alexandria account to use Instagram creator profile in Codex?**

No. Spiral runs Instagram creator profile on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Instagram creator profile in Codex?**

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

**Does Codex wait while Instagram creator profile runs?**

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

**Does Influencers.club include private Instagram information?**

Its creator database uses publicly available information from the public internet and data partners. The creator privacy notice says it does not collect information from behind a login or password wall.

**How often does Influencers.club refresh creator profiles?**

Influencers.club says every profile is revisited weekly, with faster-changing accounts checked more often. That is a profile refresh policy, not a promise that every post metric updates continuously.

**How many Instagram posts come back at once?**

Instagram creator posts returns a fixed page of 12 posts. The source does not allow a larger Instagram page size.

**Are audience demographics measured directly?**

Influencers.club describes audience figures as aggregate estimates extrapolated from public engagement signals. They describe the engaged audience rather than a complete census of everyone who follows an account.

**Why can engagement metrics be zero or missing?**

The source says a metric Instagram does not expose can return as zero or null. Hidden likes, views, or comments and platform visibility restrictions are documented causes.

