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

Gemini · Social Media

How to Use Instagram highlight details in Gemini

Fetch an Instagram highlight's title, cover URL, owner details, and available photo and video stories. Use it to inspect a specific saved story collection, including media links and story timestamps, rather than just its profile cover.

Prompts to try with Instagram highlight details in Gemini

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

Find an available public highlight on @nike's Instagram profile, resolve its ID, and use Instagram highlight details to list its title, available cover link, and returned photo and video counts.

Instagram highlight detailsGemini
Try asking
  • Find an available public highlight on @sephora's Instagram profile, resolve its ID, and use Instagram highlight details to list any returned link sticker destinations by domain.

  • Resolve the ID of an available public highlight on @nasa's Instagram profile. Use Instagram highlight details to arrange the returned stories from oldest to newest and show their dates and media links.

  • Find an available public highlight on @patagonia's Instagram profile and resolve its ID. Use Instagram highlight details to summarize its photo and video mix and the durations available for its videos.

  • Resolve the ID of an available public highlight on @adidas's Instagram profile. Use Instagram highlight details to make a review table with the collection title, each returned story's date, and its image or video link.

How to set up Instagram highlight details 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 highlight details

    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": "scrapecreators",
        "model": "scrapecreators/instagram-user-highlight-detail",
        "input": {
          "id": "18067016518767507"
        }
      }'

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

Instagram highlight details providers and prices

Spiral runs Instagram highlight details through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Instagram · Highlights Details
scrapecreators/instagram-user-highlight-detail

What can you do with Instagram highlight details in Gemini?

Get a readable inventory of the photos, videos, and links in a public Instagram highlight. A chat app can organize the returned stories into a campaign timeline or summarize their media format mix.

Build a campaign story inventory

Turn a public brand highlight into a review table containing each returned story's media type, timestamp, and media links. Give campaign reviewers a concrete list of the available assets.

Audit product link destinations

Extract available link stickers from a brand's saved product stories. Group their destination URLs by domain and flag links that need a separate destination check.

Compare photo and video formats

Count returned photos and videos in selected public brand highlights. Compare the format mix and available video durations to plan a campaign's creative brief.

Reconstruct a campaign timeline

Sort the returned stories by their individual timestamps to review the sequence of campaign assets. Keep that timeline separate from the unavailable highlight creation date.

Review highlight naming and covers

Collect titles and available cover URLs from selected public business highlights. Use the inventory to review naming consistency and decide which covers need a visual check.

Detect changes in a saved campaign

Compare successive responses for a known public brand highlight. Report changes to its title, cover URL, returned story IDs, and available link destinations for editorial review.

Questions about Instagram highlight details in Gemini

Can Gemini use Instagram highlight details?

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

How much does Instagram highlight details cost in Gemini?

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

Do I need a ScrapeCreators account to use Instagram highlight details in Gemini?

No. Spiral runs Instagram highlight details 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 highlight details 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 highlight details runs?

Instagram highlight details runs in the background. Gemini starts the run, checks on it and gives you the json when it's ready.

Can I retrieve highlights from private Instagram accounts?

ScrapeCreators covers public data rather than private account content. Highlight details come from Instagram's public web source, so access is limited to what that source exposes.

How fresh are the highlight details?

ScrapeCreators says it fetches the latest available Instagram information when a request is made. That describes retrieval timing, without specifying a maximum delay between an Instagram edit and its appearance in the response.

Does the response include the highlight's creation date and total story count?

The current documentation says highlight created_at, media_count, and media_ids are omitted. Count the returned story items when you need the size of the retrieved collection; that is not a source-reported total.

Why are video fields empty on some stories?

The provider explicitly says image stories can have null video fields. The documented response contains both photo and video stories, so a photo does not need a video URL or video duration.

Are individual story dates still available?

The provider confirms that taken_at timestamps remain available after its source change. These belong to individual stories; the highlight's own creation timestamp is omitted.

Get started

Start using Instagram highlight details 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