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

Python اور Node.js میں TikTok API: کام کرنے والی مثالیں

TikTok کا API for Business Python یا Node.js سے سادہ HTTPS درخواستوں کے ساتھ کام کرتا ہے: ہر کال https://business-api.tiktok.com/open_api/v1.3 پر بھیجیں، اکاؤنٹ کا ٹوکن Access-Token ہیڈر میں اور اس کا open_id بطور business_id رکھیں۔ TikTok زیادہ تر کالز کا جواب HTTP 200 کے ساتھ code فیلڈ میں دیتا ہے، کامیابی پر 0، اس لیے اسے ضرور چیک کریں اور 40100 پر 5 منٹ رکیں۔

easyCoexistence Claude، ChatGPT یا آپ کے اپنے کوڈ کو وہی TikTok کام ٹولز کے طور پر دیتا ہے، publish_tiktok_post اور reply_to_comment سے لے کر get_social_insights تک، اور آپ کے اسکرپٹس کو get_social_credentials یا Partner API کے ذریعے ایک موجودہ ٹوکن دیتا ہے۔

HTTP 200

زیادہ تر TikTok جوابات کا اسٹیٹس، خرابیوں سمیت؛ صرف باڈی میں code کا 0 ہونا ظاہر کرتا ہے کہ کال کامیاب رہی۔

40100

تھروٹل کی گئی کال کا کوڈ: فی منٹ کی حد کے بعد TikTok 5 منٹ کا وقفہ مانگتا ہے، اور روزانہ حد کے بعد 00:00 UTC تک انتظار۔

5xx

سرور کی خرابیاں، جن کے بعد TikTok دوبارہ کال کرنے سے پہلے تقریباً 5 منٹ انتظار کا مشورہ دیتا ہے۔

Final /

راستے سلیش پر ختم ہوتے ہیں؛ TikTok کے مطابق /tt_user/oauth2/refresh_token بغیر سلیش کے 404 page not found کی وجہ بنتا ہے۔

3 languages

TikTok کے API for Business SDK میں Python، JavaScript اور Java ہیں، جس کی اینڈ پوائنٹ فہرست میں کوئی /business/ اینڈ پوائنٹ نہیں۔

HMAC-SHA256

ہر ویب ہک کے Tiktok-Signature ہیڈر کا دستخط ٹائم اسٹیمپ، ایک ڈاٹ اور باڈی پر بنتا ہے، جسے ایپ سیکرٹ سے کلید دیا جاتا ہے۔

ہر TikTok API کال کو کیا چاہیے؟

کام کچھ بھی ہو، ہمیشہ یہی پانچ چیزیں درکار ہیں:

  • بنیادی URL https://business-api.tiktok.com/open_api/v1.3 ہے، اور راستہ سلیش پر ختم ہونا چاہیے، جیسے /business/video/list/ کا راستہ۔
  • اکاؤنٹ کا ایکسیس ٹوکن Access-Token ہیڈر میں، جسے 24 گھنٹے ختم ہونے سے پہلے تازہ کیا جائے۔
  • business_id، یعنی اکاؤنٹ کا open_id: GET میں کوئری سٹرنگ میں، POST میں JSON باڈی میں۔
  • GET پر فہرست اور آبجیکٹ پیرامیٹرز، جیسے fields اور filters، JSON متن میں بھیجیں، مثلاً fields=["item_id","caption"] کی شکل میں۔
  • جواب میں code کی جانچ، کیونکہ TikTok 40002 یا 40100 جیسی خرابیاں HTTP 200 کے ساتھ بھیجتا ہے اور ڈیٹا صرف code 0 پر دیتا ہے۔

Python میں TikTok کے خرابی والے لفافے کو کیسے سنبھالیں؟

ایک چھوٹا کلائنٹ جو business_id وہاں رکھتا ہے جہاں ہر میتھڈ اسے مانگتا ہے، code 0 ہونے پر ڈیٹا لوٹاتا ہے اور ورنہ TikTokError اٹھاتا ہے۔ تھروٹل کی گئی کال TikTok کے 5 منٹ کے وقفے کے بعد دوبارہ کی جاتی ہے، کیونکہ 40100 کا مطلب ہے TikTok نے کال رد کی، اور 5xx صرف GET پر دوبارہ کی جاتی ہے، کیونکہ سرور خرابی پر ختم ہونے والی پبلش ممکن ہے TikTok تک پہنچ چکی ہو۔ اسے requests درکار ہے، اور بعد کی Python مثالیں اسی کو دوبارہ استعمال کرتی ہیں:

Python: a TikTok client that reads the envelope
import json
import os
import time

import requests

API = "https://business-api.tiktok.com/open_api/v1.3"


class TikTokError(Exception):
    def __init__(self, code, message, request_id):
        super().__init__(f"TikTok {code}: {message} (request_id {request_id})")
        self.code = code


class TikTok:
    """One TikTok account: its access token and its business_id, the open_id."""

    def __init__(self, access_token, business_id, pause=300):
        self.http = requests.Session()
        self.http.headers["Access-Token"] = access_token
        self.business_id = business_id
        self.pause = pause  # TikTok's advice after a 40100 or a 5xx: about 5 minutes

    def call(self, method, path, params=None, body=None, tries=3):
        for attempt in range(1, tries + 1):
            if method == "GET":
                query = {"business_id": self.business_id}
                for key, value in (params or {}).items():
                    is_json = isinstance(value, (list, dict))
                    query[key] = json.dumps(value, separators=(",", ":")) if is_json else value
                res = self.http.get(f"{API}/{path}", params=query, timeout=30)
            else:
                payload = {"business_id": self.business_id, **(body or {})}
                res = self.http.post(f"{API}/{path}", json=payload, timeout=30)
            if res.status_code >= 500 and method == "GET" and attempt < tries:
                time.sleep(self.pause)  # a POST is not repeated: it may have reached TikTok
                continue
            res.raise_for_status()  # a 4xx: a wrong path or method, such as a missing final slash
            answer = res.json()
            if answer.get("code") == 0:
                return answer.get("data") or {}
            if answer.get("code") == 40100 and attempt < tries:
                time.sleep(self.pause)  # throttled: TikTok refused the call, so repeating it is safe
                continue
            raise TikTokError(answer.get("code"), answer.get("message"), answer.get("request_id"))


tt = TikTok(os.environ["TIKTOK_ACCESS_TOKEN"], os.environ["TIKTOK_BUSINESS_ID"])

Node.js میں اسے کیسے سنبھالیں؟

وہی کلائنٹ Node.js 18 اور بعد کے ورژنز میں بنے ہوئے fetch پر، کچھ انسٹال کیے بغیر۔ یہ GET کے لیے فہرست پیرامیٹرز کو JSON میں بدلتا ہے، POST کے لیے business_id کو باڈی میں رکھتا ہے، اور خرابی پر TikTok کا code برقرار رکھتا ہے، تاکہ کال کرنے والا 40102 یا 40105 (ٹوکن کا مسئلہ) کو 40001 (غائب اجازت) سے الگ پہچان سکے:

Node.js: the same client on the built-in fetch
const API = "https://business-api.tiktok.com/open_api/v1.3";
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

class TikTokError extends Error {
  constructor(code, message, requestId) {
    super("TikTok " + code + ": " + message + " (request_id " + requestId + ")");
    this.code = code;
  }
}

// One TikTok account: its access token and its business_id, the open_id.
class TikTok {
  constructor(accessToken, businessId, pauseMs = 300000) {
    this.accessToken = accessToken;
    this.businessId = businessId;
    this.pauseMs = pauseMs; // TikTok's advice after a 40100 or a 5xx: about 5 minutes
  }

  async call(method, path, { params = {}, body = {} } = {}, tries = 3) {
    for (let attempt = 1; ; attempt++) {
      const url = new URL(API + "/" + path);
      const init = { method, headers: { "Access-Token": this.accessToken } };
      if (method === "GET") {
        url.searchParams.set("business_id", this.businessId);
        for (const [key, value] of Object.entries(params)) {
          url.searchParams.set(key, typeof value === "object" ? JSON.stringify(value) : String(value));
        }
      } else {
        init.headers["Content-Type"] = "application/json";
        init.body = JSON.stringify({ business_id: this.businessId, ...body });
      }
      const res = await fetch(url, init);
      if (res.status >= 500 && method === "GET" && attempt < tries) {
        await sleep(this.pauseMs); // a POST is not repeated: it may have reached TikTok
        continue;
      }
      if (!res.ok) throw new Error("HTTP " + res.status + " on " + path + ": check the path, its final slash and the method");
      const answer = await res.json();
      if (answer.code === 0) return answer.data ?? {};
      if (answer.code === 40100 && attempt < tries) {
        await sleep(this.pauseMs); // throttled: TikTok refused the call, so repeating it is safe
        continue;
      }
      throw new TikTokError(answer.code, answer.message, answer.request_id);
    }
  }
}

