[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [TikTok profile country](https://spiral.ai/integrations/gemini-cli/tiktok-profile-country)

# 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.

|  |  |
| --- | --- |
| Model | TikTok profile country |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok profile country in Gemini CLI

- Use TikTok profile country for @duolingo and add the returned region code to the brand record in this project.
- 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:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
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.

```bash
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.

```bash
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.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## TikTok profile country tools and prices

- [TikTok · Profile Region](https://spiral.ai/tools/scrapecreators/scrapecreators/tiktok-profile-region) (ScrapeCreators): Up to $0.0013 per run.

## 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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## TikTok profile country in other agents

- [Amp](https://spiral.ai/integrations/amp/tiktok-profile-country)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/tiktok-profile-country)
- [Claude](https://spiral.ai/integrations/claude-desktop/tiktok-profile-country)
- [Claude Code](https://spiral.ai/integrations/claude-code/tiktok-profile-country)
- [Cline](https://spiral.ai/integrations/cline/tiktok-profile-country)
- [Codex](https://spiral.ai/integrations/codex/tiktok-profile-country)
- [Cursor](https://spiral.ai/integrations/cursor/tiktok-profile-country)
- [Devin](https://spiral.ai/integrations/devin/tiktok-profile-country)
- [dots](https://spiral.ai/integrations/dots/tiktok-profile-country)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/tiktok-profile-country)
- [Gemini](https://spiral.ai/integrations/gemini/tiktok-profile-country)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/tiktok-profile-country)
- [goose](https://spiral.ai/integrations/goose/tiktok-profile-country)
- [Grok](https://spiral.ai/integrations/grok/tiktok-profile-country)
- [Grok Build](https://spiral.ai/integrations/grok-build/tiktok-profile-country)
- [Hermes](https://spiral.ai/integrations/hermes/tiktok-profile-country)
- [Instinct](https://spiral.ai/integrations/instinct/tiktok-profile-country)
- [Manus](https://spiral.ai/integrations/manus/tiktok-profile-country)
- [Muse](https://spiral.ai/integrations/muse/tiktok-profile-country)
- [Muse Code](https://spiral.ai/integrations/muse-code/tiktok-profile-country)
- [n8n](https://spiral.ai/integrations/n8n/tiktok-profile-country)
- [Notion](https://spiral.ai/integrations/notion/tiktok-profile-country)
- [OpenClaw](https://spiral.ai/integrations/openclaw/tiktok-profile-country)
- [opencode](https://spiral.ai/integrations/opencode/tiktok-profile-country)
- [Perplexity](https://spiral.ai/integrations/perplexity/tiktok-profile-country)
- [Raycast](https://spiral.ai/integrations/raycast/tiktok-profile-country)
- [VS Code](https://spiral.ai/integrations/vscode/tiktok-profile-country)
- [Windsurf](https://spiral.ai/integrations/windsurf/tiktok-profile-country)
- [Zapier](https://spiral.ai/integrations/zapier/tiktok-profile-country)

## More Gemini CLI guides

- [TikTok profile QR code](https://spiral.ai/integrations/gemini-cli/tiktok-profile-qr-code)
- [TikTok profile details](https://spiral.ai/integrations/gemini-cli/tiktok-profile-details)
- [TikTok photo search](https://spiral.ai/integrations/gemini-cli/tiktok-photo-search)
- [TikTok profile search](https://spiral.ai/integrations/gemini-cli/tiktok-profile-search)
- [TikTok music search](https://spiral.ai/integrations/gemini-cli/tiktok-music-search)
- [TikTok profile share link](https://spiral.ai/integrations/gemini-cli/tiktok-profile-share-link)

## 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.

