@nxgiang/tiktok-api 1.3.7

package/lib/types/get/getUserLiked.d.ts

@@ -0,0 +1,90 @@
+export type TiktokUserFavoriteVideosResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: LikedResponse[];
+    totalPosts?: number;
+};
+export type LikedResponse = {
+    id: string;
+    desc: string;
+    createTime: string;
+    duetEnabled: boolean;
+    digged: boolean;
+    forFriend: boolean;
+    isAd: boolean;
+    originalItem: boolean;
+    privateItem: boolean;
+    officialItem: boolean;
+    secret: boolean;
+    shareEnabled: boolean;
+    stitchEanbled: boolean;
+    textTranslatable: boolean;
+    author: AuthorLiked;
+    stats: StatisticsLiked;
+    video?: VideoLiked;
+    imagePost?: ImagesLiked[];
+    music: MusicLiked;
+};
+export type AuthorLiked = {
+    id: string;
+    username: string;
+    nickname: string;
+    avatarLarger: string;
+    avatarThumb: string;
+    avatarMedium: string;
+    signature: string;
+    verified: string;
+    openFavorite: string;
+    privateAccount: string;
+    isADVirtual: string;
+    isEmbedBanned: string;
+    stats: StatisticsAuthorLiked;
+};
+export type StatisticsAuthorLiked = {
+    likeCount: string;
+    followerCount: string;
+    followingCount: string;
+    friendCount: string;
+    heartCount: string;
+    postsCount: string;
+};
+export type StatisticsLiked = {
+    collectCount: string;
+    commentCount: string;
+    diggCount: string;
+    playCount: string;
+    repostCount: string;
+    shareCount: string;
+};
+export type ImagesLiked = {
+    title: string;
+    images: string[];
+};
+export type VideoLiked = {
+    id: string;
+    videoID: string;
+    duration: number;
+    ratio: string;
+    cover: string;
+    originCover: string;
+    dynamicCover: string;
+    playAddr: string;
+    downloadAddr: string;
+    format: string;
+    bitrate: number;
+    bitrateInfo: any[];
+};
+export type MusicLiked = {
+    id: string;
+    title: string;
+    playUrl: string;
+    coverThumb: string;
+    coverMedium: string;
+    coverLarge: string;
+    authorName: string;
+    original: boolean;
+    album: string;
+    duration: number;
+    isCopyrighted: boolean;
+    private: boolean;
+};

package/lib/types/get/getUserLiked.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/get/getUserPosts.d.ts

@@ -0,0 +1,68 @@
+export type TiktokUserPostsResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: Posts[];
+    totalPosts?: number;
+};
+export type Posts = {
+    id: string;
+    desc: string;
+    createTime: number;
+    digged: number;
+    duetEnabled: number;
+    forFriend: number;
+    officalItem: number;
+    originalItem: number;
+    privateItem: number;
+    shareEnabled: number;
+    stitchEnabled: number;
+    stats: StatsPost;
+    author: AuthorPost;
+    video?: VideoPost;
+    music: MusicPost;
+    imagePost?: string[];
+};
+export type StatsPost = {
+    collectCount: number;
+    commentCount: number;
+    likeCount: number;
+    playCount: number;
+    shareCount: number;
+};
+export type AuthorPost = {
+    id: string;
+    username: string;
+    nickname: string;
+    avatarLarger: string;
+    avatarThumb: string;
+    avatarMedium: string;
+    signature: string;
+    verified: boolean;
+    openFavorite: boolean;
+    privateAccount: boolean;
+    isADVirtual: boolean;
+    isEmbedBanned: boolean;
+};
+export type VideoPost = {
+    id: string;
+    duration: number;
+    ratio: string;
+    cover: string;
+    originCover: string;
+    dynamicCover: string;
+    playAddr: string;
+    downloadAddr: string;
+    format: string;
+    bitrate: number;
+};
+export type MusicPost = {
+    authorName: string;
+    coverLarge: string;
+    coverMedium: string;
+    coverThumb: string;
+    duration: number;
+    id: string;
+    title: string;
+    playUrl: string;
+    original: boolean;
+};

package/lib/types/get/getUserPosts.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/get/getUserReposts.d.ts

@@ -0,0 +1,104 @@
+export type TiktokUserRepostsResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: Reposts[];
+    totalReposts?: number;
+};
+export type Reposts = {
+    id: string;
+    desc: string;
+    createTime: number;
+    digged: boolean;
+    duetEnabled?: boolean;
+    forFriend: boolean;
+    officalItem: boolean;
+    originalItem: boolean;
+    privateItem: boolean;
+    secret: boolean;
+    shareEnabled: boolean;
+    stitchEnabled?: boolean;
+    stats: StatsRepost;
+    author: AuthorRepost;
+    video?: VideoRepost;
+    music: MusicRepost;
+    imagePost?: ImageRepost;
+    AIGCDescription?: string;
+    CategoryType?: number;
+    collected?: boolean;
+    contents?: any[];
+    challenges?: any[];
+    textExtra?: any[];
+    textLanguage?: string;
+    textTranslatable?: boolean;
+    titleLanguage?: string;
+    titleTranslatable?: boolean;
+    isAd?: boolean;
+    isReviewing?: boolean;
+    itemCommentStatus?: number;
+    item_control?: ItemControl;
+    duetDisplay?: number;
+    stitchDisplay?: number;
+    diversificationId?: number;
+    backendSourceEventTracking?: string;
+    stickersOnItem?: any[];
+    videoSuggestWordsList?: any;
+};
+export type StatsRepost = {
+    shareCount: number;
+    collectCount?: number;
+    commentCount?: number;
+    likeCount?: number;
+    playCount?: number;
+    repostCount?: number;
+};
+export type AuthorRepost = {
+    id: string;
+    username: string;
+    nickname: string;
+    avatarLarger: string;
+    avatarThumb: string;
+    avatarMedium: string;
+    signature: string;
+    verified: boolean;
+    openFavorite?: boolean;
+    privateAccount?: boolean;
+    isADVirtual?: boolean;
+    isEmbedBanned?: boolean;
+};
+export type VideoRepost = {
+    id: string;
+    duration: number;
+    ratio: string;
+    cover: string;
+    originCover: string;
+    dynamicCover: string;
+    playAddr: string;
+    downloadAddr: string;
+    format: string;
+    bitrate: number;
+};
+export type MusicRepost = {
+    authorName?: string;
+    coverLarge?: string;
+    coverMedium?: string;
+    coverThumb?: string;
+    duration?: number;
+    id?: string;
+    title?: string;
+    playUrl?: string;
+    original?: boolean;
+    tt2dsp?: any;
+};
+export type ImageRepost = {
+    title: string;
+    images?: ImageRepostItem[];
+};
+export type ImageRepostItem = {
+    imageURL: {
+        urlList: string[];
+    };
+};
+export type ItemControl = {
+    can_repost?: boolean;
+    can_share?: boolean;
+};

package/lib/types/get/getUserReposts.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/search/index.d.ts

@@ -0,0 +1,15 @@
+import { VideoSearchResult } from "./videoSearch";
+import { LiveSearchResult } from "./liveSearch";
+import { UserSearchResult } from "./userSearch";
+export type SearchType = "video" | "live" | "user";
+export type SearchResult = {
+    type: SearchType;
+    data: VideoSearchResult | LiveSearchResult | UserSearchResult;
+};
+export type TiktokSearchResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: SearchResult[];
+    page?: number;
+    totalResults?: number;
+};

package/lib/types/search/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/search/liveSearch.d.ts

@@ -0,0 +1,48 @@
+export type TiktokLiveSearchResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: LiveSearchResult[];
+    page?: number;
+    totalResults?: number;
+};
+export type LiveSearchResult = {
+    roomInfo: RoomInfo;
+    liveInfo: LiveInfo;
+};
+export type RoomInfo = {
+    hasCommerceGoods: boolean;
+    isBattle: boolean;
+};
+export type LiveInfo = {
+    id: string;
+    title: string;
+    cover: string[];
+    squareCover: string[];
+    rectangleCover: string[];
+    liveTypeThirdParty: boolean;
+    hashtag: string;
+    startTime: number;
+    stats: Stats;
+    owner: Owner;
+};
+export type Stats = {
+    totalUser: number;
+    viewerCount: number;
+    likeCount: number;
+};
+export type Owner = {
+    uid: string;
+    nickname: string;
+    username: string;
+    signature: string;
+    avatarThumb: string[];
+    avatarMedium: string[];
+    avatarLarge: string[];
+    modifyTime: number;
+    stats: OwnerStats;
+    isVerified: boolean;
+};
+export type OwnerStats = {
+    followingCount: number;
+    followerCount: number;
+};

package/lib/types/search/liveSearch.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/search/userSearch.d.ts

