लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

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 का Scope 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 रेफ़रेंस हर Accounts API एंडपॉइंट के लिए वह अनुमति बताता है जो TikTok Accounts के तहत उसे खोलती है, या कोई नहीं। उसका permission scope रेफ़रेंस और वेबहुक गाइड इन्हीं समूहों को 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

कौन से टोकन स्कोप कौन से फ़ील्ड खोलते हैं?

/business/get/ और /business/video/list/ के लिए TikTok के रेफ़रेंस हर जवाब वाले फ़ील्ड के लिए ज़रूरी अनुमति बताते हैं, और दो अन्य फ़ीचर अपना स्कोप बताते हैं:

  • 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: watch time, full-watch rate, रिटेंशन, traffic sources, दर्शक ब्रेकडाउन और पोस्ट से मिलने वाले क्लिक।
  • 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 के सहमति पेज पर दिखती हैं। easyCoexistence खाते के मालिक को TikTok account holder authorization यूआरएल पर भेजता है, जो TikTok के पोर्टल में उसके ऐप के लिए बनता है और उन अनुमतियों के नाम पहले से लिखता है, और इसमें केवल अपना एक state मान जोड़ता है। मालिक वही स्वीकार करता है जो TikTok दिखाता है, और TikTok जो scope स्ट्रिंग लौटाता है वह कनेक्शन के साथ सहेजी जाती है। इसके बाद 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 रेफ़रेंस की ओर इशारा करता है। किसी फ़ील्ड के लिए रेफ़रेंस उसे तभी उपलब्ध कराते हैं जब मालिक उसका स्कोप दे चुका हो, और उनका समाधान है कि मालिक उस स्कोप के साथ ऐप को फिर से अधिकृत करे। पूछने से पहले /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 for Business के एक्सेस टोकन: 24 घंटे, रिफ़्रेश और रद्द करनाTikTok API for Business के टोकन कैसे जारी होते हैं: auth_code का एक्सचेंज, 24 घंटे का एक्सेस टोकन, एक साल का रिफ़्रेश टोकन, नवीनीकरण और रद्द करना।TikTok API for Business बनाम Content Posting APITikTok का API for Business developers.tiktok.com से अलग क्यों है: कमेंट और उनका वेबहुक, इनसाइट्स, कौन से खाते जुड़ते हैं और टोकन कैसे नवीनीकृत होते हैं।TikTok API for Business के वेबहुक सेट करनाTikTok API for Business ऐप को वेबहुक पर सब्सक्राइब करें: /business/webhook/update/, VIDEO और COMMENT इवेंट, कॉलबैक नियम और Tiktok-Signature।एपीआई के ज़रिए TikTok वीडियो मेट्रिक्स: व्यूज़, वॉच टाइम और पूरा देखने की दरTikTok API for Business हर वीडियो के लिए ये मेट्रिक्स लौटाता है: व्यूज़, रीच, वॉच टाइम, पूरा देखने की दर, रिटेंशन, ट्रैफ़िक स्रोत और दर्शकों के देश।एपीआई के ज़रिए TikTok दर्शक डेमोग्राफ़िक्सTikTok के API for Business से मिलने वाले फ़ॉलोअर डेमोग्राफ़िक्स: उम्र, लिंग, देश, शहर का हिस्सा, हर घंटे की गतिविधि और 100 फ़ॉलोअर का नियम।TikTok एनालिटिक्स API: अकाउंट इनसाइट्स और वीडियो मेट्रिक्सAPI for Business से मिलने वाले TikTok मेट्रिक्स: किसी अकाउंट के रोज़ के फ़ॉलोअर, व्यूज़ और लाइक, तथा हर वीडियो के व्यूज़, लाइक, कमेंट और शेयर।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित