| import axios from "axios"; |
| import { sendSuccess, ErrorResponses } from "../../lib/response-helper.js"; |
|
|
| |
| const handler = { |
| name: "TikTok Downloader", |
| description: "Download videos or slide photos from TikTok URLs. Supports both standard and HD quality downloads.", |
| version: "1.0.0", |
| method: "GET", |
| category: ["downloader"], |
| alias: ["tiktok", "tt"], |
| tags: ["social-media", "video", "downloader"], |
|
|
| parameters: { |
| query: [ |
| { |
| name: "url", |
| type: "string", |
| required: true, |
| description: "TikTok video URL to download", |
| example: "https://www.tiktok.com/@username/video/1234567890", |
| pattern: "^https?:\\/\\/(www\\.|vm\\.)?tiktok\\.com\\/.+$" |
| } |
| ], |
| body: [], |
| headers: [] |
| }, |
|
|
| responses: { |
| 200: { |
| status: 200, |
| description: "Successfully retrieved TikTok video data", |
| example: { |
| status: 200, |
| author: "Ditzzy", |
| note: "Thank you for using this API!", |
| results: { |
| id: "1234567890", |
| title: "Video Title", |
| author: { |
| nickname: "Username", |
| unique_id: "username" |
| }, |
| play: "https://video-url.com/video.mp4", |
| wmplay: "https://video-url.com/video-watermark.mp4", |
| hdplay: "https://video-url.com/video-hd.mp4", |
| music: "https://music-url.com/audio.mp3", |
| duration: 15, |
| create_time: 1234567890 |
| } |
| } |
| }, |
| 400: { |
| status: 400, |
| description: "Invalid TikTok URL provided", |
| example: { |
| status: 400, |
| message: "Invalid URL - must be a valid TikTok URL" |
| } |
| }, |
| 404: { |
| status: 404, |
| description: "Missing required parameter", |
| example: { |
| status: 404, |
| message: "Missing required parameter: url" |
| } |
| }, |
| 500: { |
| status: 500, |
| description: "Server error or TikTok API unavailable", |
| example: { |
| status: 500, |
| message: "An error occurred, please try again later." |
| } |
| } |
| }, |
|
|
| exec: async (req, res) => { |
| const { url } = req.query; |
| |
| if (!url) { |
| return ErrorResponses.missingParameter(res, "url"); |
| } |
|
|
| if (!url.match(/tiktok/gi)) { |
| return ErrorResponses.invalidUrl(res, "Invalid URL - must be a valid TikTok URL"); |
| } |
|
|
| try { |
| const videoData = await fetchTikTokVideo(url); |
| return sendSuccess(res, videoData); |
| } catch (error) { |
| console.error("TikTok download error:", error); |
| return ErrorResponses.serverError(res); |
| } |
| } |
| }; |
|
|
| export default handler; |
|
|
| async function fetchTikTokVideo(url) { |
| const encodedParams = new URLSearchParams(); |
| encodedParams.set("url", url); |
| encodedParams.set("hd", "1"); |
|
|
| const response = await axios({ |
| method: "POST", |
| url: "https://tikwm.com/api/", |
| headers: { |
| "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8", |
| "Cookie": "current_language=en", |
| "User-Agent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Mobile Safari/537.36" |
| }, |
| data: encodedParams |
| }); |
|
|
| if (!response.data || !response.data.data) { |
| throw new Error("Invalid response from TikTok API"); |
| } |
|
|
| return response.data.data; |
| } |