@@ -0,0 +1,32 @@
+export type TiktokUserSearchResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: Array<{
+        uid: string;
+        username: string;
+        nickname: string;
+        signature: string;
+        followerCount: number;
+        avatarThumb: string;
+        isVerified: boolean;
+        secUid: string;
+        url: string;
+    }>;
+    page?: number;
+    totalResults?: number;
+};
+export type UserSearchResult = {
+    uid: string;
+    username: string;
+    nickname: string;
+    signature: string;
+    avatarThumb: string;
+    followerCount: number;
+    isVerified: boolean;
+    secUid: string;
+    url: string;
+};
+export interface IUserSearch {
+    saveSearch(searchTerm: string): void;
+    getLastSearch(): string | null;
+}

package/lib/types/search/userSearch.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/search/videoSearch.d.ts

@@ -0,0 +1,62 @@
+export type TiktokVideoSearchResponse = {
+    status: "success" | "error";
+    message?: string;
+    result?: VideoSearchResult[];
+    page?: number;
+    totalResults?: number;
+};
+export type VideoSearchResult = {
+    id: string;
+    desc: string;
+    createTime: number;
+    author: AuthorVideoSearch;
+    stats: StatisticsVideoSearch;
+    video: VideoSearch;
+    music: MusicVideoSearch;
+};
+export type VideoSearch = {
+    id: string;
+    ratio: string;
+    cover: string;
+    originCover: string;
+    dynamicCover: string;
+    playAddr: string;
+    downloadAddr: string;
+    format: string;
+};
+export type StatisticsVideoSearch = {
+    collectCount: number;
+    commentCount: number;
+    likeCount: number;
+    playCount: number;
+    shareCount: number;
+};
+export type AuthorVideoSearch = {
+    id: string;
+    uniqueId: string;
+    nickname: string;
+    avatarThumb: string;
+    avatarMedium: string;
+    avatarLarger: string;
+    signature: string;
+    verified: boolean;
+    secUid: string;
+    openFavorite: boolean;
+    privateAccount: boolean;
+    isADVirtual: boolean;
+    tiktokSeller: boolean;
+    isEmbedBanned: boolean;
+};
+export type MusicVideoSearch = {
+    id: string;
+    title: string;
+    playUrl: string;
+    coverThumb: string;
+    coverMedium: string;
+    coverLarge: string;
+    authorName: string;
+    original: boolean;
+    album: string;
+    duration: number;
+    isCopyrighted: boolean;
+};

package/lib/types/search/videoSearch.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils/downloader/musicaldownDownloader.d.ts

@@ -0,0 +1,2 @@
+import { MusicalDownResponse } from "../../types/downloader/musicaldownDownloader";
+export declare const MusicalDown: (url: string, proxy?: string) => Promise<MusicalDownResponse>;

package/lib/utils/downloader/musicaldownDownloader.js

