@nxgiang/tiktok-api 1.3.7

package/test/downloader-v3-test.ts

@@ -0,0 +1,35 @@
+// Test for Tiktok Downloader v3
+import Tiktok from "../src/index"
+
+async function testDownloaderV3() {
+  try {
+    const url = "https://www.tiktok.com/@tobz2k19/video/7451777267107187986" // Change to a valid TikTok video URL
+    console.log(`\nTesting Downloader version: v3`)
+    const result = await Tiktok.Downloader(url, {
+      version: "v3",
+      proxy: undefined
+    })
+    if (result.status === "success" && result.result) {
+      const r = result.result
+      console.log(`Type: ${r.type}`)
+      if (r.desc) console.log(`Description: ${r.desc}`)
+      if (r.author && r.author.nickname) {
+        console.log(`Author: ${r.author.nickname}`)
+      } else if (r.author && r.author.avatar) {
+        // fallback for v3 author structure
+        console.log(`Author Avatar: ${r.author.avatar}`)
+      }
+      if (r.videoHD) console.log(`Video HD: ${r.videoHD}`)
+      if (r.videoWatermark) console.log(`Video Watermark: ${r.videoWatermark}`)
+      if (r.images?.length) console.log(`Images: ${r.images.join(", ")}`)
+      if (r.music) console.log(`Music: ${r.music}`)
+      console.log("========================")
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testDownloaderV3()

package/test/music-detail-test.ts

@@ -0,0 +1,97 @@
+// Test for Tiktok Get Music Detail
+import Tiktok from "../src/index"
+
+/**
+ * Test getMusicDetail function
+ * This test will fetch detailed information for a specific music ID or URL
+ * Note: This requires a valid TikTok cookie
+ */
+async function testGetMusicDetail() {
+  console.log("Testing getMusicDetail function...")
+
+  // You can use either music ID or URL
+  const musicIdOrUrl = "https://www.tiktok.com/music/QKThr-6771810675950880769"
+  // const musicIdOrUrl = "6771810675950880769" // Alternative: use direct ID
+
+  // IMPORTANT: Replace with your actual TikTok cookie
+  const cookie = "YOUR_TIKTOK_COOKIE_HERE" // Get this from your browser's dev tools
+
+  try {
+    console.log(`Fetching music detail for: ${musicIdOrUrl}`)
+    console.log("Note: Make sure you have set a valid TikTok cookie\n")
+
+    const result = await Tiktok.GetMusicDetail(musicIdOrUrl, {
+      cookie: cookie
+      // proxy: "http://your-proxy-url" // Optional: Add proxy if needed
+    })
+
+    console.log("Result received:")
+    console.log(`Status: ${result.status}`)
+
+    if (result.status === "success" && result.result) {
+      const { musicInfo, shareMeta } = result.result
+
+      console.log("\n========================")
+      console.log("MUSIC INFORMATION")
+      console.log("========================")
+      console.log(`Music ID: ${musicInfo.music.id}`)
+      console.log(`Title: ${musicInfo.music.title}`)
+      console.log(`Author Name: ${musicInfo.music.authorName}`)
+      console.log(`Duration: ${musicInfo.music.duration} seconds`)
+      console.log(`Original: ${musicInfo.music.original ? "Yes" : "No"}`)
+      console.log(
+        `Copyrighted: ${musicInfo.music.isCopyrighted ? "Yes" : "No"}`
+      )
+      console.log(`Private: ${musicInfo.music.private ? "Yes" : "No"}`)
+
+      console.log("\n========================")
+      console.log("AUTHOR INFORMATION")
+      console.log("========================")
+      console.log(`Author ID: ${musicInfo.author?.id}`)
+      console.log(`Nickname: ${musicInfo.author?.nickname}`)
+      console.log(`Username: @${musicInfo.author?.uniqueId}`)
+      console.log(`Verified: ${musicInfo.author?.ftc ? "Yes" : "No"}`)
+      console.log(
+        `Private Account: ${musicInfo.author?.privateAccount ? "Yes" : "No"}`
+      )
+      console.log(`Secure UID: ${musicInfo.author?.secUid}`)
+      console.log(`Signature: ${musicInfo.author?.signature || "No signature"}`)
+
+      console.log("\n========================")
+      console.log("STATISTICS")
+      console.log("========================")
+      console.log(
+        `Videos using this music: ${musicInfo.stats.videoCount.toLocaleString()}`
+      )
+
+      console.log("\n========================")
+      console.log("URLS")
+      console.log("========================")
+      console.log(`Play URL: ${musicInfo.music.playUrl}`)
+      console.log(`Cover Thumbnail: ${musicInfo.music.coverThumb}`)
+      console.log(`Cover Medium: ${musicInfo.music.coverMedium}`)
+      console.log(`Cover Large: ${musicInfo.music.coverLarge}`)
+
+      if (shareMeta) {
+        console.log("\n========================")
+        console.log("SHARE META")
+        console.log("========================")
+        console.log(`Title: ${shareMeta.title}`)
+        console.log(`Description: ${shareMeta.desc}`)
+      }
+
+      console.log("\n✅ Test completed successfully!")
+      console.log(
+        "\n💡 Tip: Use 'GetVideosByMusicId' to get videos using this music"
+      )
+    } else {
+      console.log(`❌ Error: ${result.message}`)
+    }
+  } catch (error: any) {
+    console.error("\n❌ Test failed:", error.message)
+    console.error("\nError details:", error)
+  }
+}
+
+// Run the test
+testGetMusicDetail()

package/test/music-videos-test.ts

@@ -0,0 +1,86 @@
+// Test for Tiktok Get Music Videos
+import Tiktok from "../src/index"
+
+/**
+ * Test getMusicVideos function
+ * This test will fetch videos for a specific music ID or URL
+ */
+async function testGetMusicVideos() {
+  console.log("Testing getMusicVideos function...")
+
+  // You can use either music ID or URL
+  const musicIdOrUrl = "https://www.tiktok.com/music/QKThr-6771810675950880769"
+  // const musicIdOrUrl = "7034143722082192134" // Alternative: use direct ID
+
+  try {
+    console.log(`Fetching videos for: ${musicIdOrUrl}`)
+
+    const result = await Tiktok.GetVideosByMusicId(musicIdOrUrl, {
+      page: 1,
+      count: 30
+    })
+
+    console.log("Result received:")
+    console.log(`Status: ${result.status}`)
+
+    if (result.status === "success" && result.result) {
+      console.log(`Music Info:`)
+      if (result.result.music) {
+        console.log(`  - Title: ${result.result.music.title}`)
+        console.log(`  - Artist: ${result.result.music.authorName}`)
+        console.log(`  - ID: ${result.result.music.id}`)
+        console.log(`  - Duration: ${result.result.music.duration}s`)
+        console.log(
+          `  - Original: ${result.result.music.original ? "Yes" : "No"}`
+        )
+      }
+
+      console.log(`\nVideos:`)
+      console.log(`  - Total found: ${result.result.totalVideos}`)
+
+      if (result.result.videos && result.result.videos.length > 0) {
+        result.result.videos.forEach((video, index) => {
+          console.log(`  ${index + 1}. Video ID: ${video.id}`)
+          console.log(
+            `     Author: @${video.author.uniqueId} (${video.author.nickname})`
+          )
+          console.log(
+            `     Description: ${
+              video.desc?.substring(0, 50) || "No description"
+            }${video.desc && video.desc.length > 50 ? "..." : ""}`
+          )
+          console.log(
+            `     Created: ${new Date(
+              video.createTime * 1000
+            ).toLocaleDateString()}`
+          )
+          console.log(
+            `     Stats: ${video.stats.playCount} views, ${video.stats.diggCount} likes, ${video.stats.commentCount} comments`
+          )
+
+          if (video.video) {
+            console.log(`     Video Duration: ${video.video.duration}s`)
+          }
+
+          if (video.imagePost) {
+            console.log(`     Image Post: ${video.imagePost.length} images`)
+          }
+
+          if (video.effectStickers && video.effectStickers.length > 0) {
+            console.log(
+              `     Effects: ${video.effectStickers.length} effects used`
+            )
+          }
+
+          console.log("")
+        })
+      }
+    } else {
+      console.log(`❌ Error: ${result.message}`)
+    }
+  } catch (error: any) {
+    console.error("❌ Test failed:", error.message)
+  }
+}
+
+testGetMusicVideos()

package/test/playlist-test.ts

@@ -0,0 +1,48 @@
+// Test for Tiktok Playlist
+import Tiktok from "../src/index"
+
+async function testPlaylist() {
+  try {
+    const playlistUrl =
+      "https://www.tiktok.com/@tobz2k19/playlist/tset-7511644672511626004" // Ganti dengan URL playlist yang valid jika perlu
+    console.log(`\nTesting Playlist: ${playlistUrl}`)
+    const result = await Tiktok.Playlist(playlistUrl, {
+      proxy: undefined,
+      page: 1,
+      count: 5
+    })
+    if (result.status === "success" && result.result) {
+      const { itemList, hasMore, extra } = result.result
+      console.log(`Total Videos: ${itemList.length}`)
+      itemList.forEach((item, idx) => {
+        console.log(`\n[${idx + 1}] ID: ${item.id}`)
+        console.log(`Description: ${item.desc}`)
+        if (item.author) {
+          console.log(`Author: ${item.author.nickname}`)
+        }
+        if (item.stats) {
+          console.log("Statistics:")
+          console.log(`- Likes: ${item.stats.diggCount}`)
+          console.log(`- Comments: ${item.stats.commentCount}`)
+          console.log(`- Shares: ${item.stats.shareCount}`)
+          console.log(`- Plays: ${item.stats.playCount}`)
+        }
+        if (item.video?.playAddr?.length) {
+          console.log(`Video URL: ${item.video.playAddr}`)
+        }
+      })
+      console.log("========================")
+      if (hasMore) {
+        console.log(
+          "There are more videos. Use the 'page' option to fetch next page."
+        )
+      }
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testPlaylist()

package/test/profile-test.ts

@@ -0,0 +1,49 @@
+// Test for Tiktok Stalk User Profile
+import Tiktok from "../src/index"
+
+async function testProfile() {
+  try {
+    const username = "charlidamelio" // Change to a valid TikTok username
+    const result = await Tiktok.StalkUser(username, {
+      proxy: undefined
+    })
+    if (result.status === "success" && result.result) {
+      const { user, stats, statsV2 } = result.result
+      console.log("\nProfile fetched successfully!")
+      console.log("========================")
+      console.log("User Profile:")
+      console.log("========================")
+      console.log(`Username: @${user.username}`)
+      console.log(`Nickname: ${user.nickname}`)
+      console.log(`Signature: ${user.signature}`)
+      console.log(`Verified: ${user.verified ? "Yes" : "No"}`)
+      console.log(`Region: ${user.region}`)
+      console.log(`Private Account: ${user.privateAccount ? "Yes" : "No"}`)
+      console.log(`Commerce User: ${user.commerceUser ? "Yes" : "No"}`)
+      console.log(`Avatar: ${user.avatarLarger}`)
+      console.log(`Secured ID: ${user.secUid}`)
+      console.log("\nStats:")
+      console.log(`- Followers: ${stats.followerCount}`)
+      console.log(`- Following: ${stats.followingCount}`)
+      console.log(`- Hearts: ${stats.heartCount}`)
+      console.log(`- Videos: ${stats.videoCount}`)
+      console.log(`- Likes: ${stats.likeCount}`)
+      console.log(`- Friends: ${stats.friendCount}`)
+      console.log("========================")
+      console.log("\nStats V2:")
+      console.log(`- Followers: ${statsV2.followerCount}`)
+      console.log(`- Following: ${statsV2.followingCount}`)
+      console.log(`- Hearts: ${statsV2.heartCount}`)
+      console.log(`- Videos: ${statsV2.videoCount}`)
+      console.log(`- Likes: ${statsV2.likeCount}`)
+      console.log(`- Friends: ${statsV2.friendCount}`)
+      console.log("========================")
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testProfile()

package/test/search-live-test.ts

@@ -0,0 +1,42 @@
+// Test for Tiktok Search Live
+import Tiktok from "../src/index"
+
+async function testSearchLive() {
+  try {
+    const keyword = "call of duty" // Change to a valid search keyword
+    const cookie = "" // Optional: provide a valid TikTok cookie if needed
+    console.log(`\nTesting Search type: live`)
+    const result = await Tiktok.Search(keyword, {
+      type: "live",
+      cookie,
+      page: 1,
+      proxy: undefined
+    })
+    if (result.status === "success" && result.result) {
+      console.log("Success! Parsed Result:")
+      result.result.forEach((item, index) => {
+        if (item.type === "live") {
+          const live = item as typeof item & { liveInfo: any }
+          if (live.liveInfo) {
+            console.log(`\nResult ${index + 1}:`)
+            console.log("-------------------")
+            console.log(`ID: ${live.liveInfo.id}`)
+            console.log(`Title: ${live.liveInfo.title}`)
+            console.log(`Hashtag: ${live.liveInfo.hashtag}`)
+            if (live.liveInfo.owner)
+              console.log(`Owner: ${live.liveInfo.owner.nickname}`)
+            if (live.liveInfo.stats)
+              console.log(`Viewers: ${live.liveInfo.stats.viewerCount}`)
+            console.log("========================")
+          }
+        }
+      })
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testSearchLive()

package/test/search-user-test.ts

@@ -0,0 +1,46 @@
+// Test for Tiktok Search User
+import Tiktok from "../src/index"
+
+async function testSearchUser() {
+  try {
+    const keyword = "call of duty" // Change to a valid search keyword
+    const cookie = "" // Optional: provide a valid TikTok cookie if needed
+    console.log(`\nTesting Search type: user`)
+    const result = await Tiktok.Search(keyword, {
+      type: "user",
+      cookie,
+      page: 1,
+      proxy: undefined
+    })
+    if (result.status === "success" && result.result) {
+      console.log("Success! Parsed Result:")
+      result.result.forEach((item, index) => {
+        if (item.type === "user") {
+          const user = item as typeof item & {
+            uid: string
+            username: string
+            nickname: string
+            followerCount: number
+            isVerified: boolean
+            url: string
+          }
+          console.log(`\nResult ${index + 1}:`)
+          console.log("-------------------")
+          console.log(`UID: ${user.uid}`)
+          console.log(`Username: ${user.username}`)
+          console.log(`Nickname: ${user.nickname}`)
+          console.log(`Followers: ${user.followerCount}`)
+          console.log(`Verified: ${user.isVerified ? "Yes" : "No"}`)
+          console.log(`Profile URL: ${user.url}`)
+          console.log("========================")
+        }
+      })
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testSearchUser()

package/test/search-video-test.ts

@@ -0,0 +1,53 @@
+// Test for Tiktok Search Video
+import Tiktok from "../src/index"
+
+async function testSearchVideo() {
+  try {
+    const keyword = "call of duty" // Change to a valid search keyword
+    const cookie = "" // Optional: provide a valid TikTok cookie if needed
+    console.log(`\nTesting Search type: video`)
+    const result = await Tiktok.Search(keyword, {
+      type: "video",
+      cookie,
+      page: 1,
+      proxy: undefined
+    })
+    if (result.status === "success" && result.result) {
+      console.log("Success! Parsed Result:")
+      result.result.forEach((item, index) => {
+        if (item.type === "video") {
+          const video = item as typeof item & {
+            id: string
+            desc: string
+            author: any
+            createTime: number
+            stats: any
+          }
+          console.log(`\nResult ${index + 1}:`)
+          console.log("-------------------")
+          console.log(`ID: ${video.id}`)
+          console.log(`Description: ${video.desc}`)
+          if (video.author) console.log(`Author: ${video.author.nickname}`)
+          if (video.createTime)
+            console.log(
+              `Created: ${new Date(video.createTime * 1000).toLocaleString()}`
+            )
+          if (video.stats) {
+            console.log("Statistics:")
+            console.log(`- Likes: ${video.stats.likeCount}`)
+            console.log(`- Comments: ${video.stats.commentCount}`)
+            console.log(`- Shares: ${video.stats.shareCount}`)
+            console.log(`- Plays: ${video.stats.playCount}`)
+          }
+          console.log("========================")
+        }
+      })
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testSearchVideo()

package/test/trending-test.ts

@@ -0,0 +1,128 @@
+// Test for TikTok Trending Content
+import Tiktok from "../src/index"
+
+async function testTrending() {
+  try {
+    console.log(`\nTesting TikTok Trending Content`)
+    console.log("===============================")
+
+    // Test basic trending functionality
+    const result = await Tiktok.Trending({
+      proxy: undefined // Add proxy if needed
+    })
+
+    if (result.status === "success" && result.result) {
+      console.log("✅ Success! Trending content fetched successfully")
+      console.log(`📊 Total trending sections: ${result.result.length}`)
+
+      result.result.forEach((section, sectionIndex) => {
+        console.log(`\n📂 Section ${sectionIndex + 1}:`)
+        console.log("-------------------")
+        console.log(`Items in this section: ${section.exploreList.length}`)
+
+        section.exploreList.slice(0, 3).forEach((item, index) => {
+          const cardItem = item.cardItem
+          console.log(`\n  Item ${index + 1}:`)
+          console.log(`  ID: ${cardItem.id}`)
+          console.log(`  Title: ${cardItem.title}`)
+          console.log(`  Subtitle: ${cardItem.subTitle}`)
+          console.log(`  Type: ${cardItem.type}`)
+          console.log(
+            `  Description: ${cardItem.description.substring(0, 100)}${
+              cardItem.description.length > 100 ? "..." : ""
+            }`
+          )
+
+          if (cardItem.extraInfo) {
+            console.log(
+              `  Verified: ${cardItem.extraInfo.verified ? "Yes" : "No"}`
+            )
+            console.log(
+              `  Fans: ${cardItem.extraInfo.fans?.toLocaleString() || "N/A"}`
+            )
+            console.log(
+              `  Likes: ${cardItem.extraInfo.likes?.toLocaleString() || "N/A"}`
+            )
+            console.log(`  Videos: ${cardItem.extraInfo.video || "N/A"}`)
+          }
+        })
+
+        if (section.exploreList.length > 3) {
+          console.log(`  ... and ${section.exploreList.length - 3} more items`)
+        }
+      })
+    } else {
+      console.error("❌ Error fetching trending content:", result.message)
+    }
+  } catch (error) {
+    console.error("❌ Test failed:", error)
+  }
+}
+
+async function testTrendingCreators() {
+  try {
+    console.log(`\n\nTesting TikTok Trending Creators`)
+    console.log("=================================")
+
+    // Test trending creators functionality
+    const result = await Tiktok.TrendingCreators({
+      proxy: undefined // Add proxy if needed
+    })
+
+    if (result.status === "success" && result.result) {
+      console.log("✅ Success! Trending creators fetched successfully")
+      console.log(`👥 Total trending creators: ${result.result.length}`)
+
+      result.result.slice(0, 10).forEach((creator, index) => {
+        console.log(`\n👤 Creator ${index + 1}:`)
+        console.log("-------------------")
+        console.log(`ID: ${creator.id}`)
+        console.log(`Username: @${creator.username}`)
+        console.log(`Nickname: ${creator.nickname}`)
+        console.log(`Verified: ${creator.verified ? "✅ Yes" : "❌ No"}`)
+        console.log(`Followers: ${creator.followerCount.toLocaleString()}`)
+        console.log(`Total Likes: ${creator.likeCount.toLocaleString()}`)
+        console.log(`Videos: ${creator.videoCount.toLocaleString()}`)
+        console.log(`Following: ${creator.followingCount.toLocaleString()}`)
+        console.log(
+          `Description: ${creator.description.substring(0, 80)}${
+            creator.description.length > 80 ? "..." : ""
+          }`
+        )
+        console.log(`Profile Link: https://www.tiktok.com${creator.link}`)
+      })
+
+      if (result.result.length > 10) {
+        console.log(`\n... and ${result.result.length - 10} more creators`)
+      }
+
+      // Show some statistics
+      const verifiedCount = result.result.filter((c) => c.verified).length
+      const totalFollowers = result.result.reduce(
+        (sum, c) => sum + c.followerCount,
+        0
+      )
+      const avgFollowers = Math.round(totalFollowers / result.result.length)
+
+      console.log(`\n📈 Statistics:`)
+      console.log(`Verified creators: ${verifiedCount}/${result.result.length}`)
+      console.log(`Average followers: ${avgFollowers.toLocaleString()}`)
+      console.log(
+        `Total combined followers: ${totalFollowers.toLocaleString()}`
+      )
+    } else {
+      console.error("❌ Error fetching trending creators:", result.message)
+    }
+  } catch (error) {
+    console.error("❌ Test failed:", error)
+  }
+}
+
+// Run both tests
+async function runAllTests() {
+  await testTrending()
+  await testTrendingCreators()
+  console.log(`\n🎉 All trending tests completed!`)
+}
+
+runAllTests()

package/test/userliked-test.ts

@@ -0,0 +1,65 @@
+// Test for Tiktok Get User Liked Videos
+import Tiktok from "../src/index"
+
+async function testUserLiked() {
+  try {
+    const username = "Tobz2k19" // Change to a valid TikTok username
+    const cookie = "YOUR_TIKTOK_COOKIE_HERE" // Get this from your browser's dev tools
+    const result = await Tiktok.GetUserLiked(username, {
+      cookie,
+      postLimit: 5,
+      proxy: undefined
+    })
+    if (result.status === "success" && result.result) {
+      console.log("\nUser Liked Videos fetched successfully!")
+      console.log("========================")
+      console.log("Liked Videos Overview:")
+      console.log("========================")
+      console.log(`Total liked videos fetched: ${result.result.length}`)
+      result.result.forEach((liked, index) => {
+        console.log(`\nLiked Video ${index + 1}:`)
+        console.log("-------------------")
+        console.log(`ID: ${liked.id}`)
+        console.log(`Description: ${liked.desc}`)
+        if (liked.author) {
+          console.log(
+            `Author: ${liked.author.nickname} (@${liked.author.username})`
+          )
+        }
+        if (liked.createTime) {
+          console.log(
+            `Created: ${new Date(
+              Number(liked.createTime) * 1000
+            ).toLocaleString()}`
+          )
+        }
+        if (liked.stats) {
+          console.log("Statistics:")
+          console.log(`- Likes: ${liked.stats.diggCount}`)
+          console.log(`- Favorites: ${liked.stats.collectCount}`)
+          console.log(`- Comments: ${liked.stats.commentCount}`)
+          console.log(`- Shares: ${liked.stats.shareCount}`)
+          console.log(`- Plays: ${liked.stats.playCount}`)
+          console.log(`- Reposts: ${liked.stats.repostCount}`)
+        }
+        if (liked.video?.playAddr) {
+          console.log(`Video URL: ${liked.video.playAddr}`)
+        }
+        if (liked.imagePost?.length) {
+          console.log(
+            `Images: \n${liked.imagePost
+              .map((img) => img.images)
+              .join("\n  - ")}`
+          )
+        }
+        console.log("========================")
+      })
+    } else {
+      console.error("Error:", result.message)
+    }
+  } catch (error) {
+    console.error("Test failed:", error)
+  }
+}
+
+testUserLiked()