API के ज़रिए TikTok खाते के वीडियो की सूची
TikTok का API for Business GET /business/video/list/ से खाते की सार्वजनिक पोस्ट सबसे नई से शुरू करके, प्रति पेज 20 तक सूचीबद्ध करता है। लौटाए जाने वाले फ़ील्ड का नाम दें, जैसे item_id, caption, share_url और video_views, और has_more सही होने तक cursor से पेजों में आगे बढ़ें। filters.video_ids चुनी हुई पोस्ट निकालता है, और हर item_id वही ID है जो कमेंट कॉल लेती है।
easyCoexistence Claude, ChatGPT या आपके अपने कोड से list_social_posts के ज़रिए किसी TikTok खाते की हाल की पोस्ट सूचीबद्ध करता है, हर पोस्ट के item_id, caption, लिंक और गिनती के साथ, और बाद के पेज व दूसरे फ़ील्ड के लिए get_social_credentials आपके अपने कोड को टोकन देता है।
/business/video/list/ एक पेज में अधिकतम जितनी पोस्ट लौटा सकता है, वह सीमा है; max_count का डिफ़ॉल्ट 10 है।
cursor की इकाई UTC Unix टाइमस्टैम्प है; एंडपॉइंट उससे पहले प्रकाशित पोस्ट लौटाता है।
डिफ़ॉल्ट फ़ील्ड, जिसे कई फ़ील्ड माँगने वाले अनुरोध में शामिल होना ज़रूरी है, वरना गड़बड़ी हो सकती है।
इस एंडपॉइंट पर हर अधिकृत खाते के लिए अनुमत कॉल की संख्या भी वैसी ही है जैसी हर Accounts API एंडपॉइंट पर है।
यह एंडपॉइंट क्या लौटाता है?
खाते की सार्वजनिक पोस्ट: प्रोफ़ाइल पर दिखने वाले वीडियो, फ़ोटो और टेक्स्ट पोस्ट, और Only show in ads वीडियो, जो प्रोफ़ाइल पर दिखे बिना विज्ञापन के रूप में चलते हैं। 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 सही है, उसे भेजें। एक कस्टम टाइमस्टैम्प उस क्षण से पहले प्रकाशित पोस्ट सूचीबद्ध करता है, और 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 लौटाने वाली पोस्ट ID की सूची देता है, जैसे पब्लिशिंग स्टेटस से मिले 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 अब भी सही हो, इसलिए has_more का पालन करें।
- thumbnail_url को बाद के लिए सहेजना। यह एक अस्थायी लिंक है जो x-expires पैरामीटर के समय पर समाप्त हो जाता है, इसलिए ज़रूरत पड़ने पर नया लाएँ।
- सूची में निजी पोस्ट खोजना। एंडपॉइंट केवल सार्वजनिक पोस्ट लौटाता है।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन जोड़ने पर घटती दर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
एक बार में TikTok के कितने वीडियो API सूचीबद्ध कर सकता है?
प्रति पेज 20 तक, /business/video/list/ से। max_count पेज का आकार तय करता है और डिफ़ॉल्ट 10 है; और पोस्ट के लिए cursor का पालन करें।
क्या TikTok API फ़ोटो पोस्ट भी सूचीबद्ध करता है?
हाँ। /business/video/list/ सार्वजनिक वीडियो, फ़ोटो और टेक्स्ट पोस्ट लौटाता है, और media_type VIDEO और PHOTO में फ़र्क बताता है।
क्या TikTok वीडियो सूची में केवल विज्ञापन वाली पोस्ट शामिल होती हैं?
हाँ। /business/video/list/ Only show in ads वीडियो भी लौटाता है, जो प्रोफ़ाइल पर दिखे बिना विज्ञापन के रूप में चलते हैं, और is_ad बताता है कि पोस्ट किसी विज्ञापन में इस्तेमाल हो रही है या नहीं।
TikTok पोस्ट API सूची में क्यों नहीं है?
एंडपॉइंट सार्वजनिक पोस्ट सूचीबद्ध करता है, और TikTok म्यूज़िक कॉपीराइट जैसे उल्लंघनों के लिए फ़िल्टर की गई पोस्ट छोड़ देता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित