איך מעלים סרטון ל-TikTok דרך ה-API
כדי לפרסם סרטון דרך ה-API של TikTok לעסקים, שולחים POST אל /business/video/publish/ עם business_id של החשבון, video_url שנמצא בדומיין או בקידומת URL מאומתים, ואובייקט post_info שמחזיק את הכיתוב וההגדרות, והכותרת Access-Token. הפרסום מחזיר share_id; מעבירים אותו כ-publish_id אל /business/publish/status/ עד שהשדה status מציג PUBLISH_COMPLETE ומופיעים post_ids.
easyCoexistence מפרסם סרטוני TikTok עם publish_tiktok_post מ-Claude, מ-ChatGPT או מהסוכן שלכם: מעבירים קישור HTTPS, כיתוב והאם תגובות פעילות, ואז עוקבים אחרי הפוסט עם get_tiktok_publish_status, בזמן שהקובץ מגיע ל-TikTok דרך נתיב המדיה המאומת שלו.
מוחזר על ידי קריאת הפרסום, לדוגמה v_pub_url~v1.2345123456789123456, ומועבר לקריאת הסטטוס כ-publish_id.
מאז, פרסום סרטונים מכתובות שהדומיין או קידומת ה-URL שלהן אינם מאומתים נדחה.
המגבלה של TikTok על פרסומי סרטונים לחשבון דרך נקודת הקצה לפרסום: עד 15 ביום.
כמה זמן post_ids יכולים להופיע אחרי PUBLISH_COMPLETE; לפי TikTok, כדאי לנסות שוב אחרי שלוש דקות.
נשלח בוובהוק (Webhook) post.publish.publicly_available כשפוסט עובר בדיקת תוכן, ומוכן לשאילתה של התובנות שלו.
מה צריך לפני הקריאה הראשונה?
שלושה דברים. אסימון גישה (Access Token) לחשבון TikTok, וה-open_id של החשבון, שמתקבלים מהחלפת האסימון; אפליקציית מפתחים שמחזיקה בהרשאה Video Publish תחת TikTok Accounts; וסרטון בכתובת ציבורית מסוג HTTPS או HTTP שנמצאת בדומיין או בקידומת URL שאומתו לאפליקציה. TikTok מוריד את הקובץ בעצמו, לכן הכתובת חייבת להישאר נגישה, ו-TikTok ממליץ שהכתובת תישאר זמינה לפחות 30 דקות.
איך נראית בקשת הפרסום?
POST אל https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ עם אסימון החשבון בכותרת Access-Token ו-Content-Type שמוגדר ל-application/json. גוף ה-JSON מציין את החשבון ב-business_id, את הקובץ ב-video_url, וההגדרות של הפוסט ב-post_info; הדוגמה הזו מפרסמת סרטון עם כיתוב, והתגובות, Duet ו-Stitch נשארים פעילים:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {
"caption": "Our new menu is live #food",
"is_brand_organic": false,
"is_branded_content": false,
"disable_comment": false,
"disable_duet": false,
"disable_stitch": false
}
}'מה עושה כל שדה בגוף?
השדות ש-TikTok מפרט בתיעוד לפוסט סרטון, מהרמה העליונה למטה. באותו גוף נמצאים גם השער, התווית של תוכן שנוצר בבינה מלאכותית, מיקום, טיוטות ואפשרות למודעות בלבד:
business_id: ה-open_idשל החשבון מהחלפת האסימון.video_url: הקובץ ש-TikTok מוריד, בפורמט MP4, MOV או WebM, בדומיין או בקידומת URL מאומתים.post_info: חובה בכל קריאה, גם כאובייקט ריק, ומכיל את ההגדרות של הפוסט.post_info.caption: עד 2,200 תווים שנספרים ב-UTF-16, עם תגיות (#hashtags) ועד 30 אזכורים (@mentions).post_info.is_brand_organicו-is_branded_content: התוויות 'תוכן קידומי' ו'שיתוף פעולה בתשלום', ש-TikTok מסמן בטבלה כחובה.post_info.disable_comment,disable_duetו-disable_stitch: true מכבה תגובות, Duet או Stitch; ברירת המחדל לכולם היא false.
מה TikTok מחזיר?
המעטפת הרגילה, עם מזהה משימת הפרסום בשדה data. קוד 0 פירושו ש-TikTok קיבל את המשימה, לא שהסרטון באוויר: TikTok עדיין צריך להוריד את הקובץ, לבדוק אותו ולבצע בדיקת תוכן לפוסט. בדוגמאות של TikTok, ה-share_id של סרטון מתחיל ב-v_pub_url, ושל פוסט תמונות ב-p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}איך עוקבים אחרי הפוסט עד שהוא עולה לאוויר?
בעזרת GET /business/publish/status/, שולחים את business_id ואת share_id כ-publish_id. status מציג PROCESSING_DOWNLOAD בזמן ש-TikTok מוריד את הקובץ, PUBLISH_COMPLETE לאחר שהפוסט עבר בדיקת תוכן, או FAILED עם סיבה. post_ids מופיע יחד עם PUBLISH_COMPLETE כשהפוסט גלוי לציבור, ועשוי להתעכב עד שלוש דקות. התהליך המלא ב-Python:
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"] # open_id from the token exchange
def call(method, path, **kwargs):
body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
if body.get("code") != 0: # errors arrive in code, usually with HTTP 200
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
return body["data"]
share_id = call("POST", "business/video/publish/", json={
"business_id": BUSINESS_ID,
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {"caption": "Our new menu is live #food",
"is_brand_organic": False, "is_branded_content": False},
})["share_id"]
for _ in range(30):
time.sleep(60) # each check is a call; TikTok's stages take minutes
s = call("GET", "business/publish/status/",
params={"business_id": BUSINESS_ID, "publish_id": share_id})
if s["status"] == "FAILED":
raise RuntimeError(s.get("reason"))
if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
print("Live:", s["post_ids"])
breakהאם וובהוק יכול להחליף את בדיקות הסטטוס?
כן, לאפליקציה שנרשמת לאירועי VIDEO עם השדה event_type, בעזרת /business/webhook/update/. ואז TikTok שולח post.publish.failed או post.publish.complete לאחר שהוריד ובדק את הקובץ, post.publish.publicly_available עם המזהה post_id החדש אחרי שבדיקת התוכן עוברת, ו-post.publish.no_longer_publicly_available אם הפוסט יוצא מהתצוגה הציבורית מאוחר יותר. כל אירוע מציין את המשימה ב-publish_id, באותו ערך של share_id.
איך מפרסמים סרטון דרך MCP?
מבקשים בשפה רגילה מ-Claude, מ-ChatGPT או מלקוח אחר שמחובר אל https://easycoexistence.com/api/mcp. העוזר קורא ל-publish_tiktok_post עם account_id מתוך list_social_accounts, video_url בכתובת HTTPS, הכיתוב, ואם רוצים לכבות תגובות, disable_comment. התוצאה כוללת את share_id של TikTok, ו-get_tiktok_publish_status, עם account_id ועם share_id, מחזיר את הסטטוס, post_ids והסיבה של TikTok כפי שהם כרגע.
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"caption": "Our new menu is live #food",
"disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
"note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }מה publish_tiktok_post שולח ל-TikTok?
קריאה לאותה נקודת הקצה, שמתמלאת לפי הבקשה שלכם. הקישור שלכם מועבר ל-TikTok כקישור חתום דרך נתיב המדיה המאומת של easyCoexistence, ולכן אינו צריך אימות משלו; הכיתוב ו-disable_comment נשלחים כפי שנתתם; ו-is_brand_organic ו-is_branded_content נשלחים כ-false. ההגדרות האחרות, כמו Duet, Stitch, השער ותווית הבינה המלאכותית, נשארות על ברירות המחדל של TikTok, והסרטון מפורסם כפוסט ציבורי, כפי שנקודת הקצה בנויה לעשות.
מה אפשר לעשות עם שדה credentials מה-Partner API?
לקרוא ל-TikTok ישירות בשם החשבון. GET /channels/{id}?credentials=1 על https://easycoexistence.com/api/v1, עם המפתח ec_live_ שלכם כאסימון Bearer, מחזיר את הערוץ עם אובייקט credentials: api_base, business_id, access_token עדכני ו-token_expires_at. בדיקות סטטוס, רשימות סרטונים, תגובות ותובנות נעשים מהקוד שלכם. הפרסום הוא החלק שצריך לתכנן: קריאת פרסום ישירה מעבירה את video_url ל-TikTok ללא שינוי, מאפייני URL מתווספים עם מזהה ומפתח סודי של אפליקציית מפתחים, והקידומת שאפליקציית easyCoexistence אימתה היא נתיב המדיה שלה, שבו publish_tiktok_post משתמש.
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# "credentials": {
# "platform": "tiktok",
# "api_base": "https://business-api.tiktok.com/open_api/v1.3",
# "business_id": "<OPEN_ID>",
# "access_token": "<ACCESS_TOKEN>",
# "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'publish_id=<SHARE_ID>'איך מגדירים
- Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
- Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
- Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.
טעויות נפוצות
- השמטת post_info. TikTok דורש את האובייקט בכל קריאה, גם כשאף הגדרה לא משתנה.
- לחפש מזהה פוסט בתגובה לפרסום. התגובה מחזירה רק share_id; מזהי הפוסטים מגיעים מקריאת הסטטוס או מוובהוק post.publish.publicly_available.
- חזרה על קריאת פרסום שפג זמנה. הבקשה הראשונה אולי הגיעה ל-TikTok, לכן בודקים את הפוסטים האחרונים של החשבון לפני שליחה מחדש.
- להתייחס לקוד 0 כסרטון באוויר. הוא אומר ש-TikTok קיבל את המשימה, והקובץ עדיין עלול להיכשל בבדיקות שלו אחרי ההורדה.
בין US$ 9 ל-US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
איזו נקודת קצה מפרסמת סרטון ל-TikTok?
POST אל https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, עם אסימון החשבון בכותרת Access-Token ועם business_id, video_url ו-post_info בגוף ה-JSON.
האם אפשר להעלות קובץ וידאו ישירות דרך ה-API של TikTok?
לא דרך /business/video/publish/. הנקודה מקבלת video_url ומביאה משם את הקובץ, לכן הסרטון חייב להיות בכתובת בדומיין או בקידומת URL מאומתים.
איך מקבלים את המזהה של סרטון שפורסם דרך ה-API?
מהשדה post_ids ב-/business/publish/status/ כשהסטטוס הוא PUBLISH_COMPLETE והפוסט ציבורי, או מהשדה post_id באירוע post.publish.publicly_available בוובהוק.
אפשר לתזמן סרטון TikTok לשעה מאוחרת יותר דרך ה-API?
נקודת הפרסום מפרסמת ברגע שקוראים לה ואין בה שדה זמן. easyCoexistence שומר פוסטים מתוזמנים בתור משלו ומתקשר עם TikTok בשעה שהגדרתם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-