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

Gemini CLI · Social Media

How to Use TikTok Followers in Gemini CLI

Returns a TikTok account's follower list with usernames, country regions, bios, and avatar URLs. Use it to study a public brand or creator's audience composition and compare the records returned across accounts.

Prompts to try with TikTok Followers in Gemini CLI

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

Use TikTok account followers for @duolingo and add a script to this project that counts returned country regions and exports an aggregate CSV.

TikTok FollowersGemini CLI
Try asking
  • Use TikTok account followers for @nike and @adidas, then build a comparison table in this project showing country shares and the number of follower records analyzed.

  • Use TikTok account followers for @redbull and add a report that groups explicit bio topics into sports categories, with an uncategorized bucket and aggregate counts.

  • Use TikTok account followers for @netflix and implement a collector that follows min_time from each response, deduplicates usernames, and summarizes country regions.

  • Use TikTok account followers for @gymshark and create a review table of returned accounts whose bios explicitly identify a business or professional creator, including the supporting bio text.

How to set up TikTok Followers in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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 TikTok 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": "scrapecreators",
        "model": "scrapecreators/tiktok-user-followers",
        "input": {
          "trim": false
        }
      }'

Then paste one of the prompts above: Gemini CLI finds TikTok Followers on Spiral, shows the price and runs it.

TikTok Followers providers and prices

Spiral runs TikTok Followers through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
TikTok · Followers
scrapecreators/tiktok-user-followers

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Trimon or off

Set to true to get a trimmed response

Min timea number

Used to paginate. Get 'min_time' from previous response.

Every API field of TikTok · Followers is on its tool page: open its card above.

What can you do with TikTok Followers in Gemini CLI?

Build an audience report that groups a public TikTok brand's returned followers by country region and bio topic. A coding agent can add pagination and aggregation to your project using the returned follower records.

Audience country breakdown

Count returned country regions for a public brand's followers to prepare a market research brief. Show the number of records analyzed alongside each percentage.

Competitor audience comparison

Compare the country mix in follower results for public brands such as Nike and Adidas. Use the comparison to form regional content hypotheses for further testing.

Content topic research

Summarize recurring topics explicitly mentioned in returned follower bios. Report aggregate themes that could inform a public brand's content calendar.

Business partnership research

Review returned usernames and bios for accounts that explicitly represent businesses or professional creators. Build a candidate list for manual partnership review, with the supporting business description.

Localization planning

Use the country regions in a public brand's returned follower records to prioritize markets for translation research. Keep the recommendation tied to the records analyzed.

Recurring audience reports

Collect follower results for a public brand on a regular schedule and compare aggregate country shares and bio topics. Present changes in the collected samples without identifying individual followers.

Questions about TikTok Followers in Gemini CLI

Can Gemini CLI use TikTok Followers?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run TikTok Followers like any built-in tool.

How much does TikTok Followers cost in Gemini CLI?

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

Do I need a ScrapeCreators account to use TikTok Followers in Gemini CLI?

No. Spiral runs TikTok Followers on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up TikTok Followers in Gemini CLI?

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

Does Gemini CLI wait while TikTok Followers runs?

TikTok Followers runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

What does TikTok follower data contain?

The provider lists follower usernames, country regions, avatar URLs, and biographies. These are follower records you can summarize into audience reports.

How fresh is the TikTok data?

ScrapeCreators says it fetches the latest available TikTok information when you make a request. That is its stated freshness behavior, rather than a daily or weekly publication schedule.

How do I retrieve additional followers?

The endpoint documents pagination using min_time from the previous response. Continue with that returned value to request additional results.

Will follower avatar links keep working?

The provider explicitly says avatar URLs expire after a while. Its guide does not specify how long they remain valid.

Does the source cover private TikTok accounts?

ScrapeCreators describes its coverage as public social media accounts. Private-account access is outside that stated coverage.

Get started

Start using TikTok Followers in Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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