API TikTok

​

Publication vidéo 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 ne prend pas actuellement en charge les sauts de ligne dans le texte de publication. Les sauts de ligne inclus seront ignorés.
• Une seule vidéo ou jusqu’à 35 images peuvent être publiées. TikTok ne prend pas en charge la combinaison de vidéo et d’images. Voir ci-dessous pour plus de détails.
• Si la vidéo ne se termine pas par une extension connue, utilisez isVideo.
• TikTok prend également en charge l’envoi de médias sans texte de publication. Si vous ne souhaitez pas inclure de texte, envoyez une chaîne vide post: "".
• Consultez TikTok Media Guidelines et TikTok Authorization pour plus d’informations.

​

Exigences vidéo TikTok

• Consultez TikTok Video Requirements.
• La vidéo doit se terminer par une extension vidéo connue telle que mp4. Vous pouvez utiliser un reverse proxy pour l’URL, ajouter une URL vanity avec un CDN, ou utiliser le point de terminaison /media.
• La limite de caractères du texte de publication TikTok est de 2 200.

​

Publication image 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 ne prend pas actuellement en charge les sauts de ligne dans le texte de publication. Les sauts de ligne inclus seront ignorés.
• Une seule vidéo ou jusqu’à 35 images peuvent être publiées.
• TikTok ne prend pas en charge la combinaison de vidéo et d’images. Voir ci-dessous pour plus de détails.
• Les images doivent être de type JPG, JPEG ou WEBP. TikTok n’accepte pas les fichiers média PNG.
• Vous pouvez également sélectionner l’une des images comme photo de couverture avec imageCoverIndex. Par défaut, la première image est utilisée. Voir ci-dessous pour plus de détails.

​

Exigences d’image TikTok

• Consultez TikTok Image Requirements.
• Jusqu’à 35 images peuvent être incluses dans une publication, avec un maximum de 20 Mo par image.
• Les images doivent être de type JPG, JPEG ou WEBP. TikTok n’accepte pas les fichiers média PNG.
• La limite de caractères du texte de publication TikTok est de 2 200.

​

Traitement TikTok

• Vous pouvez récupérer le statut final de la publication TikTok à l’aide des webhooks ou du point de terminaison /history et cela prend généralement jusqu’à 1-2 minutes pour être disponible.
• Lorsque l’utilisateur publie la vidéo dans l’application mobile TikTok, un webhook « scheduled » sera envoyé avec subAction: "tikTokPublished".
• Un premier commentaire sur une publication TikTok est différé : il est publié automatiquement une fois que le webhook tikTokPublished résout l’id réel de la vidéo, et non au moment de la publication. La visibility de la vidéo doit être public, sinon le premier commentaire ne peut pas être publié et une erreur de commentaire est renvoyée.
• Si une erreur survient, par exemple si TikTok n’a pas pu traiter la vidéo ou si les tests internes d’Ayrshare ont échoué, le champ id sera défini sur « failed » et le champ errors contiendra les détails de l’erreur.
• Le champ idShare est utilisé pour référencer en interne la vidéo en attente.

​

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

​

Options

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

​

Options de visibilité

​

Miniature vidéo

1. En utilisant le paramètre thumbNailOffset pour définir une frame de miniature.
2. En utilisant le paramètre thumbNail pour définir une image de miniature depuis une URL.

​

Offset de miniature

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

​

URL de miniature

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

​

Mentions TikTok

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

​

Brouillon de publication 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
  }
}

​

Renouvellement de l’autorisation

• Une notification par e-mail et par webhook (action sociale) sera envoyée 15 jours avant l’expiration de l’autorisation.
• La date de renouvellement requise et le nombre de jours restants peuvent être récupérés depuis le point de terminaison /user.

​

Limites de caractères

​

Informations complémentaires