एपीआई मार्फत 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, क्याप्सन, लिंक र गणनासहित, र पछिल्ला पेज तथा अन्य फिल्डका लागि get_social_credentials ले तपाईंको आफ्नै कोडलाई टोकन दिन्छ।
/business/video/list/ ले प्रति पेज फर्काउने पोस्टको अधिकतम संख्या; max_count को पूर्वनिर्धारित मान 10 हो।
cursor को इकाइ UTC Unix टाइमस्ट्याम्प हो; एन्डपोइन्टले त्यसभन्दा अगाडि प्रकाशित पोस्ट फर्काउँछ।
पूर्वनिर्धारित फिल्ड, जुन धेरै फिल्ड नाम लिने अनुरोधमा समावेश गर्नुपर्छ, नत्र त्रुटि आउन सक्छ।
यो एन्डपोइन्टमा प्रत्येक अधिकृत खातामा अनुमति दिइएका कलहरूको संख्या, जस्तै हरेक Accounts API एन्डपोइन्टमा।
एन्डपोइन्टले के फर्काउँछ?
खाताका सार्वजनिक पोस्टहरू हुन्: यसको प्रोफाइलमा देखिने भिडियो, फोटो र टेक्स्ट पोस्ट, र केवल विज्ञापनमा मात्र देखिने भिडियो, जुन प्रोफाइलमा नदेखिई विज्ञापनका रूपमा चल्छन्। media_type ले VIDEO र PHOTO छुट्याउँछ, जसमा फोटो र टेक्स्ट पोस्ट पर्छन्। संगीत प्रतिलिपि अधिकार जस्ता उल्लंघनका कारण TikTok ले फिल्टर गरेका पोस्ट सूचीबाट छुटाइन्छन्।
एन्डपोइन्टलाई कसरी कल गरिन्छ?
GET अनुरोध र यूआरएल प्यारामिटरसहित: business_id, JSON एरेका रूपमा fields, र ऐच्छिक रूपमा 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: सेकेन्डमा लम्बाइ, तीन दशमलवसम्म।
नतिजाको पेज कस्तो देखिन्छ?
TikTok ले फर्काएको क्रममा videos एरे, अर्को पेजका लागि पठाउनुपर्ने मान 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 का कति भिडियो एपीआई ले एकपटकमा सूचीबद्ध गर्न सक्छ?
/business/video/list/ बाट प्रति पेज 20 सम्म। max_count ले पेजको आकार तोक्छ, र पूर्वनिर्धारित मान 10 हो; थप पोस्टका लागि cursor पछ्याउनुहोस्।
के TikTok API ले फोटो पोस्ट पनि सूचीबद्ध गर्छ?
हो। /business/video/list/ ले सार्वजनिक भिडियो, फोटो र टेक्स्ट पोस्ट फर्काउँछ, र media_type ले VIDEO र PHOTO छुट्याउँछ।
के TikTok भिडियो सूचीमा केवल विज्ञापनका पोस्ट पनि हुन्छन्?
हो। /business/video/list/ ले केवल विज्ञापनमा देखिने भिडियो पनि फर्काउँछ, जुन प्रोफाइलमा नदेखिई विज्ञापनका रूपमा चल्छन्, र is_ad ले पोस्ट विज्ञापनमा प्रयोग भइरहेको छ कि छैन भनी बताउँछ।
TikTok पोस्ट एपीआई सूचीबाट किन छुटेको छ?
एन्डपोइन्टले सार्वजनिक पोस्ट मात्र सूचीबद्ध गर्छ, र संगीत प्रतिलिपि अधिकार जस्ता उल्लंघनका लागि फिल्टर गरिएका पोस्ट TikTok ले छोड्छ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको