> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok API

> Optionen zum Posten mit der TikTok API

<Info>
  Ayrshare bietet [direkte Veröffentlichung von TikTok-Videos](https://www.ayrshare.com/blog/introducing-tiktok-direct-publishing-analytics-and-commenting/), Kommentarverwaltung und den Abruf erweiterter Analytics für Ihr persönliches oder geschäftliches TikTok-Konto über die TikTok API.

  TikTok verarbeitet Videos und Fotos asynchron, sodass die JSON-Antwort sowohl bei sofortigen als auch geplanten Beiträgen den Status „pending" enthält. Sobald TikTok die Verarbeitung abgeschlossen hat, wird Ihr registriertes [Scheduled-Action-Webhook](/apis/webhooks/actions#scheduled-action) aufgerufen.
</Info>

## TikTok-Videobeitrag

JSON für einen einfachen TikTok-Videobeitrag, der direkt veröffentlicht wird:

```json TikTok Video Post theme={"system"}
{
  "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"]
}
```

Beispiel für eine JSON-Post-Antwort:

```json TikTok Video Post Response theme={"system"}
{
  "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"
}
```

<ul class="custom-bullets">
  <li>
    TikTok unterstützt derzeit keine Zeilenumbrüche im Beitragstext. Enthaltene Zeilenumbrüche werden
    ignoriert.
  </li>

  <li>
    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.
  </li>

  <li>
    Wenn das Video nicht mit einer bekannten Endung endet, verwenden Sie
    [isVideo](/apis/post/overview#video-extension).
  </li>

  <li>
    TikTok unterstützt auch das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten,
    senden Sie einen leeren String `post: ""`.
  </li>

  <li>
    Weitere Informationen finden Sie unter [TikTok-Medienrichtlinien](/media-guidelines/tiktok) und [TikTok-Autorisierung](/dashboard/connect-social-accounts/tiktok).
  </li>
</ul>

### TikTok-Video-Anforderungen

<ul class="custom-bullets">
  <li>Siehe [TikTok-Video-Anforderungen](/media-guidelines/tiktok#video).</li>

  <li>
    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](https://www.ayrshare.com/blog/how-to-put-a-cdn-in-front-of-firebase-cloud-storage/) hinzu oder verwenden Sie den Endpunkt
    [/media](/apis/media/overview).
  </li>

  <li>Das TikTok-Zeichenlimit für Beitragstext beträgt 2.200.</li>
</ul>

<Note>
  TikTok begrenzt die API-Videoveröffentlichung auf 6 Videos pro Minute mit einer Obergrenze von 15 Videos pro
  Tag.
</Note>

## TikTok-Bildbeitrag

JSON für einen einfachen TikTok-Bild-(Foto-)Beitrag, der direkt veröffentlicht wird:

```json TikTok Image Post theme={"system"}
{
  "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"]
}
```

Beispiel für eine JSON-Antwort:

```json TikTok Image Post Response theme={"system"}
{
  "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"
}
```

<ul class="custom-bullets">
  <li>
    TikTok unterstützt derzeit keine Zeilenumbrüche im Beitragstext. Enthaltene Zeilenumbrüche werden
    ignoriert.
  </li>

  <li>Entweder ein Video oder bis zu 35 Bilder können veröffentlicht werden.</li>

  <li>
    TikTok unterstützt keine Kombination aus Video und Bildern. Weitere Details finden Sie unten.
  </li>

  <li>Die Bilder müssen vom Typ JPG, JPEG oder WEBP sein. TikTok akzeptiert keine PNG-Mediendateien.</li>

  <li>
    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.
  </li>
</ul>

### TikTok-Bildanforderungen

<ul class="custom-bullets">
  <li>Siehe [TikTok-Bildanforderungen](/media-guidelines/tiktok#images).</li>
  <li>Bis zu 35 Bilder können in einem Beitrag enthalten sein, jeweils mit maximal 20 MB pro Bild.</li>
  <li>Die Bilder müssen vom Typ JPG, JPEG oder WEBP sein. TikTok akzeptiert keine PNG-Mediendateien.</li>
  <li>Das TikTok-Zeichenlimit für Beitragstext beträgt 2.200.</li>
</ul>

<Note>
  TikTok begrenzt die API-Fotoveröffentlichung auf 6 Fotos pro Minute mit einer Obergrenze von 15 Fotos pro
  Tag.
</Note>

## TikTok-Verarbeitung

TikTok verarbeitet Videos und Bilder asynchron, daher wird das Feld `id` in der Antwort auf `"pending"` gesetzt.
Sobald TikTok die Verarbeitung abgeschlossen hat, üblicherweise innerhalb von 1–2 Minuten, wird das Feld `id` mit der TikTok-Video-`id` aktualisiert und ein `postUrl` hinzugefügt.

<ul class="custom-bullets">
  <li>
    Sie können den endgültigen Status des TikTok-Beitrags über
    [Webhooks](/apis/webhooks/actions#tiktok-publishing-webhook) oder den
    [/history](/apis/history/overview)-Endpunkt abrufen. Das dauert in der Regel 1–2 Minuten.
  </li>

  <li>
    Wenn der Nutzer das Video in der mobilen TikTok-App veröffentlicht, wird ein „scheduled"-Webhook mit
    `subAction: "tikTokPublished"` gesendet.
  </li>

  <li>
    Ein [First Comment](/apis/post/overview#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.
  </li>

  <li>
    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.
  </li>

  <li>Der `idShare` wird zur internen Referenzierung des ausstehenden Videos verwendet.</li>
</ul>

## TikTok-Optionen

Beim Veröffentlichen eines TikTok-Videos oder von Bildern stehen [zusätzliche Optionen](/apis/post/social-networks/tiktok#available-tiktok-options) zur Verfügung.

Beispiel Videoveröffentlichung:

```json TikTok Video Publishing theme={"system"}
{
  "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.
  }
}
```

Beispiel Bildveröffentlichung:

```json TikTok Image Publishing theme={"system"}
{
  "tikTokOptions": {
    "imageCoverIndex": 1, // Use the second image in the mediaUrls.
    "title": "Amazing images"
  }
}
```

### Optionen

Die folgenden Optionen sind für TikTok-Beiträge verfügbar.
Sie sollten dem Objekt `tikTokOptions` hinzugefügt werden.
Weitere Details zu jeder Option finden Sie unten.

```json TikTok Options theme={"system"}
{
  "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"
  }
}
```

<ParamField body="autoAddMusic" type="boolean" default={false}>
  Ob dem Beitrag automatisch empfohlene Musik hinzugefügt werden soll.
  Wenn Sie dieses Feld auf `true` setzen, können Sie die Musik später in der TikTok-App ändern.

  Medientyp: Bild
</ParamField>

<ParamField body="disableComments" type="boolean" default={false}>
  Ob Kommentare zum veröffentlichten Beitrag deaktiviert werden sollen.

  Medientyp: Video, Bild
</ParamField>

<ParamField body="disableDuet" type="boolean" default={false}>
  Deaktiviert Duets zum veröffentlichten Video.

  Medientyp: Video
</ParamField>

<ParamField body="disableStitch" type="boolean" default={false}>
  Deaktiviert Stitch zum veröffentlichten Video.

  Medientyp: Video
</ParamField>

<ParamField body="draft" type="boolean" default={false}>
  Ob ein Entwurf des Beitrags erstellt werden soll.

  Weitere Informationen finden Sie unter [Entwurfsoptionen](/apis/post/social-networks/tiktok#tiktok-video-draft-post).

  Medientyp: Video oder Bild
</ParamField>

<ParamField body="isAIGenerated" type="boolean" default={false}>
  Ob der Umschalter für KI-generierte Inhalte für den Videobeitrag aktiviert werden soll.

  Wenn Sie den Umschalter aktivieren, wird Ihr Video nach der Veröffentlichung als „Creator labeled as AI-generated" gekennzeichnet und kann nicht geändert werden.
  Die Kennzeichnung „Creator labeled as AI-generated" weist darauf hin, dass der Inhalt vollständig KI-generiert oder erheblich mit KI bearbeitet wurde.

  <Note>
    Das Aktivieren der Einstellung für KI-generierte Inhalte wirkt sich nicht auf die Verbreitung Ihres Videos aus, solange
    es nicht gegen die [Community
    Guidelines](https://www.tiktok.com/community-guidelines/en/) von TikTok verstößt.
  </Note>

  Medientyp: Video
</ParamField>

<ParamField body="isBrandedContent" type="boolean" default={false}>
  Ob der Umschalter <a href="https://creatormarketplace.tiktok.com/help#/doc/9493/10008169">Branded Content</a> aktiviert werden soll. Wenn dieses Feld auf `true` gesetzt ist, wird das Video als Branded Content gekennzeichnet, was auf eine bezahlte Partnerschaft mit einer Marke hinweist. Dem Video wird das Label „Paid partnership" hinzugefügt.

  Medientyp: Video, Bild
</ParamField>

<ParamField body="isBrandOrganic" type="boolean" default={false}>
  Ob der Umschalter Brand Organic Content aktiviert werden soll. Wenn dieses Feld auf `true` gesetzt ist, wird das Video als Brand Organic Content gekennzeichnet, was darauf hinweist, dass Sie sich selbst oder Ihr eigenes Unternehmen bewerben. Dem Video wird das Label „Promotional content" hinzugefügt.

  Medientyp: Video, Bild
</ParamField>

<ParamField body="imageCoverIndex" type="number" default="0">
  Der Index in `mediaUrls`, der als Cover für den Beitrag verwendet werden soll.

  Medientyp: Bild
</ParamField>

<ParamField body="title" type="string">
  Der Titel des Beitrags.

  Medientyp: Bild
</ParamField>

<ParamField body="thumbNailOffset" type="number">
  Der Frame, der als Video-Cover verwendet werden soll.

  Weitere Informationen finden Sie unter [Video-Thumbnail-Optionen](/apis/post/social-networks/tiktok#video-thumbnail).

  Medientyp: Video
</ParamField>

<ParamField body="visibility" type="string" default="public">
  Wie der Beitrag geteilt wird und wer ihn sehen kann.

  Werte: `public`, `private`, `followers` oder `friends`.

  Weitere Informationen finden Sie unter [Sichtbarkeitsoptionen](/apis/post/social-networks/tiktok#visibility-options).

  Medientyp: Bild
</ParamField>

### Sichtbarkeitsoptionen

| Sichtbarkeit | Beschreibung                               |
| :----------- | :----------------------------------------- |
| public       | Für alle TikTok-Nutzer sichtbar.           |
| private      | Privat, nur für das Konto selbst sichtbar. |
| followers    | Nur für Follower des Kontos sichtbar.      |
| friends      | Nur für gegenseitige Follower sichtbar.    |

Private Beiträge bleiben im Status `pending`, und es wird kein TikTok-Webhook gesendet, bis der Beitrag öffentlich gemacht wird.

## Video-Thumbnail

Es gibt zwei Möglichkeiten, ein Thumbnail (auch Coverfoto genannt) für ein TikTok-Video festzulegen:

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

Für das Festlegen eines Thumbnails werden nur Videos unterstützt.

### Thumbnail-Offset

Legen Sie ein Thumbnail für ein TikTok-Video fest, indem Sie einen Offset-Frame auswählen.

```json TikTok Video Thumbnail Offset theme={"system"}
{
  "tikTokOptions": {
    "thumbNailOffset": 30000 // milliseconds of offset image
  }
}
```

Der Offset ist die Position in Millisekunden des Thumbnail-Frames. Der Standardwert ist `0`, was dem ersten Frame des Videos entspricht.

### Thumbnail-URL

Legen Sie ein Thumbnail für ein TikTok-Video fest, indem Sie ein Bild von einer URL hochladen.

```json TikTok Video Thumbnail URL theme={"system"}
{
  "tikTokOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

Wenn Sie den Parameter `thumbNail` verwenden, wird der Parameter `thumbNailOffset` ignoriert.

Weitere Informationen finden Sie unter [TikTok-Thumbnail-Anforderungen](/media-guidelines/tiktok#video-thumbnail).

## TikTok-Erwähnungen

Erwähnen Sie einen anderen TikTok-Handle, indem Sie `@handle` im Beitragstext hinzufügen. Beispiel:

```json TikTok Mention theme={"system"}
{
  "post": "Love the @ayrshare social media api"
}
```

<Warning>
  Bitte lesen Sie die [wichtigen Regeln](/testing/post-verification#mentions) zu Erwähnungen.
</Warning>

## TikTok-Entwurfsbeitrag

Erstellen Sie einen Entwurf für ein TikTok-Video oder -Bild, sodass Sie das Video oder Bild vor der Veröffentlichung bearbeiten können.

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

Der Video- oder Bild-Entwurfsbeitrag befindet sich in der TikTok-App unter den Benachrichtigungen **Inbox** in der unteren Zeile.
Suchen Sie nach einer **System notifications**-Nachricht und klicken Sie dann oben auf die Nachricht **Your content from Ayrshare is ready**.

Der Ayrshare-`postUrl` bleibt im Status `pending`, bis das Video veröffentlicht wird. First Comment wird für Entwurfsbeiträge nicht unterstützt.

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/tiktok-draft-post.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=6e7fdce5ef106f6af6cd060bfbc446ba" alt="TikTok Draft Post" class="center" width="278" height="600" data-path="images/apis/post/tiktok-draft-post.webp" />

## Autorisierungs-Refresh

TikTok muss *jedes Jahr* über die Seite „Social Accounts" neu autorisiert werden.

<ul class="custom-bullets">
  <li>
    Eine E-Mail- und Webhook-Social-Action-Benachrichtigung wird 15 Tage vor dem Ablauf der Autorisierung
    gesendet.
  </li>

  <li>
    Das Refresh-Fälligkeitsdatum und die verbleibenden Tage können über den Endpunkt
    [/user](/apis/user/overview) abgerufen werden.
  </li>
</ul>

## Zeichenbeschränkungen

Weitere Informationen finden Sie unter [TikTok-Zeichenbeschränkungen](/help-center/technical-support/character_limits#tiktok-character-limits).

## Weitere Informationen

Zusätzliche [Beispiele zur Nutzung der TikTok API](https://www.ayrshare.com/blog/tiktok-api-how-to-post-to-tiktok-using-a-social-media-api/).