@traceryn/tiktok-sdk 1.0.0

package/lib/scrapers/SearchScraper.js

@@ -0,0 +1,149 @@
+import { ofetch } from 'ofetch';
+import { HEADERS } from '../utils/constants.js';
+import { CookieJar } from '../utils/CookieJar.js';
+import { signUrl } from '../core/Signer.js';
+import { TikTokFetchError } from '../utils/errors.js';
+const SEARCH_USER_URI = 'https://www.tiktok.com/api/search/user/full/';
+const USER_PAGE = 'https://www.tiktok.com/@tiktok';
+const WEB_SEARCH_CODE = JSON.stringify({
+    tiktok: {
+        client_params_x: {
+            search_engine: {
+                ies_mt_user_live_video_card_use_libra: 1,
+                mt_search_general_user_live_card: 1,
+            },
+        },
+        search_server: {},
+    },
+});
+export function buildAvatarInfo(url) {
+    const m = url.match(/cropcenter:(\d+):(\d+)/);
+    const w = m && m[1] ? parseInt(m[1], 10) : 0;
+    const h = m && m[2] ? parseInt(m[2], 10) : 0;
+    let a = w, b = h;
+    while (b) {
+        const t = b;
+        b = a % b;
+        a = t;
+    }
+    const gcd = a || 1;
+    const maxDim = Math.max(w, h);
+    const fmtM = url.match(/\.(\w+)(?:\?|$)/);
+    let fmt = 'jpeg';
+    if (fmtM && fmtM[1]) {
+        const ext = fmtM[1].toLowerCase();
+        fmt = ext === 'jpg' ? 'jpeg' : ext;
+    }
+    return {
+        url,
+        width: w,
+        height: h,
+        ratio: w && h ? `${w / gcd}:${h / gcd}` : '',
+        quality: maxDim > 0 ? `${maxDim}p` : 'unknown',
+        format: fmt,
+        size: 0,
+    };
+}
+export function parseSearchUser(data) {
+    const u = data.user_info ?? data;
+    return {
+        by: 'Traceryn',
+        id: String(u.uid ?? u.id ?? ''),
+        uniqueId: String(u.uniqueId ?? u.unique_id ?? ''),
+        nickname: String(u.nickname ?? ''),
+        signature: String(u.signature ?? ''),
+        verified: Boolean(u.verified ?? false),
+        secUid: String(u.secUid ?? ''),
+        avatar: {
+            thumb: buildAvatarInfo(String(u.avatarThumb ?? u.avatar_thumb?.url_list?.[0] ?? '')),
+            medium: buildAvatarInfo(String(u.avatarMedium ?? u.avatar_medium?.url_list?.[0] ?? '')),
+            larger: buildAvatarInfo(String(u.avatarLarger ?? u.avatar_larger?.url_list?.[0] ?? '')),
+        },
+        followerCount: Number(u.followerCount ?? u.follower_count ?? 0),
+        followingCount: Number(u.followingCount ?? u.following_count ?? 0),
+        heartCount: Number(u.heartCount ?? u.heart ?? 0),
+        videoCount: Number(u.videoCount ?? u.video_count ?? 0),
+        commerceUserInfo: u.commerceUserInfo
+            ? { commerceUser: Boolean(u.commerceUserInfo.commerceUser), category: u.commerceUserInfo.category }
+            : undefined,
+        privateAccount: Boolean(u.privateAccount ?? u.private_account ?? false),
+        raw: data,
+    };
+}
+async function fetchCookies(proxy) {
+    const jar = new CookieJar();
+    await ofetch(USER_PAGE, {
+        headers: HEADERS.desktop,
+        ...{ proxy },
+        parseResponse: (t) => t,
+        onResponse(_ctx) {
+            const resp = _ctx.response;
+            if (resp?.headers)
+                jar.setFromHeaders(resp.headers);
+        },
+    });
+    const blocked = new Set(['tt_chain_token', 'msToken']);
+    return Object.entries(jar.all)
+        .filter(([k]) => !blocked.has(k))
+        .map(([k, v]) => `${k}=${v}`)
+        .join('; ');
+}
+export async function searchUsers(query, proxy, cursor = 0, count = 20, session) {
+    if (session?.isReady) {
+        try {
+            const code = JSON.stringify({ tiktok: { client_params_x: { search_engine: { ies_mt_user_live_video_card_use_libra: 1, mt_search_general_user_live_card: 1 } }, search_server: {} } });
+            const res = await session.request('/api/search/user/full/', {
+                keyword: query, cursor: String(cursor), count: String(count), from_page: 'search', web_search_code: code,
+            });
+            const rawUsers = res.user_list ?? [];
+            const users = rawUsers.map(parseSearchUser);
+            return { users, cursor: Number(res.cursor ?? cursor), hasMore: Boolean(res.has_more ?? false), raw: res };
+        }
+        catch {
+            // if the session path fails, use plain HTTP instead
+        }
+    }
+    const cookieStr = await fetchCookies(proxy);
+    const params = new URLSearchParams({
+        keyword: query,
+        cursor: String(cursor),
+        count: String(count),
+        from_page: 'search',
+        web_search_code: WEB_SEARCH_CODE,
+    });
+    const ua = HEADERS.desktop['User-Agent'];
+    const baseUrl = `${SEARCH_USER_URI}?${params.toString()}`;
+    const signedUrl = signUrl(baseUrl, ua);
+    let res;
+    try {
+        res = await ofetch(signedUrl, {
+            headers: {
+                ...HEADERS.api,
+                Referer: `https://www.tiktok.com/search/user?q=${encodeURIComponent(query)}`,
+                Cookie: cookieStr,
+            },
+            ...{ proxy },
+        });
+    }
+    catch (err) {
+        const ofetchErr = err;
+        throw new TikTokFetchError(`Search API failed: ${err.message}`, ofetchErr.status);
+    }
+    if (!res || typeof res !== 'object') {
+        throw new TikTokFetchError('TikTok API returned empty response for searchUsers. ' +
+            'Try using a PlaywrightSession — install with: npm install playwright', 0);
+    }
+    const resObj = res;
+    if (resObj.status_code && resObj.status_code !== 0) {
+        throw new TikTokFetchError(`Search API returned error: ${resObj.status_msg ?? resObj.status_code}`, resObj.status_code);
+    }
+    const rawUsers = resObj.user_list ?? [];
+    const users = rawUsers.map(parseSearchUser);
+    return {
+        users,
+        cursor: Number(resObj.cursor ?? cursor),
+        hasMore: Boolean(resObj.has_more ?? false),
+        raw: resObj,
+    };
+}
+//# sourceMappingURL=SearchScraper.js.map

