How to Use TikTok profile country in Cursor
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 Cursor
Copy an example into Cursor, 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 Cursor
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to Cursor on the console's Agents & MCP page, or add this to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.
Use the Spiral skill
- Send Cursor 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: Cursor 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 Cursor?
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 Cursor
Overview
TikTok profile country in other agents
Questions about TikTok profile country in Cursor
Can Cursor use TikTok profile country?
Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run TikTok profile country like any built-in tool.
How much does TikTok profile country cost in Cursor?
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 Cursor plan is separate.
Do I need a ScrapeCreators account to use TikTok profile country in Cursor?
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 Cursor?
About two minutes: add the hosted server, then sign in.
Does Cursor wait while TikTok profile country runs?
TikTok profile country runs in the background. Cursor 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 Cursor
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Cursor:
set up https://spiral.ai/SKILL.md


