Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

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.

20

Najviše objava koje /business/video/list/ vraća po stranici; zadana vrijednost za max_count je 10.

Milliseconds

Jedinica kursora je UTC Unix vremenska oznaka; endpoint vraća objave objavljene prije nje.

item_id

Zadano polje, koje zahtjev s više navedenih polja mora uključivati, inače može doći do pogreške.

40/min

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:

List the latest posts
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:

A page from /business/video/list/
{
  "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.

Every page, in Python
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.

The filters parameter
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:

The next page from your own code
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.
Radite ovo uz EasyCoexistence

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