Popis TikTok videozapisa računa putem API-ja
TikTokov API for Business popisuje javne objave računa putem GET /business/video/list/, počevši od najnovijih, do 20 po stranici. Navedite polja za vraćanje, poput item_id, caption, share_url i video_views, i listajte kursorom dok je has_more true. filters.video_ids izdvaja određene objave, a svaki item_id je ID koji pozivi komentara koriste.
easyCoexistence popisuje nedavne objave TikTok računa pomoću list_social_posts iz Claudea, ChatGPT-ja ili vlastitog kôda, s item_id, opisom, poveznicom i brojačima svake objave, a get_social_credentials daje vlastitom kôdu token za kasnije stranice i druga polja.
Najviše objava koje /business/video/list/ vraća po stranici; zadana vrijednost za max_count je 10.
Jedinica kursora je UTC Unix vremenska oznaka; endpoint vraća objave objavljene prije nje.
Zadano polje, koje zahtjev s više navedenih polja mora uključivati, inače može doći do pogreške.
Broj poziva po ovlaštenom računu na ovom endpointu, kao i na svakom endpointu Accounts API-ja.
Što endpoint vraća?
Javne objave računa: videozapise prikazane na profilu, fotografije i tekstualne objave te videozapise samo za oglase („Only show in ads”), koji se prikazuju kao oglasi bez pojavljivanja na profilu. media_type razlikuje VIDEO od PHOTO, što obuhvaća fotografije i tekstualne objave. Objave koje je TikTok filtrirao zbog kršenja, primjerice autorskih prava za glazbu, izostavljaju se s popisa.
Kako se poziva?
GET zahtjevom i URL parametrima: business_id, fields kao JSON niz te, po izboru, filters, cursor i max_count, čija je zadana vrijednost 10. Token ide u zaglavlje Access-Token, a razvojna aplikacija treba dopuštenje Get Account Media pod 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'Koja polja opisuju objavu?
Osim metrika, u rasponu od video_views do impression_sources, popis sadrži i ova polja, sva pod opsegom video.list:
item_id: ID objave, koji koriste pozivi komentara i filters.video_ids.media_type: VIDEO ili PHOTO za fotografiju ili tekstualnu objavu.is_ad: je li objava korištena u oglasu.create_time: kada je objava objavljena, kao Unix sekunde u UTC-u.- caption: opis objave, uključujući hashtagove.
share_url: poveznica za dijeljenje, koja se na mobitelu i računalu ponaša drugačije.embed_url: poveznica za ugradnju na druge stranice, koja ne reproducira objave postavljene na „Friends” ili „Only you”.thumbnail_url: privremena pretpregledna slika čiji je istek u parametru x-expires.video_duration: trajanje u sekundama, na tri decimale.
Kako izgleda stranica rezultata?
Niz videos redom kojim ga TikTok vraća, plus cursor, vrijednost za sljedeću stranicu, i has_more, koji kaže postoji li ona. create_time stiže kao tekst s Unix sekundama. TikTokov primjer, skraćen na opisna polja i brojače:
{
"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
}
}Kako funkcionira paginacija?
Po vremenu. cursor je zadano trenutak u milisekundama, pa prva stranica sadrži najnovije objave, a svaki odgovor vraća cursor za sljedeći zahtjev. Proslijedite ga dok je has_more true. Prilagođena vremenska oznaka popisuje objave objavljene prije tog trenutka, a pravila TikToka o povjerenju i sigurnosti mogu stranicu učiniti kraćom od max_count čak i kad ima još objava.
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"]Kako dohvatiti određene objave?
Pomoću filters, JSON objekta: video_ids popisuje ID-eve objava koje treba vratiti, primjerice post_ids iz statusa objave. ad_post_only, valjan samo uz video_ids, zadržava samo objave koje su oglašivačima ovlaštene za Spark Ads. Filtrirani zahtjev prima ista polja kao i svaki drugi, pa jedan poziv može vratiti najnovije brojke za nekoliko poznatih objava.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Koja ograničenja vrijede?
Accounts API dopušta 40 poziva u minuti po ovlaštenom računu na ovom endpointu, a pozivi Accounts API-ja aplikacije zajedno dobivaju 600 u minuti na Basic razini i 1.000 iznad nje. Opisna polja su u stvarnom vremenu, brojke obično kasne 24 do 48 sati, a podaci objave prestaju se ažurirati 365 dana nakon objavljivanja.
Kako easyCoexistence popisuje videozapise?
Pomoću list_social_posts, koji uzima account_id i izborni limit, od 1 do 20 za TikTok. Vraća prvu stranicu TikToka: najnovije objave s item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments i shares, te cursor i has_more. Kasnije stranice i druga polja dolaze iz vašeg vlastitog koda, s tokenom i business_id iz 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>Uobičajene pogreške
- Traženje polja bez item_id. TikTokova referenca upozorava da zahtjev s više navedenih polja bez njega može ne uspjeti.
- Zaustavljanje kad stranica dođe kraća. TikTok može vratiti manje od max_count objava dok je has_more još true, pa treba slijediti has_more.
- Spremanje thumbnail_url za kasnije. To je privremena poveznica koja istječe u vrijeme navedeno u parametru x-expires, pa je po potrebi dohvatite ponovno.
- Traženje privatnih objava na popisu. Endpoint vraća samo javne objave.
US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, te besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Koliko TikTok videozapisa API može popisati odjednom?
Do 20 po stranici iz /business/video/list/. max_count određuje veličinu stranice i zadano je 10; za više slijedite cursor.
Popisuje li TikTok API i fotografske objave?
Da. /business/video/list/ vraća javne videozapise, fotografije i tekstualne objave, a media_type razlikuje VIDEO od PHOTO.
Uključuje li popis TikTok videozapisa objave samo za oglase?
Da. /business/video/list/ vraća i videozapise „Only show in ads”, koji se prikazuju kao oglasi bez pojavljivanja na profilu, a is_ad kaže je li objava korištena u oglasu.
Zašto objava s TikToka nedostaje na popisu API-ja?
Endpoint popisuje javne objave, a TikTok izostavlja objave filtrirane zbog kršenja, primjerice autorskih prava za glazbu.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na