package/lib/scrapers/SearchScraper.js.map

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

package/lib/scrapers/UrlExtractor.d.ts

@@ -0,0 +1,9 @@
+export declare function extractVideoId(urlOrId: string): string;
+export declare function normalizePhotoUrl(url: string): string;
+export declare function buildVideoUrl(uniqueId: string, videoId: string): string;
+export declare function buildUserUrl(username: string): string;
+export declare function buildFeedUrl(secUid: string, cursor: number): string;
+export declare function buildWebpageUrl(videoUrl: string): string;
+export declare function isValidTikTokUrl(url: string): boolean;
+export declare function isPhotoUrl(url: string): boolean;
+//# sourceMappingURL=UrlExtractor.d.ts.map

package/lib/scrapers/UrlExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlExtractor.d.ts","sourceRoot":"","sources":["../../src/scrapers/UrlExtractor.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C"}

package/lib/scrapers/UrlExtractor.js

@@ -0,0 +1,34 @@
+import { TIKTOK_DOMAINS } from '../utils/constants.js';
+export function extractVideoId(urlOrId) {
+    const m = urlOrId.match(/\/(?:video|photo)\/(\d+)/);
+    return m?.[1] ?? urlOrId;
+}
+export function normalizePhotoUrl(url) {
+    return url.replace('/photo/', '/video/');
+}
+export function buildVideoUrl(uniqueId, videoId) {
+    return `${TIKTOK_DOMAINS.www}/@${uniqueId}/video/${videoId}`;
+}
+export function buildUserUrl(username) {
+    const name = username.replace('@', '');
+    return `${TIKTOK_DOMAINS.www}/@${name}`;
+}
+export function buildFeedUrl(secUid, cursor) {
+    const params = new URLSearchParams({
+        secUid,
+        count: '30',
+        cursor: String(cursor),
+    });
+    return `${TIKTOK_DOMAINS.api}/post/item_list/?${params}`;
+}
+export function buildWebpageUrl(videoUrl) {
+    const id = extractVideoId(videoUrl);
+    return `${TIKTOK_DOMAINS.www}/video/${id}`;
+}
+export function isValidTikTokUrl(url) {
+    return /https?:\/\/(?:www\.)?tiktok\.com\/(?:@[\w.-]+\/(?:video|photo)\/\d+|@[\w.-]+)/.test(url);
+}
+export function isPhotoUrl(url) {
+    return url.includes('/photo/');
+}
+//# sourceMappingURL=UrlExtractor.js.map

package/lib/scrapers/UrlExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlExtractor.js","sourceRoot":"","sources":["../../src/scrapers/UrlExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,OAAO,GAAG,cAAc,CAAC,GAAG,KAAK,QAAQ,UAAU,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,cAAc,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc;IACzD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,MAAM;QACN,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,OAAO,GAAG,cAAc,CAAC,GAAG,oBAAoB,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,GAAG,cAAc,CAAC,GAAG,UAAU,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,+EAA+E,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/lib/scrapers/UserScraper.d.ts

@@ -0,0 +1,3 @@
+import type { TikTokUser } from '../types.js';
+export declare function scrapeUser(username: string, proxy: string): Promise<TikTokUser>;
+//# sourceMappingURL=UserScraper.d.ts.map

package/lib/scrapers/UserScraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserScraper.d.ts","sourceRoot":"","sources":["../../src/scrapers/UserScraper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAiC1D,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA0GrF"}

package/lib/scrapers/UserScraper.js

@@ -0,0 +1,137 @@
+import { ofetch } from 'ofetch';
+import { CookieJar, fetchTikTokCookies } from '../utils/CookieJar.js';
+import { HEADERS, DESKTOP_UA } from '../utils/constants.js';
+import { extractUserPageData } from './ParserEngine.js';
+import { buildUserUrl } from './UrlExtractor.js';
+import { TikTokFetchError, TikTokParseError } from '../utils/errors.js';
+import { parseCookieString, formatISODate } from '../utils/helpers.js';
+function buildAvatarInfo(url) {
+    const m = url.match(/cropcenter:(\d+):(\d+)/);
+    const w = m && m[1] ? parseInt(m[1], 10) : 0;
+    const h = m && m[2] ? parseInt(m[2], 10) : 0;
+    let a = w, b = h;
+    while (b) {
+        const t = b;
+        b = a % b;
+        a = t;
+    }
+    const gcd = a || 1;
+    const maxDim = Math.max(w, h);
+    const fmtM = url.match(/\.(\w+)(?:\?|$)/);
+    let fmt = 'jpeg';
+    if (fmtM && fmtM[1]) {
+        const ext = fmtM[1].toLowerCase();
+        fmt = ext === 'jpg' ? 'jpeg' : ext;
+    }
+    return {
+        url,
+        width: w,
+        height: h,
+        ratio: w && h ? `${w / gcd}:${h / gcd}` : '',
+        quality: maxDim > 0 ? `${maxDim}p` : 'unknown',
+        format: fmt,
+        size: 0,
+    };
+}
+export async function scrapeUser(username, proxy) {
+    const name = username.replace('@', '');
+    const url = buildUserUrl(name);
+    const jar = new CookieJar();
+    let html;
+    try {
+        html = await ofetch(url, {
+            headers: HEADERS.desktop,
+            ...{ proxy },
+            parseResponse: (txt) => txt,
+            onResponse(_ctx) {
+                const resp = _ctx.response;
+                if (resp?.headers) {
+                    jar.setFromHeaders(resp.headers);
+                }
+            },
+        });
+    }
+    catch (err) {
+        const ofetchErr = err;
+        throw new TikTokFetchError(`Failed to fetch user page: ${err.message}`, ofetchErr.status);
+    }
+    let pageData = extractUserPageData(html);
+    if (!pageData) {
+        const cookieStr = await fetchTikTokCookies();
+        if (cookieStr) {
+            try {
+                html = await ofetch(url, {
+                    headers: { ...HEADERS.desktop, Cookie: cookieStr },
+                    ...{ proxy },
+                    parseResponse: (txt) => txt,
+                    onResponse(_ctx) {
+                        const resp = _ctx.response;
+                        if (resp?.headers)
+                            jar.setFromHeaders(resp.headers);
+                    },
+                });
+                pageData = extractUserPageData(html);
+            }
+            catch { }
+        }
+    }
+    if (!pageData) {
+        throw new TikTokParseError('Could not extract user data from profile page');
+    }
+    const u = pageData.user;
+    const s = pageData.stats;
+    const createTimestamp = Number(u.createTime ?? 0);
+    const httpHeaders = {
+        ...HEADERS.desktop,
+        Referer: url,
+    };
+    const cu = u.commerceUserInfo;
+    return {
+        by: 'Traceryn',
+        raw: pageData.userInfo,
+        id: String(u.id ?? ''),
+        uniqueId: String(u.uniqueId ?? ''),
+        nickname: String(u.nickname ?? ''),
+        signature: String(u.signature ?? ''),
+        verified: Boolean(u.verified),
+        secUid: String(u.secUid ?? ''),
+        avatar: {
+            thumb: buildAvatarInfo(String(u.avatarThumb ?? '')),
+            medium: buildAvatarInfo(String(u.avatarMedium ?? '')),
+            larger: buildAvatarInfo(String(u.avatarLarger ?? '')),
+        },
+        stats: {
+            followerCount: Number(s.followerCount ?? 0),
+            followingCount: Number(s.followingCount ?? 0),
+            heartCount: Number(s.heartCount ?? 0),
+            videoCount: Number(s.videoCount ?? 0),
+            diggCount: Number(s.diggCount ?? 0),
+            friendCount: Number(s.friendCount ?? 0),
+        },
+        createTime: formatISODate(createTimestamp),
+        createTimestamp,
+        language: String(u.language ?? ''),
+        region: String(u.region ?? ''),
+        bioLink: u.bioLink?.link,
+        privateAccount: Boolean(u.privateAccount),
+        secret: Boolean(u.secret),
+        ftc: Boolean(u.ftc),
+        isOrganization: Boolean(u.isOrganization),
+        ttSeller: Boolean(u.ttSeller),
+        openFavorite: Boolean(u.openFavorite),
+        isADVirtual: Boolean(u.isADVirtual),
+        commentSetting: Number(u.commentSetting ?? 0),
+        duetSetting: Number(u.duetSetting ?? 0),
+        stitchSetting: Number(u.stitchSetting ?? 0),
+        downloadSetting: Number(u.downloadSetting ?? 0),
+        followingVisibility: Number(u.followingVisibility ?? 0),
+        profileEmbedPermission: Number(u.profileEmbedPermission ?? 0),
+        commerceUserInfo: cu?.commerceUser ? {
+            commerceUser: true,
+            category: cu.category,
+        } : undefined,
+        httpHeaders,
+        cookies: parseCookieString(jar.all),
+    };
+}
+//# sourceMappingURL=UserScraper.js.map

