Scrape captions, music info, and engagement stats for thousands of TikTok videos or profiles in a single request.
What is TikTok MCP?
The TikTok MCP node creates a custom Gumloop node that understands Apify’s TikTok scraper. Instead of juggling endpoints and parameters, you simply type a natural language prompt and the node handles the API calls for you.What Can It Do for You?
- Uncover trending videos for any hashtag with full engagement metrics
- Audit a creator’s entire profile, including every public video and song used
- Export follower or following lists to enrich outreach or influencer research
- Pull deep analytics for a single TikTok video - likes, comments, shares, and more
Available Tools
Tool | What It Does | Example Use |
---|---|---|
Get Hashtag Videos | Returns videos for a given hashtag with caption, play count, likes, comments, shares, and author info | ”Get the 25 most recent #bouldering videos and return video_url, caption, like_count, play_count” |
Get Profile Videos | Retrieves all public videos posted by a username with full metadata, engagement stats, music details, and timestamps | ”Fetch @gymshark videos from the last 30 days, limit 50, return video_id, views, posted_date” |
Get Profile Followers | Lists followers or following for a profile with username, follower count, and bio text | ”Get the first 100 followers of username , return username, follower_count, bio” |
Get Video Details | Pulls comprehensive data for a specific video URL, including caption, stats, sound info, and upload time | ”Get details for TikTok Link , return caption, like_count, share_count, music_title” |
Search Videos | Searches TikTok by keyword and returns matching videos and author profiles | ”Search TikTok for ‘3 ingredient pancakes’, return top 10 results with video_url and author_username” |
Credit Costs
Tool | Credits Per Use |
---|---|
Get Hashtag Videos | 3 credits per item |
Get Profile Videos | 3 credits per item |
Get Profile Followers | 3 credits per item |
Get Video Details | 5 credits per item |
Search Videos | 3 credits per item |
How to Use
1
Create Your TikTok MCP Node
Go to your node library, search for TikTok, and click “Create a node with AI”
2
Add Your Prompt
Drag the TikTok node onto your canvas and describe the single action you want it to perform.
3
Test Your Node
Run the node to verify the output fields. Adjust the prompt or tool selection if needed.
4
Save and Reuse
Save the working TikTok node to your library so you can drop it into any future workflow.
Example Prompts
Hashtag InsightsStart with a small limit (10-20 items) when testing. Once you’re happy with the output, increase the limit for larger scrapes.
Troubleshooting
Use these tips to fine-tune your TikTok node and get the results you want.Keep Prompts Simple and Specific
- Good: “Get the top 10 #startups videos and return video_url, like_count”
- Less Efficient: “Find trending #startups videos, summarize each caption, and post them to Slack”
For best results, create one TikTok node to pull the data, then connect additional nodes for summarizing or posting to Slack.
Match What TikTok Can Do
- Good: “Search TikTok for ‘budget meal prep’ and return 5 video URLs”
- Less Efficient: “Search TikTok, then create an SEO blog post from the results”
TikTok MCP excels at data retrieval. Pair it with an Ask AI node for content generation or analysis.
Break Complex Tasks Into Steps
Trying to do everything in one prompt might cause timeouts or unexpected errors:1
Step 1: Get Videos
Get the 100 most recent #ai videos and return video_id, caption
2
Step 2: Extract Data
Using captions, extract any company info using Extract Data node
3
Step 3: Write Data to Google Sheet
Write data to a spreadsheet using the Google Sheet Writer node
Connect these nodes sequentially in your workflow. The video IDs from Step 1 feed into Step 2, and so on.
Focus on Data Retrieval
TikTok MCP is great at getting information from TikTok. For analysis or long-form content, combine it with other nodes. Example:- Good prompt: “Get profile followers for @mrbeast and return username”
- Less Efficient: “Get followers for @mrbeast and write a 500-word report on fan demographics”
Use Ask AI for summaries and reports. Keep TikTok prompts focused on pulling the raw data.
Troubleshooting Node Creation
Empty Outputs
Empty Outputs
In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
Incorrect Results
Incorrect Results
In the node creation window, click “Request changes” and describe what you expected versus what you received.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
Iterate with Request Changes
Iterate with Request Changes
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support
- View the TikTok MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com