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

Muse Code · Social Media

How to Use TikTok profile country in Muse Code

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 Muse Code

Copy an example into Muse Code, 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 countryMuse Code
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 Muse Code

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

Use Spiral's MCP server

  1. Install Muse Code
    curl -fsSL https://dev.meta.ai/install.sh | bash
  2. Ask Muse to add the server

    Start muse and ask:

    Add the Spiral MCP server at https://api.spiral.ai/mcp
  3. Sign in

    In your terminal, run:

    muse mcp login spiral

Use the Spiral skill

  1. Send Muse Code 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: Muse Code 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 Muse Code?

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 Muse Code

Can Muse Code use TikTok profile country?

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

How much does TikTok profile country cost in Muse Code?

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

Do I need a ScrapeCreators account to use TikTok profile country in Muse Code?

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 Muse Code?

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

Does Muse Code wait while TikTok profile country runs?

TikTok profile country runs in the background. Muse Code 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 Muse Code

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

Paste this into Muse Code:

Set up Muse Code

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