const tt = new TikTok(process.env.TIKTOK_ACCESS_TOKEN, process.env.TIKTOK_BUSINESS_ID);

ویڈیو URL کے ذریعے کیسے پبلش کریں اور اس کی حیثیت کیسے چیک کریں؟

POST /business/video/publish/ کو video_url اور post_info کے ساتھ بھیجیں، پھر /business/publish/status/ کو share_id کے ساتھ publish_id کے طور پر پولز کریں۔ لوپ FAILED پر TikTok کی وجہ کے ساتھ رک جاتا ہے، اور PUBLISH_COMPLETE پر post_ids آنے تک انتظار جاری رکھتا ہے، جس میں TikTok کے مطابق مزید تین منٹ لگ سکتے ہیں۔ video_url آپ کی ایپ کے لیے تصدیق شدہ ڈومین یا URL پریفکس پر ہونا ضروری ہے:

Publish a video and wait until it is public: Python, then Node.js
# Python
def wait_until_live(tt, share_id, interval=30, give_up_after=7200):
    deadline = time.time() + give_up_after
    while time.time() < deadline:
        status = tt.call("GET", "business/publish/status/", params={"publish_id": share_id})
        if status["status"] == "FAILED":
            raise RuntimeError(f"TikTok did not publish {share_id}: {status.get('reason')}")
        if status["status"] == "PUBLISH_COMPLETE" and status.get("post_ids"):
            return status["post_ids"]
        time.sleep(interval)  # post_ids can follow PUBLISH_COMPLETE by up to three minutes
    raise TimeoutError(f"{share_id} was not public after {give_up_after} s")


video = tt.call("POST", "business/video/publish/", body={
    "video_url": "https://media.example.com/tiktok/launch.mp4",  # on a verified domain or URL prefix
    "post_info": {
        "caption": "Our spring menu is live #food",
        "is_brand_organic": True,  # the Promotional content label, for the account's own business
        "is_branded_content": False,
    },
})
print("Live:", wait_until_live(tt, video["share_id"]))

// Node.js
async function waitUntilLive(tt, shareId, everyMs = 30000, giveUpAfterMs = 7200000) {
  const deadline = Date.now() + giveUpAfterMs;
  while (Date.now() < deadline) {
    const s = await tt.call("GET", "business/publish/status/", { params: { publish_id: shareId } });
    if (s.status === "FAILED") throw new Error("TikTok did not publish " + shareId + ": " + s.reason);
    if (s.status === "PUBLISH_COMPLETE" && s.post_ids && s.post_ids.length) return s.post_ids;
    await sleep(everyMs); // post_ids can follow PUBLISH_COMPLETE by up to three minutes
  }
  throw new Error(shareId + " was not public after " + giveUpAfterMs / 1000 + " s");
}

async function publishVideo(tt) {
  const video = await tt.call("POST", "business/video/publish/", {
    body: {
      video_url: "https://media.example.com/tiktok/launch.mp4", // on a verified domain or URL prefix
      post_info: { caption: "Our spring menu is live #food", is_brand_organic: true, is_branded_content: false },
    },
  });
  return waitUntilLive(tt, video.share_id);
}

publishVideo(tt).then((postIds) => console.log("Live:", postIds), console.error);

تصاویر کیسے پوسٹ کریں؟

پہلے اکاؤنٹ کی اجازت شدہ سیٹنگز پڑھیں، پھر POST /business/photo/publish/ کریں۔ فوٹو پوسٹ کو privacy_level درکار ہے، جو /business/video/settings/ سے آنے والے privacy_level_options میں سے ایک ہونا چاہیے، اور وہاں comment_disabled true ہو تو disable_comment بھی true ہونا لازم ہے۔ واپس ملنے والے share_id کو ویڈیو کی طرح اسی انتظار والے فنکشن سے آگے بڑھایا جاتا ہے:

Publish a photo post: Python, then Node.js
# Python
def publish_photos(tt, image_urls, title, caption):
    settings = tt.call("GET", "business/video/settings/")
    if "PUBLIC_TO_EVERYONE" not in settings["privacy_level_options"]:
        raise RuntimeError(f"Private account, choose from {settings['privacy_level_options']}")
    photo = tt.call("POST", "business/photo/publish/", body={
        "photo_images": image_urls,  # 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
        "photo_cover_index": 0,
        "post_info": {
            "title": title,  # up to 90 UTF-16 code units
            "caption": caption,  # up to 4,000
            "privacy_level": "PUBLIC_TO_EVERYONE",
            "disable_comment": settings["comment_disabled"],  # True when the account takes no comments
            "is_brand_organic": True,
            "is_branded_content": False,
        },
    })
    return wait_until_live(tt, photo["share_id"])


print(publish_photos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
                     "Spring menu", "Four new dishes, from Friday #food"))

// Node.js
async function publishPhotos(tt, imageUrls, title, caption) {
  const settings = await tt.call("GET", "business/video/settings/");
  if (!settings.privacy_level_options.includes("PUBLIC_TO_EVERYONE")) {
    throw new Error("Private account, choose from " + settings.privacy_level_options.join(", "));
  }
  const photo = await tt.call("POST", "business/photo/publish/", {
    body: {
      photo_images: imageUrls, // 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
      photo_cover_index: 0,
      post_info: {
        title, // up to 90 UTF-16 code units
        caption, // up to 4,000
        privacy_level: "PUBLIC_TO_EVERYONE",
        disable_comment: settings.comment_disabled, // true when the account takes no comments
        is_brand_organic: true,
        is_branded_content: false,
      },
    },
  });
  return waitUntilLive(tt, photo.share_id);
}

publishPhotos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
  "Spring menu", "Four new dishes, from Friday #food").then(console.log, console.error);

اکاؤنٹ کی ویڈیوز کی فہرست کیسے بنائیں؟

GET /business/video/list/ کو مطلوبہ fields کے ساتھ کریں، جن میں item_id بھی شامل ہو، ہر صفحے پر نئی پوسٹس سے شروع کرتے ہوئے 20 تک پوسٹس۔ واپس ملنے والا cursor، جو ملی سیکنڈ میں UTC ٹائم اسٹیمپ ہے، اس وقت تک پاس کریں جب تک has_more true ہو، اور چھوٹے صفحات کی توقع رکھیں: TikTok کے ٹرسٹ اور سیفٹی قواعد فہرست ختم ہونے سے پہلے max_count سے کم نتائج لوٹا سکتے ہیں۔

List recent videos across pages: Python, then Node.js
# Python
def recent_videos(tt, how_many=60):
    params = {"fields": ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
              "max_count": 20}
    videos = []
    while len(videos) < how_many:
        page = tt.call("GET", "business/video/list/", params=params)
        videos += page.get("videos", [])
        if not page.get("has_more"):
            break
        params["cursor"] = page["cursor"]  # posts published before this UTC time, in milliseconds
    return videos[:how_many]


for v in recent_videos(tt):
    print(v["item_id"], v.get("video_views"), (v.get("caption") or "")[:60])

// Node.js
async function recentVideos(tt, howMany = 60) {
  const params = {
    fields: ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
    max_count: 20,
  };
  const videos = [];
  while (videos.length < howMany) {
    const page = await tt.call("GET", "business/video/list/", { params });
    videos.push(...(page.videos ?? []));
    if (!page.has_more) break;
    params.cursor = page.cursor; // posts published before this UTC time, in milliseconds
  }
  return videos.slice(0, howMany);
}

recentVideos(tt).then((videos) => {
  for (const v of videos) console.log(v.item_id, v.video_views, (v.caption || "").slice(0, 60));
}, console.error);

کمنٹس کیسے پڑھیں اور ان کا جواب کیسے دیں؟

GET /business/comment/list/ کو پوسٹ کا item_id بطور video_id کے ساتھ دیا جائے تو ہر صفحے پر 30 تک کمنٹس ملتے ہیں، اور POST /business/comment/reply/create/ کسی ایک کا عوامی طور پر 1,200 حروف تک کے متن کے ساتھ جواب دیتا ہے۔ مثال ایسے ٹاپ لیول عوامی کمنٹس کا جواب دیتی ہے جن کا ابھی کوئی جواب نہیں، اکاؤنٹ کے اپنے کمنٹس چھوڑ دیتی ہے، اور الفاظ اس فنکشن پر چھوڑتی ہے جو آپ لکھیں، کیونکہ TikTok قریب قریب ملتے جلتے کمنٹس کو اسپام کہہ کر چھپا سکتا ہے:

Reply to new comments on a video: Python, then Node.js
# Python
def reply_to_new_comments(tt, video_id, write_reply):
    page = tt.call("GET", "business/comment/list/", params={
        "video_id": video_id,  # the post's item_id
        "status": "PUBLIC",
        "sort_field": "create_time",
        "sort_order": "desc",
        "max_count": 30,
    })
    for comment in page.get("comments", []):
        if comment.get("owner") or comment.get("replies") or comment.get("parent_comment_id"):
            continue  # the account's own comments, threads with replies, and replies
        text = write_reply(comment)
        if text:
            tt.call("POST", "business/comment/reply/create/", body={
                "video_id": video_id, "comment_id": comment["comment_id"], "text": text,  # up to 1,200 characters
            })


def reply_for(comment):
    if "price" in (comment.get("text") or "").lower():
        return f"Hi {comment.get('display_name') or 'there'}, the price list is pinned on our profile."
    return None  # leave the rest to a person


reply_to_new_comments(tt, "<ITEM_ID>", reply_for)

// Node.js
async function replyToNewComments(tt, videoId, writeReply) {
  const page = await tt.call("GET", "business/comment/list/", {
    params: { video_id: videoId, status: "PUBLIC", sort_field: "create_time", sort_order: "desc", max_count: 30 },
  });
  for (const comment of page.comments ?? []) {
    if (comment.owner || comment.replies || comment.parent_comment_id) continue; // own, already replied to, or a reply
    const text = writeReply(comment);
    if (text) {
      await tt.call("POST", "business/comment/reply/create/", {
        body: { video_id: videoId, comment_id: comment.comment_id, text }, // up to 1,200 characters
      });
    }
  }
}

function replyFor(comment) {
  if ((comment.text || "").toLowerCase().includes("price")) {
    return "Hi " + (comment.display_name || "there") + ", the price list is pinned on our profile.";
  }
  return null; // leave the rest to a person
}

replyToNewComments(tt, "<ITEM_ID>", replyFor).catch(console.error);

اکاؤنٹ کی انسائٹس کیسے پڑھیں؟

GET /business/get/ کو fields میں فیلڈ نیم کے ساتھ اور زیادہ سے زیادہ 60 دن کی UTC تاریخی حد کے ساتھ کریں۔ followers_count دو بار آتا ہے: data کے اوپر موجودہ کل تعداد، اور metrics کے اندر ہر دن کی کل تعداد، جس کے ساتھ اس دن کے video_views، profile_views، likes، comments اور shares ہوتے ہیں۔ مثال کل کی تاریخ پر ختم ہوتی ہے، کیونکہ روزانہ اعداد 24 سے 48 گھنٹے تاخیر سے آتے ہیں:

Daily account metrics for the last 7 days: Python, then Node.js
# Python
from datetime import datetime, timedelta, timezone


def daily_insights(tt, days=7):
    yesterday = datetime.now(timezone.utc).date() - timedelta(days=1)  # counts arrive 24 to 48 h late
    data = tt.call("GET", "business/get/", params={
        "fields": ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
        "start_date": (yesterday - timedelta(days=days - 1)).isoformat(),  # UTC, up to 60 days back
        "end_date": yesterday.isoformat(),
    })
    print("Followers now:", data.get("followers_count"))
    for day in data.get("metrics", []):
        print(day["date"], day.get("followers_count"), day.get("video_views"), day.get("likes"))


daily_insights(tt)

// Node.js
async function dailyInsights(tt, days = 7) {
  const utcDay = (daysAgo) => new Date(Date.now() - daysAgo * 86400000).toISOString().slice(0, 10);
  const data = await tt.call("GET", "business/get/", {
    params: {
      fields: ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
      start_date: utcDay(days), // UTC, up to 60 days back
      end_date: utcDay(1), // counts arrive 24 to 48 h late
    },
  });
  console.log("Followers now:", data.followers_count);
  for (const day of data.metrics ?? []) console.log(day.date, day.followers_count, day.video_views, day.likes);
}

dailyInsights(tt).catch(console.error);

ویب ہک کے دستخط کی تصدیق کیسے کریں؟

t کی قدر، ایک ڈاٹ اور خام باڈی کا HMAC-SHA256 دوبارہ نکالیں، جو ایپ سیکرٹ سے کی جائے، اسے s کے ساتھ مستقل وقت میں موازنہ کریں، اور جانچیں کہ t حالیہ ہے۔ کچھ بھی پارس کرنے سے پہلے باڈی کو بائٹس کے طور پر پڑھیں، فوراً 200 کا جواب دیں، اور ناکام جانچ پر x-tt-logid لاگ کریں۔ Python کے لیے Flask، اور Node.js کے لیے بلٹ اِن http ماڈیول:

Receive a signed TikTok webhook: Python with Flask, then Node.js
# Python
import hashlib
import hmac
import json
import os
import time
from queue import Queue

from flask import Flask, request

app = Flask(__name__)
events = Queue()


def signature_ok(raw, header, secret, max_age=300):
    fields = {}
    for part in (header or "").split(","):
        key, sep, value = part.strip().partition("=")
        if sep:
            fields[key] = value
    t, s = fields.get("t", ""), fields.get("s", "").lower()
    if not t.isdigit() or len(s) != 64:
        return False
    expected = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_age


@app.post("/tiktok/webhook")
def tiktok_webhook():
    raw = request.get_data()  # the bytes TikTok signed, before any JSON parsing
    if not signature_ok(raw, request.headers.get("Tiktok-Signature"), os.environ["TIKTOK_APP_SECRET"]):
        app.logger.warning("Bad signature, x-tt-logid %s", request.headers.get("X-Tt-Logid"))
        return "", 401
    events.put(json.loads(raw))  # its content field is itself a JSON string: work on it elsewhere
    return "", 200

// Node.js
const { createServer } = require("node:http");
const { createHmac, timingSafeEqual } = require("node:crypto");

function signatureOk(raw, header, secret, maxAgeSec = 300) {
  const fields = {};
  for (const part of String(header ?? "").split(",")) {
    const i = part.indexOf("=");
    if (i > 0) fields[part.slice(0, i).trim()] = part.slice(i + 1).trim();
  }
  if (!/^\d+$/.test(fields.t ?? "") || !/^[0-9a-f]{64}$/i.test(fields.s ?? "")) return false;
  const expected = createHmac("sha256", secret).update(fields.t + ".").update(raw).digest();
  const fresh = Math.abs(Date.now() / 1000 - Number(fields.t)) <= maxAgeSec;
  return timingSafeEqual(expected, Buffer.from(fields.s, "hex")) && fresh;
}

const inbox = [];
createServer((req, res) => {
  if (req.method !== "POST" || req.url !== "/tiktok/webhook") return res.writeHead(404).end();
  const chunks = [];
  req.on("data", (chunk) => chunks.push(chunk));
  req.on("end", () => {
    const raw = Buffer.concat(chunks); // the bytes TikTok signed
    if (!signatureOk(raw, req.headers["tiktok-signature"], process.env.TIKTOK_APP_SECRET)) {
      console.warn("Bad signature, x-tt-logid", req.headers["x-tt-logid"]);
      return res.writeHead(401).end();
    }
    res.writeHead(200).end(); // answer first: TikTok retries anything but a 200 for up to 72 hours
    inbox.push(JSON.parse(raw.toString("utf8")));
  });
}).listen(3000);

وہی کام easyCoexistence کے ذریعے کیسے چلائیں؟

Claude، ChatGPT یا کسی اور MCP کلائنٹ سے، جو https://easycoexistence.com/api/mcp سے جڑا ہو، ٹول کالز کے طور پر، ہر کال میں list_social_accounts سے account_id لیا جاتا ہے۔ easyCoexistence آپ کے میڈیا لنکس TikTok کو اپنے تصدیق شدہ URL پریفکس کے ذریعے بھیجتا ہے، ہر پوسٹ کی نگرانی کرتا ہے جب تک TikTok اسے مکمل یا ناکام نہ کرے، اور ٹوکن تازہ کرتا ہے، جبکہ رد کی گئی کال TikTok کا code اور پیغام واپس لاتی ہے:

The six jobs as MCP tool calls
// Publish a video by URL, then see where it stands
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "video_url": "https://media.example.com/tiktok/launch.mp4", "caption": "Our spring menu is live #food" }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "<SHARE_ID>" }

// Post photos
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "image_urls": ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"], "title": "Spring menu", "caption": "Four new dishes, from Friday #food" }

// List videos
list_social_posts { "account_id": "<ACCOUNT_ID>", "limit": 20 }

// Read comments and reply in public
list_social_comments { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>" }
reply_to_comment { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "The price list is pinned on our profile." }

// Account insights
get_social_insights { "account_id": "<ACCOUNT_ID>", "metrics": ["followers_count", "video_views", "likes"], "params": { "start_date": "2026-10-26", "end_date": "2026-11-01" } }

// Comment events, signed by easyCoexistence, at your endpoint
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }

آپ کا اپنا کوڈ easyCoexistence سے جڑے اکاؤنٹ کو کیسے استعمال کرتا ہے؟

ہر جاب کے لیے Partner API سے اکاؤنٹ کی اسناد لیں اور انہیں اسی کلائنٹ کو دیں۔ اپنی ec_live_ کی کے ساتھ GET /channels/{id}?credentials=1 api_base، business_id اور ایک موجودہ access_token کے ساتھ token_expires_at لوٹاتا ہے، یا چینل کو دوبارہ کنیکٹ کرنے کی ضرورت ہو تو نوٹ کے ساتھ null ٹوکن۔ پڑھنے کی کالیں، جوابات اور انسائٹس پھر آپ کے اپنے کوڈ سے چلتے ہیں، جبکہ پوسٹس POST /channels/{id}/posts یا publish_tiktok_post سے جاتی ہیں، جو میڈیا کو تصدیق شدہ پریفکس سے گزارتی ہیں:

A current token from the Partner API, into the same client: Python, then Node.js
# Python
def tiktok_for(channel_id):
    res = requests.get(f"https://easycoexistence.com/api/v1/channels/{channel_id}", params={"credentials": "1"},
                       headers={"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}, timeout=30)
    res.raise_for_status()
    creds = res.json()["credentials"]
    if not creds.get("access_token"):
        raise RuntimeError(creds.get("note"))  # the channel needs reconnecting
    return TikTok(creds["access_token"], creds["business_id"])


print(recent_videos(tiktok_for("<CHANNEL_ID>"), 20))

// Node.js
async function tiktokFor(channelId) {
  const res = await fetch("https://easycoexistence.com/api/v1/channels/" + channelId + "?credentials=1", {
    headers: { Authorization: "Bearer " + process.env.EC_API_KEY },
  });
  if (!res.ok) throw new Error("HTTP " + res.status + " from easyCoexistence");
  const { credentials } = await res.json();
  if (!credentials.access_token) throw new Error(credentials.note); // the channel needs reconnecting
  return new TikTok(credentials.access_token, credentials.business_id);
}

tiktokFor("<CHANNEL_ID>").then((account) => recentVideos(account, 20)).then(console.log, console.error);

عام غلطیاں

  • ڈیٹا پڑھنا بغیر code چیک کیے۔ جواب HTTP 200، code 40002 اور بالکل ڈیٹا نہ ہونے کے ساتھ آ سکتا ہے، اس لیے غائب فیلڈ اکثر ایک ایسی خرابی ہوتی ہے جسے کوڈ نے نظرانداز کر دیا۔
  • آخری سلیش گرانا۔ TikTok کے راستے / پر ختم ہوتے ہیں، اور اس کے واپسی کوڈ کے ضمیمے میں /tt_user/oauth2/refresh_token، بغیر سلیش کے، ایک ایسی کال کے طور پر درج ہے جو HTTP 404 page not found پر ختم ہوتی ہے۔
  • Node.js میں reply_list سے جواب کے IDs لینا۔ TikTok کے ریفرنس reply_list کے comment_id اور video_id کو نمبر کے طور پر بیان کرتے ہیں، جنہیں JSON.parse گول کر سکتا ہے؛ /business/comment/reply/list/ انہیں سٹرنگ کے طور پر لوٹاتا ہے۔
  • fields کو کاما والی فہرست کے طور پر بھیجنا۔ API for Business JSON متن چاہتا ہے، fields=["item_id","caption"]، جبکہ developers.tiktok.com کا Display API fields=open_id,union_id لیتا ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

US$ 9 سے US$ 0.75 تک فی کنکشن فی مہینہ، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن کا فری ٹرائل۔

اکثر پوچھے جانے والے سوالات

کیا TikTok کے Accounts API کے لیے کوئی آفیشل Python یا Node.js SDK ہے؟

TikTok کا API for Business SDK Python، JavaScript اور Java میں آتا ہے، مگر اس کی اینڈ پوائنٹ فہرست اشتہارات، رپورٹنگ اور Business Center کا احاطہ کرتی ہے، اس میں کوئی /business/ یا /tt_user/ اینڈ پوائنٹ نہیں۔

TikTok کی کال HTTP 200 کے ساتھ بغیر ڈیٹا کے کیوں واپس آتی ہے؟

TikTok خرابیوں کو HTTP 200 جواب کے code فیلڈ میں لکھتا ہے۔ code اور میسج پڑھیں: 40002 پیرامیٹر کی خرابی ہے، 40001 غائب اجازت، اور 40100 تھروٹل کی گئی کال۔

یہ مثالیں Python اور Node.js کے کون سے ورژن درکار کرتی ہیں؟

Python 3.9 یا بعد کا ورژن requests کے ساتھ، ویب ہک کے لیے Flask، اور Node.js 18 یا بعد کا ورژن، جس کا بلٹ اِن fetch اور node:crypto باقی سب کا احاطہ کرتے ہیں۔

کیا میں TikTok API کو براؤزر سے کال کر سکتا ہوں؟

کالیں اپنے سرور پر رکھیں۔ TikTok کا ٹوکن ٹائپ Bearer ہے، جسے جو بھی رکھتا ہو استعمال کر سکتا ہے، اور ٹوکن اینڈ پوائنٹس کو آپ کی ایپ کا client_secret درکار ہے۔

مزید پڑھیں

2026 میں TikTok API گائیڈ: آپ کی ایپ سے آپ کی پہلی پوسٹ تک2026 میں TikTok API کا راستہ، ترتیب سے: کون سی API، ایپ ریویو، اسکوپس، ٹوکن، پبلشنگ، اسٹیٹس، کمنٹس، ویب ہکس، انسائٹس اور حدیں۔2026 میں TikTok API کی تبدیلیاں: کیا کام رکا اور کیا کریں2026 میں TikTok API کی تبدیلیاں، تازہ ترین پہلے: ٹوکن کی مدت، is_business_account، تبصروں کی حدیں، رسائی فارم اور سینڈ باکس، ہر حل کے ساتھ۔TikTok API کنکشن کام کرنا کیوں بند کرتا ہے، اور اسے برقرار کیسے رکھیںTikTok API for Business کنکشن کیوں رکتا ہے: 24 گھنٹے کا ٹوکن، ایک سال کا ریفریش ٹوکن، منسوخ رسائی، اکاؤنٹ کی تبدیلیاں، اور دوبارہ کنکشن کا طریقہ۔API کے ذریعے TikTok پر ویڈیو کیسے پوسٹ کریںTikTok کی کاروباری API سے ویڈیو پوسٹ کریں: پبلش اینڈ پوائنٹ، اس کی JSON باڈی، واپس آنے والا share_id اور status کال، curl اور Python میں۔TikTok ویب ہکس کی تصدیق: سگنیچر ہیڈر اور اسے چیک کرنے کا طریقہTikTok API for Business ویب ہک کی تصدیق کریں: Tiktok-Signature ہیڈر، t اور خام body کا HMAC-SHA256، Node.js میں۔TikTok API ریٹ لمٹس: فی اکاؤنٹ، ایپ اور اینڈ پوائنٹ کے حساب سے درخواستیںTikTok API ریٹ لمٹس: ہر اکاؤنٹ اور اینڈ پوائنٹ پر ایک منٹ میں 40 کالز، Accounts API پر ایپ کی سطح کے مطابق 600 یا 1,000 فی منٹ، اور چار ایپ لیولز۔

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

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

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

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