TikTok API

​

Bài đăng video TikTok

{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"]
}

{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "video.7088122496758679353.nzLqBWbf",
      "id": "pending",
      "isVideo": true,
      "platform": "tiktok"
    }
  ],
  "id": "lb42orDhySAZmLWtj6b6",
  "refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1",
  "post": "The best TikTok video ever #bestvideo"
}

• TikTok hiện không hỗ trợ ngắt dòng trong nội dung bài đăng. Các ngắt dòng được bao gồm sẽ bị bỏ qua.
• Có thể xuất bản một video hoặc lên đến 35 hình ảnh. TikTok không hỗ trợ kết hợp video và hình ảnh. Vui lòng xem bên dưới để biết thêm chi tiết.
• Nếu video không kết thúc bằng phần mở rộng đã biết, hãy sử dụng isVideo.
• TikTok cũng hỗ trợ gửi phương tiện mà không có nội dung bài đăng. Nếu bạn không muốn bao gồm nội dung bài đăng, hãy gửi một chuỗi rỗng post: "".
• Xem TikTok Media Guidelines và TikTok Authorization để biết thêm thông tin.

​

Yêu cầu video TikTok

• Vui lòng xem Yêu cầu video TikTok.
• Video phải kết thúc bằng phần mở rộng video đã biết như mp4. Vui lòng hoặc là reverse proxy URL, thêm một URL vanity với CDN, hoặc sử dụng endpoint /media.
• Giới hạn ký tự nội dung bài đăng của TikTok là 2.200.

​

Bài đăng hình ảnh TikTok

{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": [
    "https://img.ayrshare.com/012/gb.jpg",
    "https://img.ayrshare.com/random/photo-1.jpg"
  ], // Up to 35 images
  "platforms": ["tiktok"]
}

{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "p_pub_url~v2.7408974036430047275",
      "id": "pending",
      "isVideo": false,
      "platform": "tiktok"
    }
  ],
  "id": "8815mJ5bWApEebWjE233",
  "tikTokId": "p_pub_url~v2.7408974036430047333",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc333",
  "post": "Opportunity is missed by most people because it is dressed in overalls and looks like work - Thomas Edison"
}

• TikTok hiện không hỗ trợ ngắt dòng trong nội dung bài đăng. Các ngắt dòng được bao gồm sẽ bị bỏ qua.
• Có thể xuất bản một video hoặc lên đến 35 hình ảnh.
• TikTok không hỗ trợ kết hợp video và hình ảnh. Vui lòng xem bên dưới để biết thêm chi tiết.
• Hình ảnh phải thuộc loại JPG, JPEG, hoặc WEBP. TikTok không chấp nhận các file phương tiện PNG.
• Bạn cũng có thể chọn một trong các hình ảnh làm ảnh bìa với imageCoverIndex. Theo mặc định, hình ảnh đầu tiên được sử dụng. Vui lòng xem bên dưới để biết chi tiết.

​

Yêu cầu hình ảnh TikTok

• Vui lòng xem Yêu cầu hình ảnh TikTok.
• Có thể bao gồm tối đa 35 hình ảnh trong một bài đăng, với 20 MB cho mỗi hình ảnh.
• Hình ảnh phải thuộc loại JPG, JPEG, hoặc WEBP. TikTok không chấp nhận các file phương tiện PNG.
• Giới hạn ký tự nội dung bài đăng của TikTok là 2.200.

​

Xử lý TikTok

• Bạn có thể truy xuất trạng thái cuối cùng của bài đăng TikTok bằng webhooks hoặc endpoint /history và thường mất tối đa 1-2 phút để có sẵn.
• Khi người dùng xuất bản video trong ứng dụng TikTok di động, một webhook “scheduled” sẽ được gửi với subAction: "tikTokPublished".
• Một bình luận đầu tiên trên bài đăng TikTok bị hoãn: nó được đăng tự động khi webhook tikTokPublished giải quyết id video thực, không phải tại thời điểm xuất bản. visibility của video phải là public, nếu không bình luận đầu tiên không thể được đăng và một lỗi bình luận được trả về.
• Nếu xảy ra lỗi, chẳng hạn như TikTok không thể xử lý video hoặc các kiểm tra nội bộ của Ayrshare thất bại, trường id sẽ được đặt thành “failed” và trường errors sẽ chứa chi tiết lỗi.
• idShare được sử dụng để tham chiếu nội bộ cho video pending.

​

Tùy chọn TikTok

{
  "tikTokOptions": {
    "disableComments": true, // Default false. Disable comments on the published video.
    "disableDuet": true, // Default false. Disable duets on the published video.
    "disableStitch": true // Default false. Disable stitches on the published video.
  }
}

{
  "tikTokOptions": {
    "imageCoverIndex": 1, // Use the second image in the mediaUrls.
    "title": "Amazing images"
  }
}

​

Các tùy chọn

{
  "post": "The best TikTok video ever #bestvideo",
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "autoAddMusic": true,
    "disableComments": true,
    "disableDuet": true,
    "disableStitch": true,
    "draft": true,
    "isAIGenerated": true,
    "isBrandedContent": true,
    "isBrandOrganic": true,
    "imageCoverIndex": 1,
    "title": "Amazing images",
    "thumbNailOffset": 30000,
    "visibility": "public"
  }
}

​

Tùy chọn Visibility

​

Thumbnail video

1. Sử dụng tham số thumbNailOffset để đặt khung thumbnail.
2. Sử dụng tham số thumbNail để đặt hình ảnh thumbnail từ URL.

​

Thumbnail Offset

{
  "tikTokOptions": {
    "thumbNailOffset": 30000 // milliseconds of offset image
  }
}

​

Thumbnail URL

{
  "tikTokOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

​

Nhắc tên (Mention) trên TikTok

{
  "post": "Love the @ayrshare social media api"
}

​

Bài đăng nháp TikTok

{
  "post": "The best TikTok video ever #bestvideo", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "draft": true
  }
}

​

Làm mới cấp phép (Authorization Refresh)

• Một email và thông báo webhook social action sẽ được gửi trước 15 ngày kể từ ngày hết hạn cấp phép.
• Ngày yêu cầu làm mới và số ngày còn lại có thể được lấy từ endpoint /user.

​

Giới hạn ký tự

​

Thông tin bổ sung