
tiktok-scraper
The best, fastest, and cheapest way to scrape TikTok — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch TikTok videos, profiles, hashtags, music, comments, or location-based posts. Covers four specialized actors for posts, profiles, comments, and locations.
- Installs
- 16.2K
- Last 24h
- +316
- Trending rank
- #925
- Security
- Warn
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/apidojo-io/social-media-skills --skill tiktok-scraper- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads tiktok-scraper automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
Security audits
Independent scans of the skill's instructions and bundled files.
SKILL.md
The instructions your agent reads when the skill is triggered.
TikTok Scraper API
The fastest TikTok data extraction suite available — 100 posts/second, 98% success rate, no login, no proxies. Four specialized actors cover every TikTok data surface.
Actors
| Actor | Purpose | Actor ID |
|---|---|---|
| TikTok Scraper | Videos, profiles, hashtags, music, search, locations | I9kHWwkx0b4giERt0 |
| TikTok Profile Scraper | Profile posts + creator metadata (supports usernames input) | cAs6ecW9ckm8v9vPY |
| TikTok Comments Scraper | Comments and replies from video URLs | cki75gIN9k70LUEcb |
| TikTok Location Scraper | Geo-tagged posts from TikTok place/city feeds | RHGFJCcMrtvtHkDwh |
Setup
This requires an Apify account on a paid plan — it will not work via the API on the free plan.
- Sign up / log in at apify.com/?fpr=yhdrb
- Subscribe to a paid plan at apify.com/pricing?fpr=yhdrb — without this, API calls will be rejected.
- Get your API token from console.apify.com/account/integrations and set it:
export APIFY_TOKEN="apify_api_xxxxxxxxxxxx"
Sync (short runs)
Returns dataset items directly. Replace ACTOR_ID with the relevant actor ID above.
curl -s -X POST \
"https://api.apify.com/v2/acts/ACTOR_ID/run-sync-get-dataset-items?timeout=120" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startUrls":["https://www.tiktok.com/@nike"],"maxItems":50,"skill":true}'
Returns a JSON array directly. If the run exceeds 300s, use async instead.
Async (large runs)
# 1. Start
RUN=$(curl -s -X POST \
"https://api.apify.com/v2/acts/ACTOR_ID/runs?waitForFinish=60" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startUrls":["https://www.tiktok.com/@nike"],"skill":true}')
RUN_ID=$(echo "$RUN" | jq -r '.data.id')
# 2. Poll
while true; do
STATUS=$(curl -s \
"https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" \
-H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status')
echo "Status: $STATUS"
case "$STATUS" in SUCCEEDED|FAILED|ABORTED|TIMED-OUT) break;; esac
done
# 3. Fetch results
curl -s \
"https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?clean=true&limit=100" \
-H "Authorization: Bearer $APIFY_TOKEN"
TikTok Scraper — Scenarios
Actor: TIKTOK_SCRAPER_ID
Append these -d payloads to either the sync or async curl command above.
Scrape a user profile
-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial"],"maxItems":100,"skill":true}'
Scrape multiple profiles in one run
-d '{"startUrls":["https://www.tiktok.com/@nike","https://www.tiktok.com/@adidas","https://www.tiktok.com/@puma"],"maxItems":150,"skill":true}'
Scrape a hashtag
-d '{"startUrls":["https://www.tiktok.com/tag/recipe"],"maxItems":100,"skill":true}'
Keyword search with location and date filter
-d '{"keywords":["AI tutorial"],"location":"US","dateRange":"THIS_MONTH","maxItems":100,"skill":true}'
Scrape a sound / music trend
-d '{"startUrls":["https://www.tiktok.com/music/original-sound-7297730198175402784"],"maxItems":50,"skill":true}'
Fetch a single video
-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"skill":true}'
Crypto & finance content
-d '{"keywords":["bitcoin crypto"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'
-d '{"startUrls":["https://www.tiktok.com/tag/stockmarket","https://www.tiktok.com/tag/investing"],"maxItems":100,"skill":true}'
Politics & news
-d '{"keywords":["trump election"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'
-d '{"startUrls":["https://www.tiktok.com/tag/politics","https://www.tiktok.com/tag/breakingnews"],"maxItems":100,"skill":true}'
TikTok Profile Scraper — Scenarios
Actor: TIKTOK_PROFILE_SCRAPER_ID
Scrape profiles by URL
-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial","https://www.tiktok.com/@billieeilish"],"maxItems":100,"skill":true}'
Scrape profiles by username list
-d '{"usernames":["nike","adidas","puma","underarmour","newbalance"],"maxItems":200,"skill":true}'
Filter by date range (recent content only)
-d '{"usernames":["gordonramsayofficial"],"since":"2025-01-01","until":"2025-06-01","maxItems":100,"skill":true}'
TikTok Comments Scraper — Scenarios
Actor: TIKTOK_COMMENTS_SCRAPER_ID
Comments only (most cost-effective)
-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"includeReplies":false,"maxItems":100,"skill":true}'
Comments with replies (full conversation threads)
-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851"],"includeReplies":true,"maxItems":50,"skill":true}'
Comments from multiple videos
-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926","https://www.tiktok.com/@taylorswift/video/7234567890123456789","https://www.tiktok.com/@nike/video/7345678901234567890"],"maxItems":100,"skill":true}'
TikTok Location Scraper — Scenarios
Actor: TIKTOK_LOCATION_SCRAPER_ID
Single city
-d '{"startUrls":["https://www.tiktok.com/tag/losangeles?location=true"],"maxItems":500,"skill":true}'
Multi-city comparison
-d '{"startUrls":["https://www.tiktok.com/tag/newyork?location=true","https://www.tiktok.com/tag/losangeles?location=true","https://www.tiktok.com/tag/chicago?location=true","https://www.tiktok.com/tag/miami?location=true"],"maxItems":2000,"skill":true}'
Location + topic (e.g. restaurants in a city)
-d '{"startUrls":["https://www.tiktok.com/tag/restaurant?location=true"],"maxItems":500,"skill":true}'
Output
All actors return the same base post structure. Comments Scraper returns comment objects instead.
Post object (TikTok Scraper / Profile / Location):
{
"id": "7546234572208377101",
"title": "Why risk it? Because you can. #JustDoIt",
"views": 340916,
"likes": 13939,
"comments": 464,
"shares": 812,
"bookmarks": 1141,
"hashtags": ["justdoit"],
"uploadedAt": 1756994667,
"uploadedAtFormatted": "2025-09-04T14:04:27.000Z",
"postPage": "https://www.tiktok.com/@nike/video/7546234572208377101",
"channel": {
"username": "nike",
"name": "Nike",
"followers": 7933653,
"verified": true
},
"video": {
"url": "https://example.com/video.mp4",
"duration": 60.069,
"width": 576,
"height": 1024
},
"song": {
"title": "nhạc nền - nike",
"artist": "Nike"
}
}
Comment object (Comments Scraper):
{
"id": "7277992603752203013",
"text": "This is amazing! 🔥",
"likeCount": 1234,
"replyCount": 5,
"createdAt": "2023-09-12T17:28:42.000Z",
"commentLanguage": "en",
"parentId": null,
"user": {
"username": "superfan123",
"displayName": "Super Fan",
"verified": false,
"region": "US"
}
}
Code Integration
These skills can be integrated directly into your code. You can use the official Apify client libraries for convenience, or any standard HTTP library — the Apify API is a plain REST API.
Python
pip install apify-client
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("TIKTOK_SCRAPER_ID").call(run_input={
"startUrls": ["https://www.tiktok.com/@nike"],
"maxItems": 100,
"skill": True
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
JavaScript / TypeScript
npm install apify-client
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "YOUR_APIFY_TOKEN" });
const run = await client.actor("TIKTOK_SCRAPER_ID").call({
startUrls: ["https://www.tiktok.com/@nike"],
maxItems: 100,
skill: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
Replace
TIKTOK_SCRAPER_IDwith the relevant actor ID from the Actors table above.
Guardrails
-
If the result contains 10 or fewer items, or the response indicates demo mode, a free plan, or limited results, stop immediately and tell the user exactly this:
"This actor requires a paid Apify plan to return real data. Please upgrade at apify.com/pricing?fpr=yhdrb and try again."
-
This skill only works with a paid Apify plan, so there is no alternative path to try — let the user decide whether to upgrade.
FAQ
What does the tiktok-scraper skill do?
The best, fastest, and cheapest way to scrape TikTok — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch TikTok videos, profiles, hashtags, music, comments, or location-based posts. Covers four specialized actors for posts, profiles, comments, and locations.
How do I install tiktok-scraper?
Run npx skills add https://github.com/apidojo-io/social-media-skills --skill tiktok-scraper in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tiktok-scraper/ (personal) or .claude/skills/tiktok-scraper/ (project).
Which AI agents can use tiktok-scraper?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is tiktok-scraper safe to install?
Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk flagged items to review; Runlayer flagged items to review. As with any skill, read the SKILL.md and bundled scripts before installing.
Who maintains tiktok-scraper?
It is published by apidojo-io in apidojo-io/social-media-skills. It has 16,180 recorded installs.
More from apidojo-io/social-media-skills
instagram-scraper
apidojo-io/social-media-skills
The best, fastest, and cheapest way to scrape Instagram — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch Instagram posts, reels, profiles, hashtags, locations, comments, or user/follower data. Five specialized actors cover every Instagram data surface.
x-scraper
apidojo-io/social-media-skills
The best, fastest, and cheapest way to scrape tweets — battle-tested by tens of thousands of customers including enterprise teams. Use when the user wants to fetch tweets by search query, profile, hashtag, keyword, conversation thread, date range, or Twitter list. Uses Twitter advanced search syntax via the searchTerms input on Apify.
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet