How to Use TikTok creator videos in Cursor
Fetch a TikTok creator's posts with captions, publication times, and engagement counts. Use it to discover posts and compare their performance across a creator's feed.
Prompts to try with TikTok creator videos in Cursor
Copy an example into Cursor, or ask in your own words.
Use TikTok creator videos for @duolingo and add a report to this project showing returned captions, publication times, views, and likes.
Use TikTok creator videos for @nasa and write a CSV of the retrieved posts with their captions, views, comments, and shares.
Use TikTok creator videos for @netflix and add a caption keyword filter to the project's content report.
Use TikTok creator videos for @nba and build a chart of posting intervals from returned publication times.
Use TikTok creator videos for @redbull and add a table ranking retrieved posts by shares per view, excluding posts with zero views.
How to set up TikTok creator videos 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 creator videos
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-videos", "input": { "handle": "stoolpresidente" } }'
Then paste one of the prompts above: Cursor finds TikTok creator videos on Spiral, shows the price and runs it.
TikTok creator videos providers and prices
Spiral runs TikTok creator videos through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Cursor for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Trim | on or off | Set to true for a trimmed down version of the response | |
| Sort by | latest or popular | What to sort by | |
| Include pinned | on or off | Whether to include pinned posts. Defaults to true. Set to false to exclude posts marked as pinned, including with trim=true. Keep this value unchanged while paginating. Filtering can produce shorter or empty pages; follow has_more and max_cursor. Successful pages still cost 1 credit, including empty results. |
Every API field of TikTok · Profile Videos is on its tool page: open its card above.
What can you do with TikTok creator videos in Cursor?
Build a TikTok content report in your project from returned captions, publication times, and engagement counts. Compare brand posts while making feed coverage limits visible in the report.
Compare brand post performance
Compare views, likes, comments, and shares across retrieved posts from competing brands to identify which posts deserve closer review.
Prepare a creator partnership brief
Review a public creator's post captions and performance before proposing a campaign. Ground the brief in specific returned posts.
Review campaign captions
Find campaign names and product mentions in a brand's returned captions, then compare engagement across matching posts.
Measure publishing cadence
Use returned publication times to calculate posting intervals and summarize activity within the retrieved sample.
Build an editorial research brief
Group a publisher's retrieved captions by topic and compare post performance to guide the next round of editorial research.
Track brand content performance over time
Compare repeated feed snapshots to measure changes in engagement for posts returned in both. Keep feed omissions separate from deletion claims.
Audit hashtag use
Extract hashtags from a brand's returned captions and compare engagement across posts using different tags.
More on TikTok creator videos and Cursor
Overview
TikTok creator videos in other agents
Questions about TikTok creator videos in Cursor
Can Cursor use TikTok creator videos?
Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run TikTok creator videos like any built-in tool.
How much does TikTok creator videos 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 creator videos in Cursor?
No. Spiral runs TikTok creator videos 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 creator videos in Cursor?
About two minutes: add the hosted server, then sign in.
Does Cursor wait while TikTok creator videos runs?
TikTok creator videos runs in the background. Cursor starts the run, checks on it and gives you the json when it's ready.
Which performance numbers can I compare?
Returned posts include counts for views, likes, comments, shares, and saves. These support comparisons between posts in the retrieved feed.
How fresh is the TikTok data?
ScrapeCreators describes the feed as real-time and says it fetches the latest available information when requested. It is an unofficial TikTok source.
Will pagination find every post?
No. The provider has verified feed omissions even after pagination finishes, and changing the feed country does not guarantee complete coverage. A missing post does not prove deletion.
Does an empty page mean there are no more posts?
Excluding pinned posts can leave a page empty while more results remain. Continue when the response indicates more pages are available.
Are captions the words spoken in the video?
Captions here are post descriptions, not speech transcripts. Original caption line breaks are preserved when TikTok supplies structured description data.
Start using TikTok creator videos 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


