Spiral gives your agent every tool with one account. Browse the tools →

Codex · Social Media

How to Use Instagram account followers in Codex

Returns a paginated list of accounts following an Instagram account, with up to 100 accounts per call. Use it to check which known public organizations appear among a brand's returned followers.

Prompts to try with Instagram account followers in Codex

Copy an example into Codex, or ask in your own words.

Use Instagram account followers to look this up and give me the result as a table. Save the result in ./assets.

Instagram account followersCodex
Try asking
  • Pull the latest numbers from Instagram account followers and tell me what changed since last week.

  • Check Instagram account followers and summarize what you find in three bullet points.

  • Pull the newest data from Instagram account followers and give me the result as a table.

  • Check Instagram account followers every morning and tell me only when something changed.

How to set up Instagram account followers in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Instagram account followers

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "tikhub",
        "model": "tikhub/instagram-v3-get-user-followers",
        "input": {
          "username": "instagram"
        }
      }'

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

Instagram account followers providers and prices

Spiral runs Instagram account followers through TikHub. Open a card for today's price, with every fee included.

TikHubSocial Media
Instagram V3 · Get user followers list
tikhub/instagram-v3-get-user-followers

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Count1 to 10012

Number of users to fetch per request

Every API field of Instagram V3 · Get user followers list is on its tool page: open its card above.

What can you do with Instagram account followers in Codex?

Build an Instagram research view that puts retrieved posts or account records into your project's existing components. Turn captions, media, embeds, or public account context into reviewable examples for a brand research workflow.

Build a creator partnership shortlist

Start with similar-account recommendations and recommended Reels. Review public creators' biographies, account background, and connections to an approved list of organizations before choosing candidates for manual review.

Write a campaign performance brief

Compare selected campaign posts' captions and engagement counts, add embeds as examples, and summarize the publishing brand's profile. Check returned likers and followers only against a predefined list of public business accounts.

Map connections between public brands

Compare returned followers, followed accounts, and post likers against an approved roster of brands and organizations. Add similar-account suggestions, profile summaries, and account background for a business research map.

Prepare a weekly competitor digest

Revisit selected competitor posts, compare their engagement counts with prior observations, and prepare embeds for the report. Add creative examples from recommended Reels and review connections among a fixed roster of public companies.

Review your brand's public presence

Check your brand's profile summary, account background, and selected posts. Review returned follower, following, and liker lists against your public partner roster to prepare an internal account review.

Questions about Instagram account followers in Codex

Can Codex use Instagram account followers?

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

How much does Instagram account followers cost in Codex?

$0.0104 per request. 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 TikHub account to use Instagram account followers in Codex?

No. Spiral runs Instagram account followers on its own TikHub account. You sign in to Spiral once and never paste a key.

How long does it take to set up Instagram account followers in Codex?

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

Does Codex wait while Instagram account followers runs?

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

Does this cover private Instagram content?

TikHub describes its Instagram coverage as public data from public accounts. Private account content falls outside that coverage.

How fresh is the Instagram data?

TikHub describes the Instagram series used here as real-time and recommends it for up-to-the-minute counts. Its older visitor-view series can lag by a few days.

Why might engagement counts be lower than in Instagram?

TikHub says its results include Instagram engagement only. The app can show a combined Instagram and Facebook total.

Does access include permission to republish the content?

TikHub's terms state that retrieved content may carry third-party intellectual property rights. Retrieving a caption, photo, video, or embed does not establish ownership of that content.

Are the results guaranteed to be accurate and complete?

TikHub's terms explicitly disclaim a guarantee that returned data is accurate, complete, or current. Its description of this Instagram series as real-time is not a completeness warranty.

Get started

Start using Instagram account followers in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options