How to Use TikTok profile country in opencode
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 opencode
Copy an example into opencode, 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.
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 opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: opencode 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.
What can you do with TikTok profile country in opencode?
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.
More on TikTok profile country and opencode
TikTok profile country in other agents
Questions about TikTok profile country in opencode
Can opencode use TikTok profile country?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run TikTok profile country like any built-in tool.
How much does TikTok profile country cost in opencode?
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 opencode plan is separate.
Do I need a ScrapeCreators account to use TikTok profile country in opencode?
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 opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while TikTok profile country runs?
TikTok profile country runs in the background. opencode 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.
Start using TikTok profile country in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


