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 VIDEO ను PHOTO నుండి వేరు చేస్తుంది, ఇందులో ఫోటో మరియు టెక్స్ట్ పోస్ట్లు ఉంటాయి. సంగీత కాపీరైట్ వంటి ఉల్లంఘనల కోసం TikTok ఫిల్టర్ చేసిన పోస్ట్లు జాబితాలో ఉండవు.
దీన్ని ఎలా పిలుస్తారు?
GET తో మరియు URL పారామీటర్లతో: business_id, fields JSON అర్రేగా, మరియు ఐచ్ఛికంగా 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 మరియు ఐచ్ఛికమైన లిమిట్ తీసుకుంటుంది, 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 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