n8n-nodes-tiktok-scraper

An n8n community node that scrapes TikTok profile posts using Puppeteer.
Supports video and photo posts, profile counters (followers / following / likes), cookies, proxy, concurrency, and anti-CAPTCHA-friendly pacing.

Note: Puppeteer requires a running Chromium/Chrome instance. It may not work on n8n Cloud — self-hosting is recommended.

---

Features

• Scrape a profile grid for video, photo, or all post types
• Per-item fields: type_post, video_id, view/like/comment/share/save counts, caption, hashtags, music, duration
• Timestamp extracted from the TikTok video ID as a fallback (works even when DOM metadata is unavailable)
• Profile counters (followers, following, likes) attached to every output item
• Optional profile summary item emitted at the start of output
• Configurable cookies, proxy URL, custom User-Agent, extra HTTP headers, and viewport
• Block Media mode: skips images, fonts, stylesheets, and media during scrolling for faster execution
• Per-item retry with exponential backoff

---

Installation

From the n8n UI (Community Nodes)

1. Go to Settings → Community Nodes → Install
2. Enter the package name: n8n-nodes-tiktok-scraper-byminhducdev
3. After installation, search for TikTok Scraper in the node panel.

If "Community Nodes" is not visible, set the environment variable:
N8N_COMMUNITY_PACKAGES_ENABLED=true

Via custom extensions folder (self-hosted)

export N8N_CUSTOM_EXTENSIONS=/path/to/extensions
cd $N8N_CUSTOM_EXTENSIONS
npm i n8n-nodes-tiktok-scraper-byminhducdev
# restart n8n; the node will appear automatically

---

Requirements

• Node.js >= 20.15
• A runtime that can launch Chromium or Chrome for Puppeteer
• Docker: increase shared memory to avoid Chrome crashes — shm_size: "1gb"

---

Node Parameters

Required

Parameter	Description
Username	TikTok handle without @ (e.g. tiktok)

Core Options

Parameter	Default	Description
Max Videos	100	Maximum posts to scrape. 0 = unlimited
Post Type	All	All, Video, or Photo
Concurrency	4	Number of post tabs opened in parallel (1–10)
Per-Video Delay (MS)	500	Base delay between post scrapes in ms
Headless	True	Chromium headless mode: True, New, or False
Timeout (MS)	45000	Navigation and selector wait timeout
Hard Scroll Timeout (MS)	600000	Maximum total time allowed for profile scrolling
User Agent	(random)	Override the default browser User-Agent string

Additional Options

Parameter	Default	Description
Block Media (Faster)	true	Block images, media, fonts, and stylesheets during scrolling
Cookies (JSON Array)	—	Browser session cookies as a JSON array (see example below)
Emit Profile Summary	false	Prepend a summary item with follower/like/following counts
Executable Path	—	Custom Chrome/Chromium binary path
Extra Headers	—	Additional HTTP headers (key/value pairs)
Proxy URL	—	e.g. http://user:pass@host:port
Retries	2	Retry attempts per post on failure (0–10)
Viewport Width / Height	1366 × 768	Browser viewport dimensions

Cookies example

[
  { "name": "ttwid", "value": "...", "domain": ".tiktok.com", "path": "/", "httpOnly": true, "secure": true },
  { "name": "sid_tt", "value": "...", "domain": ".tiktok.com", "path": "/", "httpOnly": true, "secure": true }
]

---

Output Schema

Each output item contains:

{
  "video_id": "7345678901234567890",
  "type_post": "video",
  "url": "https://www.tiktok.com/@user/video/7345678901234567890",
  "caption": "Sample caption #tag",
  "created_at": "2024-05-01T12:34:56.000Z",
  "created_at_ts": 1714566896,
  "views": 1200,
  "views_grid": 1200,
  "likes": 150,
  "comments": 12,
  "shares": 3,
  "saves": 0,
  "duration": 17,
  "author_username": "user",
  "music_title": "Track",
  "music_author": "Artist",
  "hashtags": ["tag"],
  "profile_following": 827,
  "profile_followers": 70700,
  "profile_likes": 321600
}

Numeric fields default to 0 when the source value is missing or null.

When Emit Profile Summary is enabled, a summary item is prepended:

{
  "username": "user",
  "profile_following": 827,
  "profile_followers": 70700,
  "profile_likes": 321600,
  "scraped_videos": 50
}

---

Anti-CAPTCHA Tips

• Provide valid cookies from a real Chrome session (logged in, any CAPTCHA already solved)
• Use a residential proxy from the same country as your cookies
• Set Concurrency to 1 and Per-Video Delay to 1200–2000 ms
• Keep Block Media enabled
• Set Accept-Language via Extra Headers to match your region, e.g. vi-VN,vi;q=0.9,en-US,en;q=0.8
• Use a realistic, consistent User Agent

---

Docker Example

services:
  n8n:
    image: n8nio/n8n:latest
    environment:
      N8N_COMMUNITY_PACKAGES_ENABLED: "true"
      N8N_CUSTOM_EXTENSIONS: /custom
      PUPPETEER_EXECUTABLE_PATH: /usr/bin/chromium
      TZ: Asia/Ho_Chi_Minh
    volumes:
      - ./custom:/custom
      - ./n8n_data:/home/node/.n8n
    shm_size: "1gb"

If your base image does not include Chromium, install it (e.g. via Debian/Ubuntu packages) and set PUPPETEER_EXECUTABLE_PATH to the binary path.

---

Troubleshooting

Error	Fix
CAPTCHA detected	Supply cookies, use a residential proxy, lower concurrency, increase delay
Navigation timeout exceeded	Increase Timeout (MS); verify proxy, cookies, and headers are valid
Chromium not found	Install Chromium or set Executable Path to the binary
No posts scraped	Profile may be private or the username is incorrect
Crashes on Docker	Add shm_size: "1gb" to your Compose service
Node not visible in n8n Cloud	Puppeteer is not supported on n8n Cloud; use a self-hosted instance

---

Development

npm run lint        # ESLint check
npm run build       # Compile TypeScript + copy icons
npm publish --access public

---

Disclaimer

This project is for educational and automation purposes. Use responsibly and in compliance with TikTok's Terms of Service and applicable local laws.

---

License

MIT