एपीआयद्वारे 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 timestamp आहे; हा एंडपॉइंट त्या वेळेपूर्वी प्रकाशित झालेल्या पोस्ट परत करतो.
डीफॉल्ट फील्ड, जे अनेक फील्ड नावे दिलेल्या विनंतीत समाविष्ट असणे आवश्यक आहे; नाहीतर त्रुटी येऊ शकते.
या एंडपॉइंटवर प्रत्येक अधिकृत खात्यासाठी अनुमत कॉल्सची संख्या, इतर प्रत्येक Accounts API एंडपॉइंटप्रमाणे.
हा एंडपॉइंट काय परत करतो?
खात्याच्या सार्वजनिक पोस्ट: प्रोफाइलवर दाखवले जाणारे व्हिडिओ, फोटो आणि टेक्स्ट पोस्ट, आणि Only show in ads व्हिडिओ, जे प्रोफाइलवर न दिसता जाहिरात म्हणून चालतात. media_type VIDEO आणि PHOTO यांमध्ये फरक करतो, 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 scope अंतर्गत येतात:
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 ॲरे 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 च्या संदर्भात इशारा आहे की item_id न नमूद करता अनेक फील्ड्स मागितल्यास विनंती अयशस्वी होऊ शकते.
- पान कमी आल्यावर थांबणे. has_more सत्य असतानाही TikTok max_count पेक्षा कमी पोस्ट परत करू शकते, त्यामुळे त्याऐवजी 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/ Only show in ads व्हिडिओ देखील परत करतो, जे प्रोफाइलवर न दिसता जाहिरात म्हणून चालतात, आणि is_ad सांगतो की पोस्ट जाहिरातीत वापरली जात आहे का.
API यादीतून TikTok पोस्ट गहाळ का आहे?
एंडपॉइंट सार्वजनिक पोस्ट यादीत आणतो, आणि संगीत कॉपीराइटसारख्या उल्लंघनांसाठी गाळलेल्या पोस्ट TikTok वगळतो.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: