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

TikTok API for Business کے اسکوپس: ہر اجازت کیا کھولتی ہے

TikTok کا API for Business رسائی کو دو تہوں میں دیتا ہے۔ ڈویلپر ایپ کے پاس TikTok Accounts کے تحت اجازتیں ہوتی ہیں، جیسے Video Publish اور Manage Account Comment، جو اینڈ پوائنٹس کھولتی ہیں۔ اکاؤنٹ اونر کی منظوری ایکسیس ٹوکن کو اسکوپس دیتی ہے، جیسے user.insights اور video.list، جو واپس آنے والی فیلڈز طے کرتے ہیں۔ /tt_user/token_info/get/ وہ اسکوپس دکھاتا ہے جو ٹوکن کے پاس ہوں۔

easyCoexistence TikTok اکاؤنٹ اونر سے اس کی ایپ کی تمام اجازتیں ایک ہی سائن ان میں مانگتا ہے، تاکہ Claude، ChatGPT یا آپ کا اپنا کوڈ اس کے ٹولز کے ذریعے پبلش کر سکے، کمنٹس سنبھال سکے اور انسائٹس پڑھ سکے، اور get_social_credentials آپ کے اپنے کوڈ کو Accounts API کے دیگر اینڈ پوائنٹس کے لیے وہی ٹوکن دیتا ہے۔

18000000

TikTok Accounts کا اسکوپس ID، یعنی وہ پہلی سطح کی اجازت جو Accounts API کے پروفائل، پوسٹ، کمنٹ اور پبلشنگ اینڈ پوائنٹس سے اوپر ہے۔

user.account.type

وہ اسکوپس جو اکاؤنٹ کے پروفائل ڈیٹا میں is_business_account اور has_advanced_access کے پیچھے ہے۔

comment.list

وہ اسکوپس جسے اکاؤنٹ اونر نے دینا اور فعال رکھنا ضروری ہے، تاکہ ایپ comment.update ویب ہک ایونٹس وصول کر سکے۔

video.upload

وہ اسکوپس جو پوسٹ کو شائع کرنے کے بجائے ڈرافٹ کے طور پر اپ لوڈ کرنے کے لیے درکار ہے۔

2 to 3 days

TikTok کی جانب سے ڈویلپر ایپ کی اجازتوں میں تبدیلی کے ریویو کے لیے لگنے والے کاروباری دن۔

TikTok کی اجازتوں کی دو تہیں کون سی ہیں؟

ایپ کی اجازتیں اور ٹوکن اسکوپس۔ ایپ کی اجازتیں My Apps، ایپ، Scope of permission کے تحت منتخب کی جاتی ہیں، اور TikTok انہیں ریویو کرتا ہے؛ یہ تین سطحوں میں آتی ہیں، اور پہلی سطح کی اجازت اس کے نیچے کے ہر اینڈ پوائنٹ کو کور کرتی ہے۔ ٹوکن اسکوپس وہ ہیں جو اکاؤنٹ اونر نے ایپ کی اجازت دیتے وقت منظور کیے، اور ہر ٹوکن کے ساتھ scope کے طور پر ایک کاما سے جڑی سٹرنگ میں واپس آتے ہیں۔ کال کے لیے ایپ کی اس اینڈ پوائنٹ پر اجازت درکار ہے، اور بعض رسپانس فیلڈز کے لیے ٹوکن پر اسکوپ بھی ضروری ہے۔

کون سی ایپ کی اجازت ہر اینڈ پوائنٹ کھولتی ہے؟

TikTok کا API reference ہر Accounts API اینڈ پوائنٹ کے لیے وہ اجازت بتاتا ہے جو TikTok Accounts کے تحت اسے کھولتی ہے، یا کوئی نہیں۔ اس کا permission scope reference اور ویب ہک گائیڈ انہی گروپس کو Business User، Business Media، Business Comment اور Business Content کہتے ہیں، اس لیے دونوں ناموں کے سیٹ کی توقع رکھیں:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

کون سے ٹوکن اسکوپس کون سی فیلڈز کھولتے ہیں؟

