TikTok API

​

TikTok-Videobeitrag

{
  "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 unterstützt derzeit keine Zeilenumbrüche im Beitragstext. Enthaltene Zeilenumbrüche werden ignoriert.
• Entweder ein Video oder bis zu 35 Bilder können veröffentlicht werden. TikTok unterstützt keine Kombination aus Video und Bildern. Weitere Details finden Sie unten.
• Wenn das Video nicht mit einer bekannten Endung endet, verwenden Sie isVideo.
• TikTok unterstützt auch das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten, senden Sie einen leeren String post: "".
• Weitere Informationen finden Sie unter TikTok-Medienrichtlinien und TikTok-Autorisierung.

​

TikTok-Video-Anforderungen

• Siehe TikTok-Video-Anforderungen.
• Das Video muss mit einer bekannten Videoendung wie mp4 enden. Betreiben Sie einen Reverse-Proxy für die URL, fügen Sie eine Vanity-URL mit einem CDN hinzu oder verwenden Sie den Endpunkt /media.
• Das TikTok-Zeichenlimit für Beitragstext beträgt 2.200.

​

TikTok-Bildbeitrag

{
  "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 unterstützt derzeit keine Zeilenumbrüche im Beitragstext. Enthaltene Zeilenumbrüche werden ignoriert.
• Entweder ein Video oder bis zu 35 Bilder können veröffentlicht werden.
• TikTok unterstützt keine Kombination aus Video und Bildern. Weitere Details finden Sie unten.
• Die Bilder müssen vom Typ JPG, JPEG oder WEBP sein. TikTok akzeptiert keine PNG-Mediendateien.
• Sie können außerdem eines der Bilder als Coverfoto mit imageCoverIndex auswählen. Standardmäßig wird das erste Bild verwendet. Weitere Details finden Sie unten.

​

TikTok-Bildanforderungen

• Siehe TikTok-Bildanforderungen.
• Bis zu 35 Bilder können in einem Beitrag enthalten sein, jeweils mit maximal 20 MB pro Bild.
• Die Bilder müssen vom Typ JPG, JPEG oder WEBP sein. TikTok akzeptiert keine PNG-Mediendateien.
• Das TikTok-Zeichenlimit für Beitragstext beträgt 2.200.

​

TikTok-Verarbeitung

• Sie können den endgültigen Status des TikTok-Beitrags über Webhooks oder den /history-Endpunkt abrufen. Das dauert in der Regel 1–2 Minuten.
• Wenn der Nutzer das Video in der mobilen TikTok-App veröffentlicht, wird ein „scheduled”-Webhook mit subAction: "tikTokPublished" gesendet.
• Ein First Comment an einem TikTok-Beitrag wird verzögert: Er wird automatisch gepostet, sobald das tikTokPublished-Webhook die tatsächliche Video-id auflöst, nicht zum Zeitpunkt der Veröffentlichung. Die Video-visibility muss public sein, andernfalls kann der First Comment nicht gepostet werden und es wird ein Kommentar-Fehler zurückgegeben.
• Tritt ein Fehler auf, etwa weil TikTok das Video nicht verarbeiten konnte oder interne Ayrshare-Prüfungen fehlgeschlagen sind, wird das Feld id auf „failed” gesetzt und das Feld errors enthält die Fehlerdetails.
• Der idShare wird zur internen Referenzierung des ausstehenden Videos verwendet.

​

TikTok-Optionen

{
  "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"
  }
}

​

Optionen

{
  "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"
  }
}

​

Sichtbarkeitsoptionen

​

Video-Thumbnail

1. Mit dem Parameter thumbNailOffset, um einen Thumbnail-Frame festzulegen.
2. Mit dem Parameter thumbNail, um ein Thumbnail-Bild von einer URL festzulegen.

​

Thumbnail-Offset

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

​

Thumbnail-URL

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

​

TikTok-Erwähnungen

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

​

TikTok-Entwurfsbeitrag

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

​

Autorisierungs-Refresh

• Eine E-Mail- und Webhook-Social-Action-Benachrichtigung wird 15 Tage vor dem Ablauf der Autorisierung gesendet.
• Das Refresh-Fälligkeitsdatum und die verbleibenden Tage können über den Endpunkt /user abgerufen werden.

​

Zeichenbeschränkungen

​

Weitere Informationen