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

Gemini · Social Media

How to Use Instagram popular topic posts in Gemini

Fetch an Instagram topic's description, sources, suggested terms, media count, and paginated posts. Use it to explore a topic and gather content examples beyond an exact hashtag.

Prompts to try with Instagram popular topic posts in Gemini

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

Use Instagram popular topic posts for basketball. Explain the topic description and suggested terms, then list the returned post examples.

Instagram popular topic postsGemini
Try asking
  • Scrape https://example.com/pricing with Instagram popular topic posts and turn it into a comparison table.

  • Crawl the docs at https://docs.example.com with Instagram popular topic posts and summarize each section.

  • Pull the latest posts from this blog with Instagram popular topic posts and list their titles and dates.

  • Scrape the job listings at https://example.com/careers with Instagram popular topic posts and give me a CSV.

How to set up Instagram popular topic 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 popular topic 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": "scrapecreators",
        "model": "scrapecreators/instagram-search-popular",
        "input": {
          "query": "basketball"
        }
      }'

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

Instagram popular topic posts providers and prices

Spiral runs Instagram popular topic posts through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
Instagram · Popular Search
scrapecreators/instagram-search-popular

What can you do with Instagram popular topic posts in Gemini?

Turn Instagram search results into a brand or topic research brief with concrete account matches and content examples. A chat app can explain which results come from account lookup, exact hashtag discovery, or Instagram topic pages.

Research a brand campaign

Find account and entity matches for Nike, inspect native profile matches, collect examples under #JustDoIt, and explore running topic posts. Turn the returned results into a campaign research brief.

Prepare a competitor discovery list

Search Patagonia and The North Face for account matches, review their associated hashtag examples, and explore outdoor topic posts. Keep account discovery and post examples distinct in the comparison.

Build an editorial research brief

Research specialty coffee through public business account matches, #SpecialtyCoffee posts, and coffee topic results. Use the account names and returned content to propose angles for an industry newsletter.

Prepare an event coverage brief

Find account matches for the Boston Marathon, collect #BostonMarathon post examples, and explore marathon topic posts. Assemble a source list for coverage of the public event.

Collect content examples for a creative brief

Compare #TrailRunning post captions with trail running topic results. Summarize recurring subjects and retain the returned post links as examples for an outdoor brand's creative team.

Questions about Instagram popular topic posts in Gemini

Can Gemini use Instagram popular topic posts?

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

How much does Instagram popular topic posts 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 popular topic posts in Gemini?

No. Spiral runs Instagram popular topic posts 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 popular topic 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 popular topic posts runs?

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

Does this search cover everything on Instagram?

No. Hashtag discovery covers Google-indexed public posts and explicitly excludes a complete hashtag feed; account search returns one page, while profile search has no pagination.

Why can a newly published post be missing?

Hashtag discovery depends on Google's index, and general search can also use a Google-indexed fallback. A post that has not entered that index is outside those results.

How far can I paginate Instagram searches?

Hashtag discovery stops at Google results page 11. General account search returns one page, profile search has no pagination, and topic posts continue using the previous response's cursor with the same query.

What is the difference between a topic and a hashtag?

Topic results include a description, sources, suggested terms, a media count, and posts. Hashtag discovery finds Google-indexed public posts containing an exact hashtag.

Can hashtag search supply reel view counts?

No. ScrapeCreators removed video_view_count and video_play_count from hashtag search after Instagram changed the public data available to search results.

Get started

Start using Instagram popular topic 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