package/lib/scrapers/UserScraper.js.map

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

package/lib/scrapers/VideoScraper.d.ts

@@ -0,0 +1,3 @@
+import type { Session, ScrapeResult } from '../types.js';
+export declare function scrapeVideo(url: string, session: Session | undefined, proxy: string): Promise<ScrapeResult>;
+//# sourceMappingURL=VideoScraper.d.ts.map

package/lib/scrapers/VideoScraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoScraper.d.ts","sourceRoot":"","sources":["../../src/scrapers/VideoScraper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAoC9E,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CA8BvB"}

package/lib/scrapers/VideoScraper.js

@@ -0,0 +1,65 @@
+import { ofetch } from 'ofetch';
+import { CookieJar } from '../utils/CookieJar.js';
+import { HEADERS } from '../utils/constants.js';
+import { normalizePhotoUrl, extractVideoId } from './UrlExtractor.js';
+import { ParserEngine } from './ParserEngine.js';
+import { TikTokFetchError, TikTokWafError } from '../utils/errors.js';
+let parserEngine = null;
+function getParser() {
+    if (!parserEngine)
+        parserEngine = new ParserEngine();
+    return parserEngine;
+}
+async function scrapeVideoHTML(url, proxy) {
+    const jar = new CookieJar();
+    const fetchUrl = normalizePhotoUrl(url);
+    const html = await ofetch(fetchUrl, {
+        headers: { ...HEADERS.desktop, Referer: url },
+        parseResponse: (txt) => txt,
+        ...{ proxy },
+        onResponse(_ctx) {
+            const resp = _ctx.response;
+            if (resp?.headers)
+                jar.setFromHeaders(resp.headers);
+        },
+    });
+    // Detect WAF: empty or tiny HTML means blocked
+    if (!html || html.length < 500) {
+        throw new TikTokWafError(`Video HTML too short (${html?.length ?? 0} bytes)`, proxy);
+    }
+    const { itemStruct } = getParser().parse(html);
+    return { html, itemStruct, cookies: jar.all };
+}
+export async function scrapeVideo(url, session, proxy) {
+    // Strategy 1: Session API path
+    if (session?.isReady) {
+        try {
+            const videoId = extractVideoId(url);
+            const res = await session.request('/api/item/detail/', {
+                item_id: videoId,
+            });
+            const itemStruct = res?.itemInfo?.itemStruct;
+            if (itemStruct)
+                return { html: '', itemStruct, cookies: {} };
+        }
+        catch {
+            // fall through
+        }
+    }
+    // 2) render the page if the session path misses
+    if (session?.render) {
+        try {
+            const renderedHtml = await session.render(url);
+            if (renderedHtml && renderedHtml.includes('itemStruct')) {
+                const { itemStruct } = getParser().parse(renderedHtml);
+                return { html: renderedHtml, itemStruct, cookies: {} };
+            }
+        }
+        catch {
+            // fall through to HTML scrape
+        }
+    }
+    // 3) raw HTML scrape as the last shot
+    return scrapeVideoHTML(url, proxy);
+}
+//# sourceMappingURL=VideoScraper.js.map

package/lib/scrapers/VideoScraper.js.map

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