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

Gemini · Social Media

How to Use Instagram creator posts in Gemini

Fetch recent Instagram posts with captions, media links, timestamps, and engagement metrics, in fixed pages of 12. Use it to review a creator's content and find posts worth examining individually.

Prompts to try with Instagram creator posts in Gemini

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

Use Instagram creator posts for @natgeo and summarize the subjects covered in the latest returned posts, with dates and links.

Instagram creator postsGemini
Try asking
  • Use Instagram creator posts to look this up and give me the result as a table.

  • Pull the latest numbers from Instagram creator posts and tell me what changed since last week.

  • Check Instagram creator posts and summarize what you find in three bullet points.

  • Pull the newest data from Instagram creator posts and give me the result as a table.

How to set up Instagram creator posts in Gemini

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

Use the Gemini connector

  1. Open Connected Apps

    On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

  2. Add Spiral as a custom app

    Under Custom apps, click Add a custom app and paste this MCP server URL:

    https://api.spiral.ai/mcp
  3. Sign in to Spiral and approve

    Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

Use the Spiral skill

  1. Send Gemini 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 creator posts

    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": "alexandria",
        "model": "influencers-club/instagram/creator-posts",
        "input": {
          "url": "<url>"
        }
      }'

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

Instagram creator posts providers and prices

Spiral runs Instagram creator posts through Alexandria. Open a card for today's price, with every fee included.

AlexandriaSocial Media
Influencers.club · Instagram creator posts
influencers-club/instagram/creator-posts

Settings you can ask for

Ask Gemini for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Counta number

count

Every API field of Influencers.club · Instagram creator posts is on its tool page: open its card above.

What can you do with Instagram creator posts in Gemini?

Turn Instagram creator data into a campaign shortlist or a content review with links to the evidence. Compare returned profile details, account links, or post metrics to answer a specific partnership question.

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.

Compare recent publishing activity

Review recent posts from public publishers such as National Geographic and NASA. Compare captions, publishing dates, and available engagement metrics, then examine individual posts that deserve a closer look.

Questions about Instagram creator posts in Gemini

Can Gemini use Instagram creator posts?

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

How much does Instagram creator posts cost in Gemini?

Up to $0.0139672 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.

Do I need an Alexandria account to use Instagram creator posts in Gemini?

No. Spiral runs Instagram creator posts 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 posts in Gemini?

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

Does Gemini wait while Instagram creator posts runs?

Instagram creator posts runs in the background. Gemini 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.

Get started

Start using Instagram creator posts in Gemini

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

Paste this into Gemini:

Set up Gemini

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