התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

הגדרות פוסט ב-TikTok דרך ה-API: פרטיות, תגובות, Duet ו-Stitch

ממשק ה-API של TikTok for Business מקבל את הגדרות הפוסט בקריאת הפרסום, בעיקר בתוך post_info. סרטונים מקבלים את disable_comment, disable_duet וגם disable_stitch, שער לפי thumbnail_offset או custom_thumbnail_url, את התוויות is_brand_organic וגם is_branded_content, ואת is_ai_generated. פוסטים של תמונות מקבלים את privacy_level, את disable_comment, את אותן תוויות מותג ואת auto_add_music. GET /business/video/settings/ מחזיר את הערכים שכל חשבון מאפשר.

easyCoexistence מפרסמת סרטוני TikTok ופוסטים של תמונות עם publish_tiktok_post מ-Claude, מ-ChatGPT או מהקוד שלכם, עם הכיתוב, הכותרת של פוסט תמונה והתגובות פעילות או כבויות, ו-get_social_credentials נותן לקוד שלכם את האסימון לקריאת ההגדרות המותרות של החשבון.

3 levels

האפשרויות לפרטיות של פוסטי תמונות בחשבון ציבורי: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS וגם SELF_ONLY

FOLLOWER_OF_CREATOR

רמת הפרטיות שחשבון פרטי מקבל במקום PUBLIC_TO_EVERYONE: נראה לעוקביו בלבד.

false

ברירת המחדל של disable_comment, disable_duet וגם disable_stitch היא false, כך שתגובות, Duets ו-Stitches נשארות פעילות אלא אם הוגדרו אחרת.

1080 x 1920

תמונת השער המותאמת הגדולה ביותר לסרטון חייבת להיות לפחות 360 x 360 פיקסלים, ועד 20 MB

Paid partnership

התווית is_branded_content מתווספת לפוסט, והיא גוברת כשגם is_brand_organic הוא true

privacy_level

שדה חובה בתוך post_info של פוסט תמונה, מוגבל לאפשרויות שמחזירה הקריאה GET /business/video/settings/ לחשבון

אילו הגדרות כל נקודת הקצה לפרסום מקבלת?

/business/video/publish/ וגם /business/photo/publish/ חולקות חלק מההגדרות ושונות בחלק האחר. רובן נמצאות בתוך post_info, ואילו custom_thumbnail_url וגם photo_cover_index נמצאים ברמה העליונה של הגוף. להלן ההגדרות זו לצד זו, כפי ש-TikTok מפרטת בהפניות שלה. במקום שבו נקודה לא מתעדת הגדרה, מופיע הערך No field:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

מה החשבון מאפשר?

GET /business/video/settings/ עם business_id מחזיר את המגבלות של החשבון על הפוסטים שלו. קוראים אותו לפני הפרסום, כי TikTok מקבלת רק את הערכים שהיא מפרטת:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS וגם SELF_ONLY לחשבון ציבורי; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS וגם SELF_ONLY לחשבון פרטי.
  • comment_disabled: true כשהחשבון לא מקבל תגובות מאף אחד, ואז disable_comment מקבל רק את הערך true
  • duet_disabled וגם stitch_disabled: true כשהחשבון מאפשר Duet או Stitch רק ל-Only you, או כשהוא פרטי; המתג המתאים מקבל אז רק את הערך true
  • max_video_post_duration_sec: האורך המרבי של סרטון שהחשבון יכול לפרסם; סרטון ארוך ממנו נכשל.
Read an account's post settings
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "comment_disabled": false,
    "duet_disabled": false,
    "max_video_post_duration_sec": 600,
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "stitch_disabled": false
  }
}

מי יכול לראות את הפוסט?

בפוסט תמונה, הערך של privacy_level שנשלח קובע מי רואה: PUBLIC_TO_EVERYONE לאנשים בתוך TikTok ומחוצה לה, MUTUAL_FOLLOW_FRIENDS לעוקבים שהחשבון עוקב אחריהם בחזרה, FOLLOWER_OF_CREATOR לעוקבים של חשבון פרטי, או SELF_ONLY. בנקודת הסרטון אין שדה פרטיות, כי היא מפרסמת סרטונים ציבוריים. פוסט שמוגדר ל-Friends או ל-Only you לא אפשר לצפות בו גם דרך embed_url שלו.

איך פועלות התגובות, ה-Duet וה-Stitch?

כל אחד מהם הוא מתג שמכבה את התכונה כשהוא מוגדר ל-true. disable_comment קיים בשתי הנקודות; disable_duet וגם disable_stitch קיימים בסרטונים בלבד. כל אלה מוגדרים כברירת מחדל ל-false, כלומר התכונה פעילה, במסגרת מה שההגדרות הפרטיות של החשבון מאפשרות: חשבון שמקבל תגובות מאף אחד, או שמגביל Duet או Stitch ל-Only you, יכול לפרסם רק כשהמתג מוגדר ל-true בלבד.

איך נבחר השער?

בסרטון יש שתי דרכים. post_info.thumbnail_offset בוחר פריים לפי זמנו במילישניות, 0 כברירת מחדל, ומעוגל כלפי מעלה לפריים הקרוב ביותר. אם הזמן חורג מסוף הסרטון, נשלח וובהוק (Webhook) של כישלון, והסרטון לא מתפרסם. custom_thumbnail_url, ברמה העליונה של הגוף, מביא במקומו תמונה, וTikTok מתעלמת אז מהערך של thumbnail_offset. בפוסט תמונה, photo_cover_index בוחר אחת מהתמונות, והספירה מתחילה מאפס.

  • תמונת שער מותאמת בפורמטים JPG, JPEG, WebP או PNG, בגודל עד 20 MB
  • גודל: מ-360 x 360 פיקסלים, עד 1080 x 1920 או 1920 x 1080
  • מיקום: דומיין או קידומת של כתובת ה-URL שאומתה לאפליקציה, כמו הסרטון עצמו

