API کے ذریعے TikTok اکاؤنٹ کی ویڈیوز کی فہرست بنانا
TikTok کا API for Business GET /business/video/list/ کے ذریعے کسی اکاؤنٹ کی عوامی پوسٹس کی فہرست لاتا ہے، نئی سے پرانی کی طرف، ہر صفحے پر 20 تک۔ جن فیلڈز کی ضرورت ہو ان کے نام دیں، جیسے item_id، caption، share_url اور video_views، اور has_more کے true ہونے تک cursor کے ذریعے آگے بڑھیں۔ filters.video_ids مخصوص پوسٹس الگ کرتا ہے، اور ہر item_id وہی ID ہے جو کمنٹ کالز لیتی ہیں۔
easyCoexistence، Claude، ChatGPT یا اپنے کوڈ سے list_social_posts کے ذریعے کسی TikTok اکاؤنٹ کی حالیہ پوسٹس کی فہرست بناتا ہے، ہر پوسٹ کے item_id، کیپشن، لنک اور شماروں کے ساتھ، اور بعد کے صفحات اور دیگر فیلڈز کے لیے get_social_credentials آپ کے اپنے کوڈ کو ٹوکن دیتا ہے۔
/business/video/list/ فی صفحہ زیادہ سے زیادہ پوسٹس واپس کرتا ہے، max_count کی ڈیفالٹ قدر 10 ہے۔
کرسر کی اکائی ایک UTC Unix ٹائم اسٹیمپ ہے؛ یہ اینڈ پوائنٹ اس وقت سے پہلے شائع ہونے والی پوسٹس واپس کرتا ہے۔
ڈیفالٹ فیلڈ، جو کئی فیلڈز نام لینے والی درخواست میں ضرور شامل ہونی چاہیے، ورنہ خرابی آ سکتی ہے۔
اس اینڈ پوائنٹ پر فی مجاز اکاؤنٹ کالز کی اجازت، جیسا کہ ہر Accounts API اینڈ پوائنٹ پر ہوتی ہے۔
یہ اینڈ پوائنٹ کیا واپس کرتا ہے؟
اکاؤنٹ کی عوامی پوسٹس: وہ ویڈیوز جو اس کی پروفائل پر دکھائی دیتی ہیں، فوٹو اور ٹیکسٹ پوسٹس، اور صرف ایڈز میں دکھائی جانے والی ویڈیوز، جو پروفائل پر ظاہر ہوئے بغیر اشتہار کے طور پر چلتی ہیں۔ media_type VIDEO اور PHOTO میں فرق بتاتا ہے، جن میں فوٹو اور ٹیکسٹ پوسٹس شامل ہیں۔ جو پوسٹس TikTok نے میوزک کاپی رائٹ جیسی خلاف ورزی کی بنا پر فلٹر کر دی ہوں، وہ فہرست سے باہر رہتی ہیں۔
اسے کیسے کال کریں؟
GET اور URL پیرامیٹرز کے ساتھ: business_id، fields بطور JSON array، اور اختیاری طور پر filters، cursor اور max_count، جس کی ڈیفالٹ قدر 10 ہے۔ ٹوکن Access-Token ہیڈر میں جاتا ہے، اور ڈیولپر ایپ کو TikTok Accounts کے تحت Get Account Media پرمیشن درکار ہے:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","create_time","media_type","caption","share_url","thumbnail_url","video_views","likes","comments","shares"]' \
--data-urlencode 'max_count=20'کون سے فیلڈز پوسٹ کو بیان کرتے ہیں؟
میٹرکس کے علاوہ، جو video_views سے impression_sources تک ہیں، فہرست میں یہ سب شامل ہوتا ہے، جو سب video.list اسکوپ کے تحت ہیں:
item_id: پوسٹ کی ID، جسے کمنٹ کالز اور filters.video_idsاستعمال کرتی ہیں۔media_type: VIDEO، یا فوٹو یا ٹیکسٹ پوسٹ کے لیے PHOTO۔is_ad: کیا پوسٹ کسی اشتہار میں استعمال ہو رہی ہے۔create_time: پوسٹ کب شائع ہوئی، UTC میں Unix سیکنڈز کی صورت میں۔- caption: پوسٹ کی تفصیل، ہیش ٹیگز سمیت۔
share_url: قابلِ شیئر لنک، جو موبائل اور ڈیسک ٹاپ پر مختلف طرح برتاؤ کرتا ہے۔embed_url: دوسری ویب سائٹس کے لیے پلیئر لنک، جو Friends یا Only you پر سیٹ پوسٹس کو نہیں چلاتا۔thumbnail_url: عارضی پیش نظارہ تصویر، جس کی میعاد اس کے x-expires پیرامیٹر میں ہوتی ہے۔video_duration: سیکنڈز میں دورانیہ، تین اعشاریہ تک۔
نتائج کے صفحے کی شکل کیسی ہوتی ہے؟
videos array، اس ترتیب میں جس میں TikTok اسے واپس کرتا ہے، ساتھ cursor، یعنی اگلے صفحے کے لیے بھیجی جانے والی قدر، اور has_more، جو بتاتا ہے کہ کیا اگلا صفحہ موجود ہے۔ create_time سٹرنگ کی صورت میں Unix سیکنڈز کے طور پر آتا ہے۔ TikTok کی مثال، جو وضاحتی فیلڈز اور شماروں تک محدود کی گئی ہے:
{
"code": 0,
"message": "OK",
"request_id": "2021080307532501024502410704A7306F",
"data": {
"videos": [
{
"item_id": "6990565363377392901",
"create_time": "1627617835",
"caption": "little coco",
"share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
"likes": 10,
"comments": 2,
"shares": 0,
"video_views": 1231
}
],
"cursor": 0,
"has_more": false
}
}پیجنیشن کیسے کام کرتی ہے؟
وقت کے لحاظ سے۔ cursor کی ڈیفالٹ قدر ملی سیکنڈز میں موجودہ لمحہ ہے، اس لیے پہلے صفحے میں سب سے نئی پوسٹس ہوتی ہیں، اور ہر جواب اگلی درخواست کے لیے cursor واپس کرتا ہے۔ جب has_more true ہو تو اسے بھیجیں۔ ایک حسبِ ضرورت ٹائم اسٹیمپ اس لمحے سے پہلے شائع ہونے والی پوسٹس فہرست میں لاتا ہے، اور TikTok کے ٹرسٹ اینڈ سیفٹی قوانین صفحے کو max_count سے چھوٹا کر سکتے ہیں، حالانکہ مزید پوسٹس باقی ہوں۔
import json, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
def all_posts(token: str, business_id: str, fields: list[str]):
params = {"business_id": business_id, "fields": json.dumps(fields), "max_count": 20}
while True:
r = requests.get(f"{API}/business/video/list/", headers={"Access-Token": token},
params=params, timeout=30).json()
if r["code"] != 0:
raise RuntimeError(f"{r['code']}: {r['message']}")
yield from r["data"].get("videos", [])
if not r["data"].get("has_more"):
return
params["cursor"] = r["data"]["cursor"]مخصوص پوسٹس کیسے حاصل کریں؟
filters کے ذریعے، ایک JSON آبجیکٹ: video_ids وہ پوسٹ IDs فہرست کرتا ہے جو واپس چاہئیں، جیسے پبلشنگ اسٹیٹس کے post_ids۔ ad_post_only، جو صرف video_ids کے ساتھ درست ہے، صرف وہ پوسٹس رکھتا ہے جنہیں Spark Ads کے لیے اشتہار دینے والوں کو مجاز کیا گیا ہو۔ فلٹرڈ درخواست میں باقی کسی بھی درخواست کی طرح فیلڈز ہوتے ہیں، اس لیے ایک کال چند معلوم پوسٹس کے تازہ ترین اعداد واپس کر سکتی ہے۔
filters={"video_ids":["6995316737801538821","8015388216995316737"]}کون سی حدیں لاگو ہوتی ہیں؟
Accounts API ہر مجاز اکاؤنٹ کے لیے اس اینڈ پوائنٹ پر فی منٹ 40 کالز دیتا ہے، اور ایپ کی Accounts API کالز مل کر Basic لیول پر فی منٹ 600 اور اس سے اوپر 1,000 ملتی ہیں۔ وضاحتی فیلڈز حقیقی وقت کی ہیں، شمار عموماً 24 سے 48 گھنٹے پیچھے ہوتے ہیں، اور کسی پوسٹ کا ڈیٹا شائع ہونے کے 365 دن بعد اپ ڈیٹ ہونا بند ہو جاتا ہے۔
easyCoexistence ویڈیوز کی فہرست کیسے بناتا ہے؟
list_social_posts کے ذریعے، جو account_id اور اختیاری limit لیتا ہے، TikTok کے لیے 1 سے 20 تک۔ یہ TikTok کا پہلا صفحہ واپس کرتا ہے: سب سے تازہ پوسٹس، ساتھ item_id، create_time، caption، share_url، thumbnail_url، video_views، likes، comments اور shares، اور cursor اور has_more۔ بعد کے صفحات اور دیگر فیلڈز آپ کے اپنے کوڈ سے آتے ہیں، get_social_credentials کے ٹوکن اور business_id کے ساتھ:
GET https://business-api.tiktok.com/open_api/v1.3/business/video/list/
?business_id=<BUSINESS_ID>
&fields=["item_id","media_type","caption","embed_url"]
&cursor=1793404800000
&max_count=20
Access-Token: <ACCESS_TOKEN>عام غلطیاں
- item_id کے بغیر فیلڈز مانگنا۔ TikTok کا حوالہ خبردار کرتا ہے کہ کئی فیلڈز نام لینے والی درخواست جس میں یہ نہ ہو، ناکام ہو سکتی ہے۔
- صفحہ مختصر آنے پر رک جانا۔ TikTok max_count سے کم پوسٹس واپس کر سکتا ہے جبکہ has_more ابھی بھی true ہو، اس لیے has_more کو فالو کریں۔
- thumbnail_url کو بعد کے لیے محفوظ کرنا۔ یہ ایک عارضی لنک ہے جو اپنے x-expires پیرامیٹر کے وقت پر ختم ہو جاتا ہے، اس لیے جب ضرورت ہو تو نیا لیں۔
- فہرست میں نجی پوسٹس تلاش کرنا۔ اینڈ پوائنٹ صرف عوامی پوسٹس واپس کرتا ہے۔
فی کنیکشن فی مہینہ US$ 9 سے US$ 0.75 تک، کنیکشن بڑھانے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
TikTok API ایک بار میں کتنی ویڈیوز فہرست کر سکتی ہے؟
/business/video/list/ سے فی صفحہ 20 تک۔ max_count صفحے کا سائز طے کرتا ہے اور ڈیفالٹ 10 ہے؛ مزید کے لیے cursor کو فالو کریں۔
کیا TikTok API فوٹو پوسٹس بھی فہرست کرتا ہے؟
ہاں۔ /business/video/list/ عوامی ویڈیو، فوٹو اور ٹیکسٹ پوسٹس واپس کرتا ہے، اور media_type VIDEO اور PHOTO میں فرق بتاتا ہے۔
کیا TikTok ویڈیو فہرست میں صرف اشتہار والی پوسٹس شامل ہوتی ہیں؟
ہاں۔ /business/video/list/ صرف ایڈز میں دکھائی جانے والی ویڈیوز بھی واپس کرتا ہے، جو پروفائل پر ظاہر ہوئے بغیر اشتہار کے طور پر چلتی ہیں، اور is_ad بتاتا ہے کہ کوئی پوسٹ اشتہار میں استعمال ہو رہی ہے یا نہیں۔
TikTok کی کوئی پوسٹ API فہرست سے غائب کیوں ہے؟
اینڈ پوائنٹ عوامی پوسٹس فہرست کرتا ہے، اور TikTok میوزک کاپی رائٹ جیسی خلاف ورزی کی بنا پر فلٹر کی گئی پوسٹس کو باہر رکھتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