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.
- Skill ID
- apidojo-io/social-media-skills/tiktok-scraper
- Publisher
- apidojo-io
- Repository
- social-media-skills
- Installs
- 572
- Files
- 1
- Synced
- Oct 7, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
apidojo-io/social-media-skills/tiktok-scraperInstalls these files- SKILL.md
What this skill tells the agent
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-clientfrom 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-clientimport { ApifyClient } from "apify-client";
More from apidojo-io
Use this skill in a project
Open any RiverX project, search the Skills panel for apidojo-io/social-media-skills/tiktok-scraper, and install it in one click.
