tiktok-uploader-api

n8n community nodes for TikTok video uploads, profile details, showcase products, and music

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.3.2
Author: TikTok Uploader API contributors

Documentation

n8n-nodes-tiktok-uploader-api

n8n Community Node TikTok Uploader API & Profile Detail.

Sau khi package được publish, cài đặt trong Settings → Community Nodes bằng
tên n8n-nodes-tiktok-uploader-api.

Các Node trong Package

  1. TikTok Uploader (tiktokUploader): Upload video lên TikTok kèm caption, lịch đăng, giỏ hàng TikTok Shop (product_id), và bài hát nền TikTok (music_id).
  2. Get TikTok Profile Detail (tikTokProfileDetail): Lấy dữ liệu chi tiết từ TikTok:
    • Product: Lấy danh sách sản phẩm trong giỏ hàng TikTok Shop showcase (getShowcaseProducts).
    • Music:
      • Lấy danh sách nhạc yêu thích / đã lưu của tài khoản (getFavoriteMusicList) kèm phân trang cursor.
      • Lấy link tải nhạc/video trực tiếp từ đường dẫn TikTok (getTikTokMusicUrl).

1. Get TikTok Profile Detail

Resource: Product

  • Operation: Get Products Showcase (getShowcaseProducts)
  • Giao diện:
    • TikTok Cookie: Bắt buộc.
    • Count: Số sản phẩm cần lấy (mặc định: 20).
    • Offset/Cursor: Vị trí bắt đầu (mặc định: 0).
    • Proxy Options: Tùy chọn proxy HTTP/HTTPS.

Resource: Music

  • Operation 1: Get Favorite Music List (getFavoriteMusicList):
    • TikTok Cookie: Bắt buộc (tự động nhận diện sec_user_id từ session).
    • Count: Số bài nhạc cần lấy (mặc định: 20).
    • Offset/Cursor: Con trỏ phân trang (mặc định: 0).
    • Trả về danh sách bài hát kèm cursor và has_more để tiếp tục phân trang.
  • Operation 2: Get TikTok Music URL (getTikTokMusicUrl):
    • URL: Đường dẫn video/nhạc TikTok (ví dụ https://www.tiktok.com/@user/video/123456...).
    • Trả về toàn bộ thông tin bài hát và video: music_url, music_id, music_title, video_play_url, v.v.

2. TikTok Uploader

Node tải video lên TikTok hỗ trợ:

Giao diện Field API Ghi chú
TikTok Cookie cookies Bắt buộc, có thể dùng Expression
Caption Text caption Bắt buộc, tối đa 2.200 UTF-16 units
Visibility Type visibility_type Public 0, Private 1, Friends 2
Video Input Type videoInputType Binary Field hoặc Video URL
Product Anchor anchors product_id và product_title (tối đa 30 ký tự)
Music Track music musicId, musicUrl, musicVolume
Cover Image cover coverUrl (URL ảnh JPG/PNG, tối đa 10MB)
Proxy URL proxy Tùy chọn proxy

Bảo mật

Cookie TikTok là thông tin đăng nhập nhạy cảm. Node đã tích hợp sẵn cơ chế ẩn/redact thông tin bí mật (cookie, sessionid, proxy password) trong error log.

Kiểm tra trước khi publish

npm run check

Để chạy smoke test riêng cho từng node:

npm run test:tiktok-profile-detail
npm run test:tiktok-uploader

Discussion