لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

API کے ذریعے TikTok پر ویڈیو کیسے پوسٹ کریں

TikTok کی کاروباری API سے ویڈیو پوسٹ کرنے کے لیے، اکاؤنٹ کا business_id، کسی تصدیق شدہ domain یا URL prefix پر video_url، اور کیپشن اور سیٹنگز والا post_info آبجیکٹ لے کر POST /business/video/publish/ کو کال کریں، اور ہیڈر میں Access-Token بھی بھیجیں۔ TikTok ایک share_id واپس کرتا ہے، جسے publish_id کے طور پر /business/publish/status/ کو دیں، جب تک status PUBLISH_COMPLETE نہ دکھائے اور post_ids ظاہر نہ ہوں۔

easyCoexistence، Claude، ChatGPT یا اپنے ایجنٹ سے publish_tiktok_post کے ذریعے TikTok ویڈیوز پوسٹ کرتا ہے: HTTPS لنک، کیپشن اور کمنٹس فعال ہیں یا نہیں، یہ دیں، پھر get_tiktok_publish_status سے پوسٹ کا پیچھا کریں، جبکہ فائل اپنے تصدیق شدہ میڈیا روٹ کے ذریعے TikTok تک پہنچتی ہے۔

share_id

پبلش کال کے جواب میں ملتا ہے، جیسے v_pub_url~v1.2345123456789123456، اور status کال کو publish_id کے طور پر دیا جاتا ہے۔

Nov 16, 2023

اس کے بعد سے TikTok ایسی URL سے ویڈیوز پبلش کرنے سے انکار کرتا ہے جس کا domain یا URL prefix تصدیق شدہ نہ ہو۔

6 a minute

پبلش اینڈ پوائنٹ کے ذریعے فی اکاؤنٹ ویڈیو پوسٹس پر TikTok کی حد، جو روزانہ زیادہ سے زیادہ 15 ہے۔

3 min

PUBLISH_COMPLETE کے بعد post_ids ظاہر ہونے میں لگنے والا وقت؛ TikTok کہتا ہے کہ تین منٹ بعد دوبارہ کوشش کریں۔

post_id

جب پوسٹ موڈریشن پاس کرے تو post.publish.publicly_available ویب ہک میں بھیجا جاتا ہے، اور اس کے بعد اس کی insights کا سوال کیا جا سکتا ہے۔

پہلی کال سے پہلے کیا درکار ہے؟

تین چیزیں۔ ٹوکن ایکسچینج سے ملنے والا TikTok اکاؤنٹ کا ایکسیس ٹوکن اور اکاؤنٹ کا open_id؛ TikTok Accounts کے تحت Video Publish اجازت رکھنے والی ڈیویلپر ایپ؛ اور ویڈیو ایک عوامی HTTPS یا HTTP URL پر، جو ایپ کے لیے تصدیق شدہ domain یا URL prefix کے تحت ہو۔ TikTok فائل خود ڈاؤن لوڈ کرتا ہے، اس لیے یہ قابلِ رسائی رہنی چاہیے، اور TikTok کم از کم 30 منٹ تک چلنے والے URL کی سفارش کرتا ہے۔

پبلش درخواست کیسی دکھتی ہے؟

Access-Token ہیڈر میں اکاؤنٹ کے ٹوکن کے ساتھ، اور Content-Type application/json پر سیٹ، https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ پر POST۔ JSON باڈی business_id میں اکاؤنٹ کی شناخت، video_url میں فائل، اور post_info میں پوسٹ کی سیٹنگز دیتی ہے؛ یہ مثال کیپشن والی ویڈیو کو اس طرح پبلش کرتی ہے کہ کمنٹس، Duet اور Stitch فعال رہیں:

Publish a video with curl
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 کے ریفرنس میں ویڈیو پوسٹ کے لیے درج فیلڈز، سب سے اوپر کی سطح سے شروع۔ کور، AI سے بنا ہوا لیبل، لوکیشن، ڈرافٹس اور صرف اشتہارات کا آپشن اسی باڈی میں ہیں:

  • business_id: اکاؤنٹ کا open_id، جو ٹوکن ایکسچینج سے ملتا ہے۔
  • video_url: وہ فائل جسے TikTok ڈاؤن لوڈ کرتا ہے، MP4، MOV یا WebM، کسی تصدیق شدہ domain یا URL prefix پر۔
  • post_info: ہر کال پر لازمی، حتیٰ کہ خالی آبجیکٹ کی صورت میں بھی، اور پوسٹ کی سیٹنگز اسی میں رہتی ہیں۔
  • post_info.caption: 2,200 حروف تک، UTF-16 میں گنے جاتے ہیں، جن میں ہیش ٹیگز اور 30 تک @منشنز شامل ہو سکتے ہیں۔
  • post_info.is_brand_organic اور is_branded_content: Promotional content اور Paid partnership لیبل، جنہیں TikTok کی جدول لازمی قرار دیتی ہے۔
  • post_info.disable_comment، disable_duet اور disable_stitch: true سے کمنٹس، Duet یا Stitch بند ہو جاتے ہیں؛ تینوں ڈیفالٹ طور پر false ہیں۔

TikTok کیا جواب دیتا ہے؟

معمول کا جواب کا ڈھانچہ، جس کے data میں پبلشنگ ٹاسک کی ID ہوتی ہے۔ کوڈ 0 کا مطلب ہے کہ TikTok نے ٹاسک قبول کر لیا، نہ کہ ویڈیو لائیو ہے: TikTok کو ابھی فائل ڈاؤن لوڈ کرنی، اسے جانچنی اور پوسٹ کی موڈریشن کرنی ہے۔ TikTok کی مثالوں میں ویڈیو کا share_id v_pub_url سے اور فوٹو پوسٹ کا p_pub_url سے شروع ہوتا ہے۔

The publish response
{
  "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 میں:

Publish and follow a video in 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

کیا ویب ہک status کالوں کی جگہ لے سکتا ہے؟

ہاں، اس ایپ کے لیے جو /business/webhook/update/ کے ساتھ event_type VIDEO کو سبسکرائب کرتی ہے۔ جب TikTok فائل ڈاؤن لوڈ اور چیک کر لیتا ہے تو post.publish.failed یا post.publish.complete بھیجتا ہے، موڈریشن پاس ہونے پر نئے post_id کے ساتھ post.publish.publicly_available، اور اگر پوسٹ بعد میں عوامی منظر سے ہٹ جائے تو post.publish.no_longer_publicly_available بھی آتا ہے۔ ہر ایونٹ کی ٹاسک شناخت publish_id میں ہوتی ہے، جو share_id کی ہی ویلیو ہے۔

MCP کے ذریعے ویڈیو کیسے پوسٹ کریں؟

Claude، ChatGPT یا https://easycoexistence.com/api/mcp سے جڑے کسی اور کلائنٹ سے سادہ الفاظ میں کہیں۔ اسسٹنٹ list_social_accounts سے account_id، HTTPS video_url، کیپشن اور، اگر آپ کمنٹس بند کرنا چاہیں تو disable_comment کے ساتھ publish_tiktok_post کو کال کرتا ہے۔ نتیجے میں TikTok کا share_id آتا ہے، اور get_tiktok_publish_status کو account_id اور اسی share_id کے ساتھ دینے پر TikTok کا status، post_ids اور reason جیسے ہیں ویسے واپس آتے ہیں۔

The MCP tool calls and their results
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 کو کیا بھیجتا ہے؟

اسی اینڈ پوائنٹ کی کال، آپ کی درخواست سے بھری ہوئی۔ آپ کا لنک easyCoexistence کے اپنے تصدیق شدہ میڈیا روٹ کے تحت دستخط شدہ لنک کے طور پر TikTok کو جاتا ہے، اس لیے اس کی اپنی تصدیق درکار نہیں؛ کیپشن اور disable_comment وہی جاتے ہیں جو آپ نے دیے، اور is_brand_organic اور is_branded_content false کے طور پر جاتے ہیں۔ دیگر سیٹنگز، جیسے Duet، Stitch، کور اور AI سے بنا ہوا لیبل، TikTok کے ڈیفالٹس پر رہتی ہیں، اور ویڈیو عوامی پوسٹ کے طور پر پبلش ہوتی ہے، جیسا کہ اینڈ پوائنٹ اسی کے لیے بنایا گیا ہے۔

Partner API کے کریڈینشلز سے کیا کیا جا سکتا ہے؟

TikTok کو براہِ راست اکاؤنٹ کے طور پر کال کیا جا سکتا ہے۔ https://easycoexistence.com/api/v1 پر GET /channels/{id}?credentials=1 کے ساتھ، bearer ٹوکن کے طور پر اپنی ec_live_ کلید کے ساتھ، ایک credentials آبجیکٹ والا چینل واپس آتا ہے: api_base، business_id، موجودہ access_token اور token_expires_at۔ اس کے بعد اسٹیٹس چیک، ویڈیو لسٹس، کمنٹس اور insights آپ کے اپنے کوڈ سے چل سکتے ہیں۔ جس حصے کی منصوبہ بندی کرنی ہے وہ پبلشنگ ہے: براہِ راست پبلش کال video_url کو TikTok تک بغیر تبدیلی کے پہنچاتی ہے، URL کی خصوصیات ڈیویلپر ایپ کی اپنی ID اور secret سے شامل کی جاتی ہیں، اور وہ پری فکس جسے easyCoexistence کی ایپ نے تصدیق کیا ہے اس کا میڈیا روٹ ہے، جسے publish_tiktok_post استعمال کرتا ہے۔

Credentials from the Partner API, then a direct status check
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>'

اسے کیسے سیٹ اپ کریں

  1. 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.
  2. 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.
  3. 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/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. 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 ہر کال پر یہ آبجیکٹ مانگتا ہے، چاہے کوئی سیٹنگ تبدیل نہ ہو۔
  • پبلش جواب میں پوسٹ ID تلاش کرنا۔ یہ صرف share_id واپس کرتا ہے، پوسٹ IDs status کال یا post.publish.publicly_available ویب ہک سے آتی ہیں۔
  • ٹائم آؤٹ ہونے والی پبلش کال دوبارہ بھیجنا۔ پہلی درخواست TikTok تک پہنچ چکی ہو سکتی ہے، اس لیے دوبارہ بھیجنے سے پہلے اکاؤنٹ کی تازہ ترین پوسٹس دیکھ لیں۔
  • کوڈ 0 کو لائیو ویڈیو سمجھنا۔ اس کا مطلب ہے کہ TikTok نے ٹاسک قبول کیا، اور ڈاؤن لوڈ کے بعد فائل اپنی جانچ میں ناکام بھی ہو سکتی ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

فی کنکشن ماہانہ 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 باڈی میں ہوں۔

کیا TikTok API براہِ راست ویڈیو فائل اپلوڈ کر سکتی ہے؟

/business/video/publish/ کے ذریعے نہیں۔ یہ video_url لیتا ہے اور وہیں سے فائل حاصل کرتا ہے، اس لیے ویڈیو کا ایک URL ہونا چاہیے جو تصدیق شدہ domain یا URL prefix پر ہو۔

API کے ذریعے پبلش ہونے والی ویڈیو کا ID کیسے ملے؟

/business/publish/status/ میں post_ids سے، جب status PUBLISH_COMPLETE ہو اور پوسٹ عوامی ہو، یا post.publish.publicly_available ویب ہک میں آنے والے post_id سے۔

کیا API کے ذریعے TikTok ویڈیو بعد کے لیے شیڈول کی جا سکتی ہے؟

پبلش اینڈ پوائنٹ کال کے وقت پوسٹ کرتا ہے اور اس میں کوئی وقت کا فیلڈ نہیں۔ easyCoexistence شیڈول پوسٹس اپنی قطار میں رکھتا ہے اور آپ کے مقررہ وقت پر TikTok کو کال کرتا ہے۔

مزید پڑھیں

API کے ذریعے TikTok پوسٹ سیٹنگز: پرائیویسی، کمنٹس، Duet اور StitchTikTok کے پبلش اینڈ پوائنٹس کی سیٹنگز: پرائیویسی، کمنٹس، Duet، Stitch، کور، برانڈ اور AI لیبلز، اور ہر اکاؤنٹ کی اجازت شدہ قدریں۔TikTok میڈیا URLs: تصدیق شدہ ڈومین اور URL پری فکسTikTok کا API for Business تصدیق شدہ ڈومینز اور URL پری فکسز سے میڈیا کیسے لیتا ہے: DNS TXT اور سگنیچر فائل کی جانچ، پراپرٹی اینڈ پوائنٹس۔TikTok API کے ذریعے پوسٹ کی پبلش اسٹیٹس کیسے چیک کریںAPI سے شائع ہونے والی TikTok پوسٹ کی اسٹیٹس دیکھیں: share_id، PROCESSING_DOWNLOAD، PUBLISH_COMPLETE، FAILED اور ناکامی کی وجہ۔TikTok ویڈیو کی ضروریات API کے لیے: فارمیٹ، سائز اور دورانیہTikTok API کے ذریعے شائع ہونے والی ویڈیوز: MP4، MOV یا WebM، 3 تا 600 سیکنڈ، 1 GB تک، 23 تا 60 FPS، اور وہ URL جسے TikTok خود ڈاؤن لوڈ کرتا ہے۔TikTok API for Business ویب ہکس کی ترتیبTikTok API for Business ایپ کے ویب ہکس سبسکرائب کرنا: /business/webhook/update/، VIDEO اور COMMENT ایونٹس، کال بیک قواعد اور Tiktok-Signature۔TikTok API برائے کاروبار کے ایکسیس ٹوکن: 24 گھنٹے، ریفریش اور منسوخیTikTok API برائے کاروبار کے ٹوکن: auth_code کا تبادلہ، 24 گھنٹے کا ایکسیس ٹوکن، ایک سال کا ریفریش ٹوکن، تجدید اور منسوخی۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