מה משמעות תוויות המותג?

גילויים ש-TikTok מציגה בפוסט. כשהערך של is_brand_organic הוא true, הפוסט מסומן כתוכן קידום מכירות, והתווית נועדה לפוסטים שמקדמים את העסק של החשבון עצמו. כשהערך של is_branded_content הוא true, הפוסט מסומן כשיתוף פעולה בתשלום, והתווית נועדה לפוסטים שנעשים בשיתוף פעולה בתשלום עם מותג, והיא גוברת כששני הערכים פעילים. בסרטון עם is_branded_content, tto_invite_link יכול לקשר את הפוסט לקמפיין של TikTok One Creator Marketplace שהחשבון הצטרף אליו.

אילו אפשרויות נוספות יש בתוך post_info?

עוד כמה, שכל אחת מתועדת בנקודה שמקבלת אותה:

  • is_ai_generated, בסרטונים: מסמן את הפוסט בתווית Creator labeled as AI-generated, ואי אפשר לשנות אותה אחרי הפרסום.
  • location_id וגם location_name: תג מיקום שמאתרים דרך הקריאה GET /business/publish/location/
  • music_sound_info: צליל מסחרי לפי מזהה; בסרטונים גם עוצמתו, בין 0 ל-100, וההתחלה והסיום שלו במילישניות.
  • auto_add_music, בפוסטי תמונות: מוסיף מוזיקה מומלצת, שאפשר לשנות אחר כך באפליקציה של TikTok
  • upload_to_draft או is_draft: שולח את הפוסט לתיבת הנכנסת של היוצר כטיוטה, עם הסרטון, בהרשאת video.upload
  • is_ads_only, בסרטונים: מפרסם פוסט מסוג Only show in ads שנשאר מחוץ לפרופיל.

אילו הגדרות קובעת publish_tiktok_post?

שלוש מגיעות מהבקשה שלכם: הכיתוב, הכותרת של פוסט תמונה, וגם disable_comment. easyCoexistence שולחת את is_brand_organic וגם את is_branded_content עם הערך false, מפרסמת פוסטים של תמונות כ-PUBLIC_TO_EVERYONE עם התמונה הראשונה כשער, ומשאירה את שאר ההגדרות של הסרטון בחוץ. על disable_duet וגם disable_stitch חל false, על thumbnail_offset חל 0, ועל is_ai_generated חל false, כך פועלת ברירת המחדל של TikTok.

איך שולחים את שאר ההגדרות?

מהקוד שלכם, עם האסימון וה-business_id של החשבון מ-get_social_credentials, בנתיבי ה-Business API תחת business/. GET ל-business/video/settings/ קורא את המגבלות של החשבון. POST ל-business/video/publish/ או ל-business/photo/publish/ יכול לשאת את הגוף המלא המתועד, והוא מגיע ל-TikTok כפי שהוא כתוב, כולל כתובות ה-URL של המדיה, ולכן הן חייבות להיות על דומיין או קידומת של כתובת ה-URL שאומתו לאפליקציה. הקריאה publish_tiktok_post מנתבת את הקישור שלכם דרך נתיב המדיה המאומת של easyCoexistence

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

טעויות נפוצות

  • ציפייה שהשדה privacy_level יעבוד בסרטון. נקודת הסרטון מפרסמת רק סרטונים ציבוריים ואין בה שדה כזה; פוסטי תמונות הם אלה שמקבלים אותו.
  • הפעלת תגובות לחשבון שאינו מקבל תגובות כלל. כשהשדה comment_disabled שווה ל-true, TikTok מקבלת את disable_comment רק כשערכו true
  • הגדרת thumbnail_offset מעבר לסוף הסרטון. נשלח וובהוק של כישלון, והסרטון לא מתפרסם.
  • שליחת PUBLIC_TO_EVERYONE לחשבון פרטי. רשימת privacy_level_options שלו מציגה במקום זאת FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS וגם SELF_ONLY
עושים את זה עם EasyCoexistence

מ-US$ 9 עד US$ 0.75 לחיבור לחודש, והמחיר יורד ככל שמוסיפים חיבורים, ועם 3 הימים הראשונים בחינם.

שאלות נפוצות

אפשר לפרסם סרטון TikTok פרטי דרך ה-API?

לא עם נקודת הסרטון, שמפרסמת רק פוסטים ציבוריים. פוסטי תמונות מקבלים את privacy_level, כולל SELF_ONLY, וסרטון יכול להישלח כטיוטה לתיבת הנכנסת של היוצר באמצעות upload_to_draft

איך מכבים את Duet ו-Stitch דרך ה-API?

מגדירים את post_info.disable_duet וגם post_info.disable_stitch ל-true בנקודה /business/video/publish/. כשהחשבון כבר מגביל אותם, TikTok מקבלת רק את הערך true

אפשר להוסיף תג מיקום דרך ה-API של TikTok?

כן. post_info מקבל location_id וגם location_name, לתג מיקום שנמצא דרך הקריאה GET /business/publish/location/

מה ההבדל בין is_brand_organic לבין is_branded_content?

is_brand_organic מוסיף תווית תוכן קידום מכירות לעסק של החשבון עצמו; is_branded_content מוסיף תווית שיתוף פעולה בתשלום, והיא גוברת כששני הערכים פעילים.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-