Listarea videoclipurilor unui cont TikTok prin API
API-ul TikTok for Business listează postările publice ale unui cont prin GET /business/video/list/, începând cu cele mai recente, până la 20 pe pagină. Specificați câmpurile de returnat, precum item_id, caption, share_url și video_views, și parcurgeți paginile cu cursor cât timp has_more este true. filters.video_ids selectează anumite postări, iar fiecare item_id este ID-ul folosit de apelurile pentru comentarii.
easyCoexistence listează postările recente ale unui cont TikTok cu list_social_posts din Claude, ChatGPT sau din propriul cod, cu item_id, descriere, link și contoarele fiecărei postări, iar get_social_credentials oferă propriului cod token-ul pentru paginile ulterioare și celelalte câmpuri.
Numărul maxim de postări returnate de /business/video/list/ pe pagină; max_count are valoarea implicită 10.
Unitatea cursorului este un marcaj temporal Unix UTC; endpoint-ul returnează postările publicate înainte de acesta.
Câmpul implicit, pe care trebuie să-l includă orice cerere care numește mai multe câmpuri, altfel poate apărea o eroare.
Numărul de apeluri permise pentru fiecare cont autorizat la acest endpoint, ca la orice endpoint Accounts API.
Ce returnează endpoint-ul?
Postările publice ale contului: videoclipurile afișate pe profil, postările cu fotografii și text și videoclipurile „Only show in ads”, care rulează ca reclame fără să apară pe profil. media_type deosebește VIDEO de PHOTO, care acoperă postările cu fotografii și text. Postările pe care TikTok le-a filtrat pentru încălcări, precum drepturile de autor asupra muzicii, nu apar în listă.
Cum îl apelați?
Cu un GET și parametri URL: business_id, fields ca array JSON și, opțional, filters, cursor și max_count, care are implicit valoarea 10. Token-ul merge în antetul Access-Token, iar aplicația pentru dezvoltatori are nevoie de permisiunea Get Account Media din secțiunea TikTok Accounts:
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'Ce câmpuri descriu o postare?
Pe lângă metrici, care merg de la video_views până la impression_sources, lista conține următoarele, toate sub domeniul video.list:
item_id: ID-ul postării, folosit de apelurile pentru comentarii și de filters.video_ids.media_type: VIDEO sau PHOTO pentru o postare cu fotografii sau text.is_ad: dacă postarea este folosită într-o reclamă.create_time: momentul publicării, ca secunde Unix în UTC.- caption: descrierea postării, inclusiv hashtag-urile.
share_url: un link de partajare, care se comportă diferit pe mobil și pe desktop.embed_url: un link de player pentru alte site-uri, care nu redă postările setate pe „Friends” sau „Only you”.thumbnail_url: o imagine de previzualizare temporară, a cărei expirare se află în parametrul x-expires.video_duration: durata în secunde, cu trei zecimale.
Cum arată o pagină de rezultate?
Un array videos în ordinea returnată de TikTok, plus cursor, valoarea de trimis pentru pagina următoare, și has_more, care indică dacă există una. create_time sosește ca string de secunde Unix. Exemplul TikTok, redus la câmpurile descriptive și la contoare:
{
"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
}
}Cum funcționează paginarea?
După timp. cursor are implicit momentul curent în milisecunde, așa că prima pagină conține cele mai noi postări, iar fiecare răspuns returnează cursorul pentru următoarea cerere. Transmiteți-l cât timp has_more este true. Un marcaj temporal personalizat listează postările publicate înainte de acel moment, iar regulile TikTok privind siguranța și încrederea pot face o pagină mai scurtă decât max_count, chiar dacă mai există postări.
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"]Cum obțineți anumite postări?
Cu filters, un obiect JSON: video_ids listează ID-urile postărilor de returnat, precum post_ids din statusul publicării. ad_post_only, valid doar alături de video_ids, păstrează doar postările autorizate pentru anunțătorii din Spark Ads. O cerere filtrată primește aceleași câmpuri ca orice alta, astfel încât un singur apel poate returna cifrele cele mai recente pentru câteva postări cunoscute.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Ce limite se aplică?
Accounts API permite 40 de apeluri pe minut pentru fiecare cont autorizat la acest endpoint, iar apelurile Accounts API ale unei aplicații primesc împreună 600 pe minut la nivelul Basic și 1.000 peste acesta. Câmpurile descriptive sunt în timp real, contoarele întârzie de obicei 24 până la 48 de ore, iar datele unei postări nu mai sunt actualizate la 365 de zile după publicare.
Cum listează easyCoexistence videoclipurile?
Cu list_social_posts, care primește account_id și un limit opțional, de la 1 la 20 pentru TikTok. Returnează prima pagină de la TikTok: cele mai recente postări cu item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments și shares, plus cursor și has_more. Paginile ulterioare și alte câmpuri se obțin din propriul cod, cu token-ul și business_id din get_social_credentials:
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>Greșeli frecvente
- Cererea fără item_id printre câmpurile solicitate. Referința TikTok avertizează că o cerere care numește mai multe câmpuri fără el poate eșua.
- Oprirea atunci când o pagină vine incompletă. TikTok poate returna mai puține postări decât max_count în timp ce has_more rămâne true, așa că urmați has_more.
- Stocarea thumbnail_url pentru mai târziu. Este un link temporar care expiră la momentul din parametrul x-expires, așa că obțineți unul proaspăt atunci când este nevoie.
- Căutarea postărilor private în listă. Endpoint-ul returnează doar postări publice.
US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Câte videoclipuri TikTok poate lista API-ul odată?
Până la 20 pe pagină, de la /business/video/list/. max_count stabilește dimensiunea paginii și are implicit 10; urmăriți cursorul pentru mai multe.
API-ul TikTok listează și postările cu fotografii?
Da. /business/video/list/ returnează postări publice cu video, fotografii și text, iar media_type deosebește VIDEO de PHOTO.
Lista de videoclipuri TikTok include și postările doar pentru reclame?
Da. /business/video/list/ returnează și videoclipurile „Only show in ads”, care rulează ca reclame fără să apară pe profil, iar is_ad arată dacă o postare este folosită într-o reclamă.
De ce lipsește o postare TikTok din lista API-ului?
Endpoint-ul listează doar postări publice, iar TikTok exclude postările filtrate pentru încălcări, precum drepturile de autor asupra muzicii.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la