@traceryn/tiktok-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Corex Anthony
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,276 @@
+<img src="https://raw.githubusercontent.com/Traceryn/tiktok-sdk/master/media/Traceryn.png" alt="Traceryn logo" width="320" />
+
+# ***Traceryn/Tiktok-sdk***
+A lightweight TikTok SDK for Node.js that makes it easier to fetch videos, users, comments, playlists, hashtags, and other TikTok data in a clean, structured way.
+
+## Disclaimer
+
+> [!CAUTION]
+> 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.
+>
+> This SDK is provided for legitimate development use only. Use it at your own discretion and in accordance with TikTok's terms and applicable laws.
+
+## How it works
+
+- This SDK talks to TikTok through web endpoints and structured responses.
+- Playwright is optional and only helps when a browser-backed session makes sense.
+- That keeps the setup lighter for normal use and avoids needing a full browser just to start.
+- It supports videos, users, comments, hashtags, playlists, sounds, and search data.
+
+> [!IMPORTANT]
+> This project is an unofficial TikTok SDK 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. Use responsibly and make sure your usage follows TikTok's terms and applicable laws.
+
+> [!IMPORTANT]
+> Some endpoints (`searchUsers`, `getSound`, `getSoundVideos`) are blocked by Akamai WAF from datacenter IPs. Pass `--session` to use a Playwright browser session that bypasses WAF.
+>
+> ```sh
+> npm install playwright
+> node docs/examples/getComments.cjs --session
+> ```
+
+> [!IMPORTANT]
+> For deployment, use a VPS or another long-running server. This project runs into IP restrictions and blocks on most serverless hosts, so only a few platforms will work reliably. Vercel is a bad fit here, and Render only makes sense if you're using a service that stays up as a real web process.
+
+## Install
+
+### Stable release
+
+```sh
+npm install @traceryn/tiktok-sdk
+```
+
+```sh
+yarn add @traceryn/tiktok-sdk
+```
+
+### From GitHub
+
+```sh
+npm install git+https://github.com/traceryn/tiktok-sdk.git
+```
+
+```sh
+yarn add git+https://github.com/traceryn/tiktok-sdk.git
+```
+
+### Optional: Playwright
+
+```sh
+npm install playwright
+```
+
+```sh
+yarn add playwright
+```
+
+## Then import your code using:
+
+```ts
+import { TikTokClient } from '@traceryn/tiktok-sdk';
+
+const client = new TikTokClient();
+```
+
+or
+
+```js
+const { TikTokClient } = require('@traceryn/tiktok-sdk');
+
+const client = new TikTokClient();
+```
+> [!NOTE]
+> Check the [examples](docs/examples) directory for runnable example scripts with the session pattern.
+
+### Main methods
+
+- `getVideo(url)` // get video data from a TikTok link
+- `getUser(usernameOrUrl)` // get user profile data
+- `getComments(videoUrl)` // get comments from a video or post
+- `searchUsers(query)` // search for users
+- `getHashtag(name)` // get hashtag stats
+- `getSound(musicId)` // get sound info
+- `getSoundVideos(musicId)` // get videos using a sound
+- `getTrendingVideos()` // get trending videos
+- `getUserLikedVideos(username)` // get videos a user liked
+- `getUserPlaylists(username)` // get playlists for a user
+- `getPlaylist(mixId)` // get one playlist
+- `getPlaylistVideos(mixId)` // get videos inside a playlist
+- `addProxies(proxies)` // add your own proxies
+- `getProxyStats()` // check proxy usage
+- `invalidateCache(url)` // clear one cached video
+- `clearCache()` // clear all cached video data
+
+## Examples
+
+### Basic usage
+
+```ts
+import { TikTokClient } from '@traceryn/tiktok-sdk';
+
+const client = new TikTokClient();
+
+const video = await client.getVideo('https://www.tiktok.com/@user/video/1234567890');
+console.log(video.title);
+```
+
+Gets one video and prints its title.
+
+### Other methods
+
+```ts
+const user = await client.getUser('tiktok');
+console.log(user.nickname);
+```
+
+Gets a user profile from a username or profile link.
+
+```ts
+const comments = await client.getComments('https://www.tiktok.com/@user/video/1234567890');
+console.log(comments.comments.length);
+```
+
+Gets the comments for a video or post.
+
+```ts
+const hashtag = await client.getHashtag('fyp');
+console.log(hashtag.stats.videoCount);
+```
+
+Gets hashtag info and the number of videos tied to it.
+
+```ts
+const search = await client.searchUsers('tiktok');
+console.log(search.users.length);
+```
+
+Searches for TikTok users by keyword.
+
+```ts
+const trending = await client.getTrendingVideos();
+console.log(trending.videos.length);
+```
+
+Gets the current trending videos.
+
+### Using Playwright session
+
+```js
+const { TikTokClient, PlaywrightSession } = require('@traceryn/tiktok-sdk');
+
+async function main() {
+	const useSession = process.argv.includes('--session');
+	let session;
+
+	if (useSession) {
+		session = new PlaywrightSession({ headless: true });
+		await session.init();
+	}
+
+	const client = new TikTokClient({ session });
+	const trending = await client.getTrendingVideos();
+
+	console.log(trending.videos.length);
+
+	if (session) await session.close();
+}
+
+main().catch((err) => {
+	console.error('Error:', err.message);
+	process.exit(1);
+});
+```
+
+### Settings
+
+```ts
+import { TikTokClient } from '@traceryn/tiktok-sdk';
+
+const client = new TikTokClient({
+	timeout: 15000, // keep requests from hanging too long
+	maxRetries: 2, // retry a couple times if TikTok flakes out
+	rateLimit: 3, // slow it down a bit
+	concurrency: 1, // keep it simple and steady
+	cacheTTL: 60_000, // cache results for a minute
+});
+```
+
+| Option | What you can change it to |
+| --- | --- |
+| `timeout` | Any number in milliseconds, like `5000`, `15000`, or `30000` |
+| `maxRetries` | Any whole number, like `0`, `2`, or `5` |
+| `rateLimit` | Any whole number, like `1`, `3`, or `10` |
+| `concurrency` | Any whole number, like `1`, `2`, or `4` |
+| `cacheTTL` | Any number in milliseconds, like `30000`, `60000`, or `300000` |
+| `proxy` | A single proxy URL or array, like `"http://user:pass@host:port"` |
+| `proxyRotation` | `"round-robin"`, `"random"`, or `"lowest-failures"` |
+
+You can also pass `session` if you want the Playwright path, or `proxy` / `proxyRotation` if you want to manage proxies a bit more directly.
+
+### IP throttling & proxies
+
+TikTok rate-limits endpoints based on IP. If a request returns an empty response or gets throttled after heavy use, the fix is to switch IP via a proxy.
+
+```sh
+node docs/examples/searchUsers.cjs --session --proxy=http://user:pass@host:port
+```
+
+You can also add proxies at runtime:
+
+```js
+client.addProxies(['http://user:pass@host:port', 'http://proxy2:port']);
+console.log(client.getProxyStats());
+```
+
+Free public proxies are often blocked by TikTok — residential or paid proxies are the most reliable for high-volume use. The SDK auto-rotates to the next healthy proxy when one fails.
+
+> [!NOTE]
+> You can also check [HERE](docs/responses) to see example response data for the main methods.
+
+## Running tests
+
+```sh
+npm test
+```
+
+That runs the Vitest suite for this repo. Most of the tests are local, but some checks still depend on TikTok behavior and can shift when the site changes.
+
+If you want a slightly wider check while you're working on the SDK, you can also run:
+
+```sh
+npm run typecheck
+```
+
+```sh
+npm run lint
+```
+
+If you're only testing one area, keep the focus tight and run the smallest check that covers your change.
+
+## Sponsor
+If you'd like to financially support this project, sponsorship by the current maintainer is coming soon.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for how to contribute, and [SECURITY.md](SECURITY.md) for how to report security issues.
+
+## LICENSE
+Copyright (c) 2026 Corex Anthony
+
+Licensed under the MIT License: Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/engineRequirements.js

@@ -0,0 +1,7 @@
+const nodeVersion = process.versions.node;
+const major = Number(nodeVersion.split('.')[0]);
+if (major < 18) {
+  console.error(`❌ Node.js >= 18 required (found ${nodeVersion})`);
+  process.exit(1);
+}
+console.log(`✓ Node.js ${nodeVersion}`);

package/lib/ProxiflyProvider.d.ts

@@ -0,0 +1,24 @@
+import { Proxymanager } from './core/Proxymanager.js';
+export interface ProxiflyConfig {
+    protocol?: 'http' | 'socks4' | 'socks5';
+    country?: string;
+    https?: boolean;
+    quantity?: number;
+    refreshInterval?: number;
+}
+export declare class ProxiflyProvider {
+    private proxyManager;
+    private defaults;
+    private refreshTimer;
+    private _ready;
+    private _resolveReady;
+    private _rejectReady;
+    private _fulfilled;
+    constructor(proxyManager: Proxymanager, config?: ProxiflyConfig, manualProxies?: string[]);
+    get ready(): Promise<void>;
+    get isReady(): boolean;
+    fetchFromCDN(): Promise<string[]>;
+    startAutoRefresh(): void;
+    stopAutoRefresh(): void;
+}
+//# sourceMappingURL=ProxiflyProvider.d.ts.map

package/lib/ProxiflyProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxiflyProvider.d.ts","sourceRoot":"","sources":["../src/ProxiflyProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,UAAU,CAAS;gBAGzB,YAAY,EAAE,YAAY,EAC1B,MAAM,CAAC,EAAE,cAAc,EACvB,aAAa,CAAC,EAAE,MAAM,EAAE;IA2C1B,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsCvC,gBAAgB,IAAI,IAAI;IAYxB,eAAe,IAAI,IAAI;CAMxB"}

package/lib/ProxiflyProvider.js

@@ -0,0 +1,112 @@
+import { ofetch } from 'ofetch';
+import { Proxymanager } from './core/Proxymanager.js';
+const CDN_BASE = 'https://cdn.jsdelivr.net/gh/proxifly/free-proxy-list@main/proxies';
+export class ProxiflyProvider {
+    proxyManager;
+    defaults;
+    refreshTimer = null;
+    _ready;
+    _resolveReady;
+    _rejectReady;
+    _fulfilled = false;
+    constructor(proxyManager, config, manualProxies) {
+        this.proxyManager = proxyManager;
+        if (manualProxies?.length) {
+            proxyManager.addProxies(manualProxies);
+        }
+        this.defaults = {
+            protocol: 'http',
+            country: 'US',
+            https: true,
+            quantity: 10,
+            refreshInterval: 300_000,
+            ...config,
+        };
+        this._ready = new Promise((resolve, reject) => {
+            this._resolveReady = resolve;
+            this._rejectReady = reject;
+        });
+        if (manualProxies?.length) {
+            this._fulfilled = true;
+            this._resolveReady();
+        }
+        else {
+            this.fetchFromCDN()
+                .then((urls) => {
+                if (urls.length > 0) {
+                    this.proxyManager.addProxies(urls);
+                    this._fulfilled = true;
+                    this._resolveReady();
+                    this.startAutoRefresh();
+                }
+                else {
+                    this._rejectReady(new Error('ProxiflyProvider: no proxies returned from CDN'));
+                }
+            })
+                .catch((err) => {
+                this._rejectReady(err);
+            });
+        }
+    }
+    get ready() {
+        return this._ready;
+    }
+    get isReady() {
+        return this._fulfilled;
+    }
+    async fetchFromCDN() {
+        const country = this.defaults.country?.toUpperCase() ?? '';
+        const protocol = this.defaults.protocol ?? 'http';
+        const sources = [
+            country ? `${CDN_BASE}/countries/${country}/data.txt` : null,
+            `${CDN_BASE}/protocols/${protocol}/data.txt`,
+            `${CDN_BASE}/all/data.txt`,
+        ].filter(Boolean);
+        const seen = new Set();
+        for (const url of sources) {
+            try {
+                const text = await ofetch(url, {
+                    parseResponse: (t) => t,
+                    timeout: 10000,
+                });
+                for (const line of text.split('\n')) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed.startsWith('#'))
+                        continue;
+                    if (trimmed.includes('://')) {
+                        if (trimmed.startsWith('http://') || trimmed.startsWith('https://')) {
+                            seen.add(trimmed);
+                        }
+                    }
+                    else {
+                        seen.add(`http://${trimmed}`);
+                    }
+                }
+                if (seen.size >= (this.defaults.quantity ?? 10))
+                    break;
+            }
+            catch { }
+        }
+        return Array.from(seen).slice(0, this.defaults.quantity ?? 10);
+    }
+    startAutoRefresh() {
+        if (this.refreshTimer)
+            return;
+        const interval = this.defaults.refreshInterval ?? 300_000;
+        this.refreshTimer = setInterval(() => {
+            this.fetchFromCDN()
+                .then((urls) => {
+                if (urls.length > 0)
+                    this.proxyManager.addProxies(urls);
+            })
+                .catch(() => { });
+        }, interval);
+    }
+    stopAutoRefresh() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=ProxiflyProvider.js.map

package/lib/ProxiflyProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxiflyProvider.js","sourceRoot":"","sources":["../src/ProxiflyProvider.ts"],"names":[],"mappings":"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"}

package/lib/client.d.ts

@@ -0,0 +1,42 @@
+import type { TikTokVideo, TikTokUser, TikTokUserSearchResults, TikTokCommentList, ClientOptions, HashtagInfo, SoundInfo, SoundItemList, TrendingVideos, LikedVideos, PlaylistInfo, PlaylistItemList } from './types.js';
+export declare class TikTokClient {
+    private options;
+    private proxyManager;
+    private proxiflyProvider;
+    private rateLimiter;
+    private retryHandler;
+    private circuitBreaker;
+    private cache;
+    private sessionManager;
+    private queue;
+    constructor(options?: ClientOptions);
+    private awaitProxy;
+    addProxies(proxies: string[]): void;
+    getVideo(url: string, useCache?: boolean): Promise<TikTokVideo>;
+    private executeGetVideo;
+    getUser(usernameOrUrl: string, useCache?: boolean): Promise<TikTokUser>;
+    private executeGetUser;
+    downloadVideo(videoUrl: string): Promise<ArrayBuffer>;
+    getProxyStats(): {
+        total: number;
+        enabled: number;
+        avgScore: number;
+    };
+    searchUsers(query: string, cursor?: number, count?: number): Promise<TikTokUserSearchResults>;
+    getComments(videoUrl: string, cursor?: number, count?: number): Promise<TikTokCommentList>;
+    getHashtag(name: string): Promise<HashtagInfo>;
+    getSound(musicId: string): Promise<SoundInfo>;
+    getSoundVideos(musicId: string, cursor?: number, count?: number): Promise<SoundItemList>;
+    getTrendingVideos(count?: number): Promise<TrendingVideos>;
+    getUserLikedVideos(username: string, cursor?: number, count?: number): Promise<LikedVideos>;
+    getUserPlaylists(username: string, cursor?: number, count?: number): Promise<{
+        playlists: PlaylistInfo[];
+        cursor: number;
+        hasMore: boolean;
+    }>;
+    getPlaylist(mixId: string): Promise<PlaylistInfo>;
+    getPlaylistVideos(mixId: string, cursor?: number, count?: number): Promise<PlaylistItemList>;
+    invalidateCache(url: string): void;
+    clearCache(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,aAAa,EAAsB,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqC7O,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAe;gBAEhB,OAAO,GAAE,aAAkB;YAiCzB,UAAU;IAUxB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAI7B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,CAAC,WAAW,CAAC;YAapD,eAAe;IA2LvB,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,CAAC,UAAU,CAAC;YAc5D,cAAc;IA0CtB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAyB3D,aAAa;;;;;IAIP,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAMzF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQtF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM9C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAM7C,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpF,iBAAiB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IAMtD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,CAAC;IAOvF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAOzI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMjD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM9F,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIlC,UAAU,IAAI,IAAI;CAGnB"}