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, தலைப்பு, இணைப்பு மற்றும் எண்ணிக்கைகளுடன், அடுத்த பக்கங்களுக்கும் பிற புலங்களுக்குமான டோக்கனை get_social_credentials உங்கள் சொந்தக் குறியீட்டுக்குத் தருகிறது.
/business/video/list/ ஒரு பக்கத்திற்கு அதிகபட்சம் எத்தனை பதிவுகளைத் தரும்; max_count இயல்புநிலை 10.
cursor-இன் அலகு, UTC Unix நேர முத்திரை; அந்த நேரத்திற்கு முன் வெளியிடப்பட்ட பதிவுகளை எண்ட்பாயிண்ட் தரும்.
பல புலங்களைக் கோரும் கோரிக்கை சேர்க்க வேண்டிய இயல்பு புலம்; அது இல்லாவிட்டால் பிழை ஏற்படலாம்.
இந்த எண்ட்பாயிண்டில் அங்கீகரிக்கப்பட்ட ஒவ்வொரு கணக்குக்கும் அனுமதிக்கப்படும் அழைப்புகள், ஒவ்வொரு Accounts API எண்ட்பாயிண்டிலும் உள்ளதுபோல.
இந்த எண்ட்பாயிண்ட் எதைத் திருப்பித் தரும்?
கணக்கின் பொது பதிவுகளை: சுயவிவரத்தில் காட்டப்படும் வீடியோக்கள், புகைப்படம் மற்றும் உரைப் பதிவுகள், மற்றும் Only show in ads வீடியோக்கள், அவை சுயவிவரத்தில் தோன்றாமல் விளம்பரங்களாக ஓடும். media_type வீடியோவை PHOTO-விலிருந்து பிரித்துக் காட்டும், அதில் புகைப்படம் மற்றும் உரைப் பதிவுகள் அடங்கும். இசைப் பதிப்புரிமை போன்ற மீறல்களுக்காக TikTok வடிகட்டிய பதிவுகள் பட்டியலில் சேர்க்கப்படாது.
இதை எப்படி அழைப்பது?
GET முறையிலும் URL அளவுருக்களுடனும்: business_id, JSON வரிசையாக fields, விருப்பமாக filters, cursor மற்றும் max_count, இதில் 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: நீளம் வினாடிகளில், மூன்று தசம இடங்களுடன்.
முடிவுகளின் ஒரு பக்கம் எப்படித் தெரிகிறது?
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-இன் குறிப்பு எச்சரிக்கிறது.
- ஒரு பக்கம் குறைவாக வரும்போது நிறுத்துதல். 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 ஒரு பதிவு விளம்பரத்தில் பயன்படுத்தப்படுகிறதா என்று சொல்லும்.
TikTok பதிவு API பட்டியலில் ஏன் விடுபட்டிருக்கிறது?
இந்த எண்ட்பாயிண்ட் பொது பதிவுகளைப் பட்டியலிடுகிறது, இசைப் பதிப்புரிமை போன்ற மீறல்களுக்காக வடிகட்டப்பட்ட பதிவுகளை TikTok விட்டுவிடுகிறது.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: