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

Gemini CLI · Social Media

How to Use TikTok profile country in Gemini CLI

Returns the country or region code for a public TikTok profile, such as US or MX. Use it to add a region label to a brand account or public creator shortlist.

Prompts to try with TikTok profile country in Gemini CLI

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

Use TikTok profile country for @duolingo and add the returned region code to the brand record in this project.

TikTok profile countryGemini CLI
Try asking
  • Use TikTok profile country for @nike and @adidas, then build a comparison table in this project's brand research view.

  • Use TikTok profile country for @gymshark and compare the returned code with its stored region label in our campaign data.

  • Use TikTok profile country for @khaby.lame and @zachking, then create a CSV containing each public creator's username and returned region code.

  • Use TikTok profile country for @ryanair, @duolingo, and @netflix, then add a count of these brand profiles by returned region code to our report.

How to set up TikTok profile country 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 profile country

    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-profile-region",
        "input": {
          "handle": "stoolpresidente"
        }
      }'

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

TikTok profile country providers and prices

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

ScrapeCreatorsSocial Media
TikTok · Profile Region
scrapecreators/tiktok-profile-region

What can you do with TikTok profile country in Gemini CLI?

Add TikTok profile region labels to a creator roster or brand comparison in your project. A coding agent can fetch the codes and build a comparison against your existing campaign records.

Label a creator shortlist

Add returned TikTok region codes to a shortlist of public creators so a campaign planner can compare profiles by region.

Compare brand accounts

Build a table of TikTok region codes for competing brands, keeping profile region separate from company headquarters.

Check campaign records

Compare returned profile region codes with the region labels already stored in a campaign roster and send mismatches for review.

Review brand region changes

Repeat lookups for public brand accounts and compare the codes with earlier saved results to identify changes for review.

Summarize a partnership roster

Count public creator profiles by returned region code to show the regional composition of a proposed partnership roster.

Add region context to a report

Include the returned TikTok profile country code beside each public brand or creator discussed in a research report.

Questions about TikTok profile country in Gemini CLI

Can Gemini CLI use TikTok profile country?

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

How much does TikTok profile country 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 profile country in Gemini CLI?

No. Spiral runs TikTok profile country 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 profile country in Gemini CLI?

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

Does Gemini CLI wait while TikTok profile country runs?

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

Which TikTok profiles does this cover?

The documented scope is public TikTok profiles. The result is a country or region code, with US for the United States and MX for Mexico as examples.

Does the profile country tell me where its followers live?

A profile region code describes the profile. ScrapeCreators supplies follower countries through its separate audience demographics endpoint, so the profile code cannot establish a US or Mexican audience share.

How fresh is the region result?

ScrapeCreators says it fetches the latest available profile region information from TikTok when you make a request.

Is the country code guaranteed to be accurate?

ScrapeCreators explicitly declines to guarantee data accuracy or availability. A returned US or MX code should therefore be treated as the retrieved profile region, without presenting it as independently verified.

Can I include these region labels in a commercial report?

ScrapeCreators permits commercial use, resale, redistribution, repackaging, and white-labeling of API output. Its terms also make you responsible for complying with the source website's terms, policies, and applicable laws.

Get started

Start using TikTok profile country 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