Skip to main content
@traceryn/tiktok-sdk is a lightweight TikTok SDK for Node.js. It fetches videos, users, comments, playlists, hashtags, sounds, and search data and returns them in a clean, structured shape.

​
How it works

  • The SDK talks to TikTok through web endpoints and structured responses.
  • Playwright is optional. It only helps when a browser-backed session makes sense.
  • This keeps setup light for normal use, so you don’t need a full browser to start.
  • Every call passes through a request pipeline (cache, queue, rate limiter, circuit breaker, proxy rotation, and retries). A multi-strategy ParserEngine then extracts TikTok’s embedded page data, and X-Bogus signing handles TikTok’s web API.

How the TikTok SDK works

A full walkthrough of the pipeline, parser, signing, proxies, and Playwright sessions.

​
What you can fetch

Videos

Video data from a TikTok link, trending videos, and videos a user liked.

Users

Profiles by username or URL, plus user search.

Comments

Comments from a video or post.

Hashtags, sounds, playlists

Hashtag stats, sound info and videos, and playlists.
See the full list in Methods.
This project is unofficial and depends on public endpoints and scraping behavior that may change at any time. Some features may require proxies, Playwright, or additional setup depending on your environment.

​
Disclaimer

This project is not affiliated with, endorsed by, or officially connected to TikTok or ByteDance. TikTok and related names, marks, logos, and images are trademarks of their respective owners. The SDK is provided for legitimate development use only. Use it at your own discretion and in accordance with TikTok’s terms and applicable laws.

Install the SDK

Install the package and make your first request.