API හරහා TikTok ගිණුමේ videos ලැයිස්තුගත කිරීම
TikTok API for Business හරහා ගිණුමක public posts ලැයිස්තුගත කරන්නේ GET /business/video/list/ ඉල්ලීමෙන් වන අතර, අලුත්ම එකෙන් පටන් ගෙන පිටුවකට posts 20ක් දක්වා ලබා දේ. item_id, caption, share_url සහ video_views වැනි ක්ෂේත්ර නම් කරන්න, has_more true වන තාක් cursor සමඟ පිටු හරහා යන්න. filters.video_ids මගින් නිශ්චිත posts තෝරාගන්නා අතර, සෑම item_id එකක්ම ඒ comment calls වලට ලබා දෙන ID එකයි.
easyCoexistence Claude, ChatGPT හෝ ඔබේම code වලින් list_social_posts සමඟ TikTok ගිණුමක මෑත posts ලැයිස්තුගත කරයි, සෑම post එකකම item_id, caption, link සහ ගණන් සමඟ, ඊළඟ පිටු සහ අනෙක් fields සඳහා get_social_credentials ඔබේ කේතයට token එක දෙයි.
/business/video/list/ මගින් එක පිටුවකට ලැබෙන posts උපරිම ගණන; max_count පෙරනිමිය 10කි.
Cursor ඒකකය UTC Unix timestamp එකකි; endpoint එක එයට පෙර ප්රකාශිත posts ලබා දෙයි.
Default field, එය කිහිපයක් නම් කරන ඉල්ලීමක ඇතුළත් විය යුතුය; නැතිනම් දෝෂයක් ඇති විය හැක.
මෙම endpoint මත සෑම Accounts API endpoint එකකම මෙන්, අවසර ලත් ගිණුමකට එක් ගිණුමකට ඉඩ දෙන calls ගණන.
Endpoint එකෙන් මොනවා ලැබේද?
ගිණුමේ public posts: profile එකේ පෙන්වන videos, photo සහ text posts, සහ profile එකේ නොපෙනී ads ලෙස ධාවනය වන Only show in ads videos. media_type මගින් VIDEO සහ PHOTO අතර වෙනස දැක්වෙන අතර, PHOTO යනු photo සහ text posts ආවරණය කරයි. සංගීත පිටපත් අයිතිය වැනි උල්ලංඝනය වීම් නිසා TikTok විසින් පෙරා දමන posts ලැයිස්තුවෙන් ඉවත් කරයි.
මෙය ඇමතුම් ගන්නේ කෙසේද?
GET ඉල්ලීමක් සහ URL parameters සමඟ: business_id, fields JSON array එකක් ලෙස, සහ විකල්පව filters, cursor සහ max_count, එහි පෙරනිමිය 10කි. Token එක Access-Token header එකේ යවන අතර, developer app එකට 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'Post එකක් විස්තර කරන fields මොනවාද?
Metrics හැරුණු විට, video_views සිට impression_sources දක්වා, ලැයිස්තුවේ මේවා ඇත, සියල්ල video.list scope එක යටතේ:
item_id: post එකේ ID එක, comment calls සහ filters.video_idsමගින් භාවිතා වේ.media_type: VIDEO, හෝ photo හෝ text post සඳහා PHOTO.is_ad: post එක ad එකක භාවිතා වන්නේද යන්න.create_time: post එක ප්රකාශ වූ වේලාව, UTC හි Unix තත්පර ලෙස.- caption: post එකේ විස්තරය, hashtags ඇතුළුව.
share_url: බෙදාගත හැකි link එකක්, එය mobile සහ desktop මත වෙනස්ව ක්රියා කරයි.embed_url: වෙනත් වෙබ් අඩවි සඳහා player link එකක්, Friends හෝ Only you ලෙස සකසා ඇති posts ධාවනය නොවේ.thumbnail_url: තාවකාලික preview රූපයක්, එහි කල් ඉකුත්වීම x-expires parameter හි ඇත.video_duration: දිග තත්පරවලින්, දශම තුනට.
ප්රතිඵල පිටුවක් පෙනෙන්නේ කෙසේද?
TikTok එය ලබා දෙන අනුපිළිවෙලට videos array එකක්, තවත් ඉල්ලීම සඳහා යැවිය යුතු අගය වන cursor, සහ එයට ඊළඟ එකක් ඇත්දැයි කියන has_more. create_time string එකක් ලෙස Unix තත්පර ලෙස පැමිණේ. TikTok ගේ උදාහරණය, විස්තරාත්මක fields සහ ගණන් වලට සීමා කර:
{
"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
}
}Pagination ක්රියා කරන්නේ කෙසේද?
කාලය අනුව. cursor පෙරනිමිය වන්නේ මිලිතත්පරවලින් දැන් වේලාව, එබැවින් පළමු පිටුවේ අලුත්ම posts ඇත, සෑම response එකකම ඊළඟ ඉල්ලීම සඳහා cursor එක ලැබේ. has_more true වන තාක් එය යවන්න. අභිරුචි timestamp එකක් එම මොහොතට පෙර ප්රකාශිත posts ලැයිස්තු කරයි, සහ TikTok හි trust and safety නීති නිසා තවත් posts ඉතිරි වුවද පිටුව 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"]නිශ්චිත posts ලබා ගන්නේ කෙසේද?
filters සමඟ, JSON object එකක්: video_ids ලබා දිය යුතු post IDs ලැයිස්තුගත කරයි, උදාහරණයක් ලෙස publishing status එකෙන් ලැබෙන post_ids. ad_post_only, video_ids සමඟ පමණක් වලංගු වන අතර, Spark Ads සඳහා advertisers ට අවසර ඇති posts පමණක් තබයි. Filtered ඉල්ලීමකට අන් ඕනෑම ඉල්ලීමක් මෙන්ම fields ලැබේ, එබැවින් එක් call එකකින් දන්නා posts කිහිපයක අලුත්ම අගයන් ලබා ගත හැක.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}ඇති සීමාවන් මොනවාද?
Accounts API මගින් මෙම endpoint මත අවසර ලත් ගිණුමකට මිනිත්තුවකට calls 40ක් ඉඩ දෙන අතර, app එකක Accounts API calls එකට Basic මට්ටමින් මිනිත්තුවට 600ක් සහ ඊට වැඩි මට්ටමින් 1,000ක් ලැබේ. විස්තරාත්මක fields තත්ය කාලීනයි, ගණන් සාමාන්යයෙන් පැය 24 සිට 48 දක්වා පසුවේ, සහ post එකක දත්ත ප්රකාශ වූ දින 365 කට පසු යාවත්කාලීන වීම නවතී.
easyCoexistence videos ලැයිස්තුගත කරන්නේ කෙසේද?
list_social_posts මගින්, එය account_id සහ විකල්ප limit එකක් ගන්නා අතර, TikTok සඳහා 1 සිට 20 දක්වා. එය TikTok හි පළමු පිටුව ලබා දෙයි: item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments සහ shares සමඟ අලුත්ම posts, මෙන්ම cursor සහ has_more. ඊළඟ පිටු සහ අනෙක් fields ඔබේ කේතයෙන් ලැබේ, get_social_credentials වෙතින් ලබාගත් token සහ 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 නොමැතිව fields ඉල්ලීම. TikTok හි reference මගින් අනතුරු අඟවයි, item_id ඇතුළත් නොවන fields කිහිපයක ඉල්ලීමක් අසමත් විය හැක.
- පිටුව කෙටි ලෙස පැමිණි විට නතර වීම. has_more තවමත් true වුවද TikTok max_count ට වඩා අඩු posts ලබා දිය හැක, එබැවින් has_more අනුගමනය කරන්න.
- thumbnail_url පසුව සඳහා ගබඩා කිරීම. එය තාවකාලික link එකක් වන අතර x-expires parameter හි වේලාවට කල් ඉකුත් වේ, එබැවින් අවශ්ය වන විට නව එකක් ලබා ගන්න.
- ලැයිස්තුවේ private posts සොයීම. endpoint එක ලබා දෙන්නේ public posts පමණි.
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වෙයි, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
TikTok API එකෙන් එක වරකට videos කීයක් ලැයිස්තුගත කළ හැකිද?
/business/video/list/ වෙතින් පිටුවකට 20 දක්වා. max_count මගින් පිටු ප්රමාණය සකසන අතර පෙරනිමිය 10කි; තවත් සඳහා cursor අනුගමනය කරන්න.
TikTok API මගින් photo posts ද ලැයිස්තුගත කරයිද?
ඔව්. /business/video/list/ public video, photo සහ text posts ලබා දෙන අතර, media_type මගින් VIDEO සහ PHOTO අතර වෙනස දක්වයි.
TikTok video ලැයිස්තුවේ ad-only posts ඇතුළත් වේද?
ඔව්. /business/video/list/ profile එකේ නොපෙනී ads ලෙස ධාවනය වන Only show in ads videos ද ලබා දෙන අතර, is_ad මගින් post එකක් ad එකක භාවිතා වන්නේදැයි කියයි.
TikTok post එකක් API ලැයිස්තුවෙන් මඟ හැරී ඇත්තේ ඇයි?
endpoint එක public posts ලැයිස්තු කරන අතර, සංගීත පිටපත් අයිතිය වැනි උල්ලංඝනය වීම් නිසා TikTok පෙරා දමන posts ඉවත් කරයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