TikTok کے /business/get/ اور /business/video/list/ کی دستاویزات ہر رسپانس فیلڈ کے لیے درکار اجازت بتاتی ہیں، اور دو دیگر خصوصیات کا اپنا الگ اسکوپ ہے:

  • user.info.basic: display_name اور profile_image کھولتا ہے۔
  • user.info.username: username، جس کے لیے جون 2023 تک user.info.basic درکار تھا۔
  • user.info.profile: profile_deep_link، bio_description اور is_verified کھولتا ہے۔
  • user.info.stats: following_count، followers_count، total_likes اور videos_count کھولتا ہے۔
  • user.account.type: is_business_account اور has_advanced_access کھولتا ہے۔
  • user.insights: روزانہ کے اکاؤنٹ میٹرکس اور عمر، جنس، ملک اور شہر کے لحاظ سے فالوورز کی تفصیل کھولتا ہے۔
  • video.list: پوسٹ کی فیلڈز جیسے item_id، caption، share_url، likes، comments، shares، reach اور video_views کھولتا ہے۔
  • video.insights: واچ ٹائم، مکمل دیکھنے کی شرح، ریٹینشن، ٹریفک کے ذرائع، ناظرین کی تفصیل اور پوسٹ کے ذریعے آنے والے کلکس کھولتا ہے۔
  • comment.list: comment.update ویب ہک، جسے TikTok ایپ کے اندر کے مواد کے کمنٹس اور جوابات پڑھنے کے طور پر بیان کرتا ہے۔
  • video.upload: upload_to_draft یا is_draft کے ساتھ ویڈیو یا فوٹو پوسٹ کو ڈرافٹ کے طور پر اپ لوڈ کرنا۔

ٹوکن کے اسکوپس کیسے دیکھیں؟

/tt_user/token_info/get/ سے پوچھیں، جو app_id اور ایکسیس ٹوکن لیتا ہے اور ٹوکن کا scope اور اکاؤنٹ کا creator_id واپس کرتا ہے۔ TikTok کی مثالی اسکوپ سٹرنگز میں video.publish اور comment.list.manage بھی شامل ہیں، جن کے نام پبلشنگ اور کمنٹ مینجمنٹ اینڈ پوائنٹس سے ملتے ہیں، حالانکہ اس کی دستاویزات کسی فیلڈ کو ان میں سے کسی سے نہیں جوڑتیں۔

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

easyCoexistence کا TikTok کنکشن کیا مانگتا ہے؟

وہ اجازتیں جو اس کی ڈویلپر ایپ رکھتی ہے، سب TikTok کے رضامندی کے صفحے (consent page) پر دکھائی جاتی ہیں۔ easyCoexistence اکاؤنٹ اونر کو TikTok account holder authorization URL پر بھیجتا ہے جو TikTok کا پورٹل اس کی ایپ کے لیے بناتا ہے، جو پہلے ہی ان اجازتوں کا نام لیتا ہے، اور صرف اپنی ایک state ویلیو شامل کرتا ہے۔ اونر وہی منظور کرتا ہے جو TikTok دکھاتا ہے، اور TikTok کی واپس کی ہوئی اسکوپ سٹرنگ کنکشن کے ساتھ محفوظ کی جاتی ہے۔ اکاؤنٹ کے لیے easyCoexistence جو اینڈ پوائنٹس کال کرتا ہے:

  • /business/get/ پروفائل، روزانہ کے میٹرکس اور فالوورز کی تفصیل کے لیے۔
  • /business/video/list/ پوسٹس اور ان کے میٹرکس کے لیے۔
  • /business/video/publish/، /business/photo/publish/ اور /business/publish/status/ پبلشنگ کے لیے۔
  • /business/comment/list/، /business/comment/reply/create/، /business/comment/hide/ اور /business/comment/delete/ کمنٹس کے لیے۔
  • /business/webhook/update/، ایپ کی سطح پر، کمنٹ ویب ہک کے لیے۔

مستقبل میں نئی اجازت کیسے شامل کریں؟

دو مرحلوں میں، ہر تہہ کے لیے ایک۔ ایپ کے لیے My Apps، ایپ، Scope of permission کھولیں، اسے ایڈٹ کریں، ایک ایسی وجہ دیں جو نئے اسکوپس سے مطابقت رکھتی ہو اور سبمٹ کریں؛ TikTok کا ریویو دو سے تین کاروباری دن لے سکتا ہے، اور 20 مارچ 2026 سے وہ درخواست جس میں TikTok Accounts شامل ہو، پہلے Accounts API Access Application Form مانگتی ہے۔ ٹوکن کے لیے اکاؤنٹ اونر ایپ کو دوبارہ اجازت دیتا ہے، کیونکہ ٹوکن وہ اسکوپس رکھتا ہے جو جاری ہونے کے وقت منظور ہوئے تھے۔

جب اجازت غائب ہو تو کیا ہوتا ہے؟

کال کے لیے TikTok کا ایرر کوڈ 40001 ہے، یعنی متعلقہ آپریشن کے لیے اجازت نہیں، اور اس کا حل permission scope reference کی طرف اشارہ کرتا ہے۔ فیلڈ کے لیے دستاویزات اسے تب تک دستیاب بناتی ہیں جب اکاؤنٹ اونر اس کا اسکوپ دے دے، اور ان کا حل یہ ہے کہ اونر اسی اسکوپ کے ساتھ ایپ کو دوبارہ اجازت دے۔ پوچھنے سے پہلے /tt_user/token_info/get/ سے ٹوکن کا scope جانچیں۔

عام غلطیاں

  • یہ سمجھنا کہ کنکشن شدہ اکاؤنٹس کو خود بخود نئی ایپ اجازت مل جائے گی۔ ان کے ٹوکن اجازت کے وقت منظور شدہ اسکوپس رکھتے ہیں، جب تک ہر اونر ایپ کو دوبارہ اجازت نہ دے۔
  • user.account.type کے بغیر is_business_account کی درخواست کرنا۔ TikTok یہ فیلڈ اور has_advanced_access صرف ان ٹوکنز کے لیے دستیاب کرتا ہے جن کے پاس یہ اسکوپ ہو۔
  • comment.list کے بغیر comment.update کا انتظار کرنا۔ TikTok کمنٹ ایونٹس صرف اس وقت بھیجتا ہے جب اس اسکوپ کے ساتھ اونر کی اجازت برقرار ہو۔
  • ٹوکن میں ایپ کی اجازت کے نام تلاش کرنا۔ اسکوپ سٹرنگ video.list جیسے نام استعمال کرتی ہے، جبکہ Get Account Media جیسے نام ایپ کی سیٹنگز میں ہوتے ہیں۔
EasyCoexistence کے ساتھ یہ کام کرنا

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

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

TikTok API for Business کون سے اسکوپس استعمال کرتا ہے؟

ٹوکن اسکوپس جیسے user.info.basic، user.info.stats، user.insights، video.list، video.insights، comment.list اور video.upload، جو اکاؤنٹ اونر ایپ کی TikTok Accounts اجازتوں کے علاوہ دیتا ہے۔

TikTok کے کمنٹ ویب ہک کے لیے کون سی اجازتیں درکار ہیں؟

ایپ کو TikTok Accounts اور Business Comment درکار ہیں، اور اکاؤنٹ اونر کو comment.list دینا ہوگا۔ اگر یہ اجازت ختم ہو جائے یا واپس لے لی جائے تو ایونٹس رک جاتے ہیں۔

کیا نیا TikTok اسکوپ پہلے سے جاری ٹوکنز پر لاگو ہوتا ہے؟

نہیں۔ ٹوکن وہ اسکوپس رکھتا ہے جو جاری ہونے کے وقت منظور ہوئے تھے، اس لیے نیا شامل کرنے کے لیے اکاؤنٹ اونر ایپ کو دوبارہ اجازت دیتا ہے۔

TikTok نئی اجازت کی منظوری میں کتنا وقت لیتا ہے؟

TikTok کہتا ہے کہ اجازت میں تبدیلی کا ریویو دو سے تین کاروباری دن لے سکتا ہے، اور جو درخواستیں TikTok Accounts شامل کریں انہیں پہلے Accounts API Access Application Form درکار ہے۔

مزید پڑھیں

TikTok API برائے کاروبار کے ایکسیس ٹوکن: 24 گھنٹے، ریفریش اور منسوخیTikTok API برائے کاروبار کے ٹوکن: auth_code کا تبادلہ، 24 گھنٹے کا ایکسیس ٹوکن، ایک سال کا ریفریش ٹوکن، تجدید اور منسوخی۔TikTok API for Business اور Content Posting API کا موازنہTikTok کی API for Business، developers.tiktok.com کے بجائے: کمنٹس اور ان کا ویب ہک، انسائٹس، کون سے اکاؤنٹس جڑتے ہیں اور ٹوکن کیسے تجدید ہوتے ہیں۔TikTok API for Business ویب ہکس کی ترتیبTikTok API for Business ایپ کے ویب ہکس سبسکرائب کرنا: /business/webhook/update/، VIDEO اور COMMENT ایونٹس، کال بیک قواعد اور Tiktok-Signature۔TikTok ویڈیو میٹرکس API کے ذریعے: ویوز، واچ ٹائم اور تکمیلTikTok کی API for Business ہر ویڈیو کے میٹرکس دیتی ہے: ویوز، ریچ، واچ ٹائم، مکمل دیکھنے کی شرح، ریٹینشن، ٹریفک کے ذرائع اور ناظرین کے ممالک۔API کے ذریعے TikTok فالوورز کی ڈیموگرافکسTikTok کی API فالوورز کی عمر، جنس، ملک، شہر کے حصے اور ہر گھنٹے کی سرگرمی دیتی ہے، اور 100 فالوورز کی شرط۔TikTok اینالیٹکس API: اکاؤنٹ انسائٹس اور ویڈیو میٹرکسTikTok API for Business سے ملنے والے میٹرکس: اکاؤنٹ کے روزانہ فالوورز، ویوز اور لائکس، اور ہر ویڈیو کے ویوز، لائکس، کمنٹس اور شیئرز۔

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

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

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

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