@@ -0,0 +1,193 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MusicalDown = void 0;
+const axios_1 = __importDefault(require("axios"));
+const cheerio_1 = require("cheerio");
+const api_1 = require("../../constants/api");
+const https_proxy_agent_1 = require("https-proxy-agent");
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+const constants_1 = require("../../constants");
+const TIKTOK_URL_REGEX = /https:\/\/(?:m|t|www|vm|vt|lite)?\.?tiktok\.com\/((?:.*\b(?:(?:usr|v|embed|user|video|photo)\/|\?shareId=|\&item_id=)(\d+))|\w+)/;
+const USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64; rv:127.0) Gecko/20100101 Firefox/127.0";
+const createProxyAgent = (proxy) => {
+    if (!proxy)
+        return {};
+    const isHttpProxy = proxy.startsWith("http") || proxy.startsWith("https");
+    const isSocksProxy = proxy.startsWith("socks");
+    if (!isHttpProxy && !isSocksProxy)
+        return {};
+    return {
+        httpsAgent: isHttpProxy
+            ? new https_proxy_agent_1.HttpsProxyAgent(proxy)
+            : new socks_proxy_agent_1.SocksProxyAgent(proxy)
+    };
+};
+const validateTikTokUrl = (url) => {
+    return TIKTOK_URL_REGEX.test(url);
+};
+const isValidUrl = (url) => {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const extractRequestForm = ($, url) => {
+    const input = $("div > input").map((_, el) => $(el));
+    return {
+        [input.get(0).attr("name") || ""]: input.get(0).attr("value") || url,
+        [input.get(1).attr("name") || ""]: input.get(1).attr("value") || "",
+        [input.get(2).attr("name") || ""]: input.get(2).attr("value") || ""
+    };
+};
+const parseImages = ($) => {
+    const images = [];
+    $("div.row > div[class='col s12 m3']").each((_, v) => {
+        const src = $(v).find("img").attr("src");
+        if (src)
+            images.push(src);
+    });
+    return images;
+};
+const parseVideos = ($) => {
+    const videos = {};
+    const videoContainer = $("div.row > div")
+        .map((_, el) => $(el))
+        .get(1);
+    if (!videoContainer)
+        return videos;
+    $(videoContainer)
+        .find("a")
+        .each((_, v) => {
+        const href = $(v).attr("href");
+        if (!href || href === "#modal2")
+            return;
+        if (!isValidUrl(href))
+            return;
+        const dataEvent = $(v).attr("data-event") || "";
+        const onclick = $(v).attr("onclick") || "";
+        const downloadUrl = href !== undefined ? href : /downloadX\('([^']+)'\)/.exec(onclick)?.[1];
+        if (!downloadUrl)
+            return;
+        if (dataEvent.includes("hd")) {
+            videos.videoHD = downloadUrl;
+        }
+        else if (dataEvent.includes("mp4")) {
+            videos.videoSD = downloadUrl;
+        }
+        else if (dataEvent.includes("watermark")) {
+            videos.videoWatermark = downloadUrl;
+        }
+        else if (href.includes("type=mp3")) {
+            videos.music = downloadUrl;
+        }
+    });
+    return videos;
+};
+const createImageResponse = (images) => ({
+    status: "success",
+    result: {
+        type: "image",
+        images
+    }
+});
+const createVideoResponse = ($, videos) => ({
+    status: "success",
+    result: {
+        type: "video",
+        author: {
+            avatar: $("div.img-area > img").attr("src") || "",
+            nickname: $("h2.video-author > b").text()
+        },
+        desc: $("p.video-desc").text(),
+        ...videos
+    }
+});
+const getRequest = async (url, proxy) => {
+    try {
+        if (!validateTikTokUrl(url)) {
+            return {
+                status: "error",
+                message: constants_1.ERROR_MESSAGES.INVALID_URL
+            };
+        }
+        const { data, headers } = await (0, axios_1.default)(api_1._musicaldownurl, {
+            method: "GET",
+            headers: {
+                Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+                "Update-Insecure-Requests": "1",
+                "User-Agent": USER_AGENT
+            },
+            ...createProxyAgent(proxy)
+        });
+        const cookie = headers["set-cookie"]?.[0]?.split(";")[0];
+        if (!cookie) {
+            return {
+                status: "error",
+                message: constants_1.ERROR_MESSAGES.NETWORK_ERROR
+            };
+        }
+        const $ = (0, cheerio_1.load)(data);
+        const request = extractRequestForm($, url);
+        return {
+            status: "success",
+            request,
+            cookie
+        };
+    }
+    catch (error) {
+        return {
+            status: "error",
+            message: error instanceof Error ? error.message : constants_1.ERROR_MESSAGES.NETWORK_ERROR
+        };
+    }
+};
+const MusicalDown = async (url, proxy) => {
+    try {
+        const request = await getRequest(url, proxy);
+        if (request.status !== "success") {
+            return {
+                status: "error",
+                message: request.message
+            };
+        }
+        const { data } = await (0, axios_1.default)(api_1._musicaldownapi, {
+            method: "POST",
+            headers: {
+                cookie: request.cookie,
+                "Content-Type": "application/x-www-form-urlencoded",
+                Origin: "https://musidown.com/download",
+                Referer: "https://musidown.com/download/en",
+                "Upgrade-Insecure-Requests": "1",
+                "User-Agent": USER_AGENT
+            },
+            data: new URLSearchParams(Object.entries(request.request)),
+            ...createProxyAgent(proxy)
+        });
+        const $ = (0, cheerio_1.load)(data);
+        const images = parseImages($);
+        if (images.length > 0) {
+            return createImageResponse(images);
+        }
+        const videos = parseVideos($);
+        if (Object.keys(videos).length === 0) {
+            return {
+                status: "error",
+                message: "There is an error. Can't find download link"
+            };
+        }
+        return createVideoResponse($, videos);
+    }
+    catch (error) {
+        return {
+            status: "error",
+            message: error instanceof Error ? error.message : constants_1.ERROR_MESSAGES.NETWORK_ERROR
+        };
+    }
+};
+exports.MusicalDown = MusicalDown;

package/lib/utils/downloader/ssstikDownloader.d.ts

@@ -0,0 +1,2 @@
+import { SSSTikResponse } from "../../types/downloader/ssstikDownloader";
+export declare const SSSTik: (url: string, proxy?: string) => Promise<SSSTikResponse>;