Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Listanje video objava TikTok naloga preko API-ja

TikTok API for Business izlistava javne objave naloga pomoću GET /business/video/list/, počevši od najnovijih, do 20 po stranici. Navedite polja koja želite da vratite, na primer item_id, caption, share_url i video_views, i prelazite sa stranice na stranicu pomoću cursora dok je has_more true. filters.video_ids izdvaja određene objave, a svaki item_id je ID koji koriste pozivi za komentare.

easyCoexistence izlistava nedavne objave TikTok naloga pomoću list_social_posts iz Claude, ChatGPT ili vašeg koda, sa item_id, opisom, linkom i brojačima svake objave, a get_social_credentials daje vašem kodu token za kasnije stranice i ostala polja.

20

Najviše objava koje /business/video/list/ vraća po stranici; max_count podrazumevano iznosi 10.

Milliseconds

Jedinica cursora je UTC Unix vremenska oznaka; endpoint vraća objave objavljene pre nje.

item_id

Podrazumevano polje, koje zahtev sa više navedenih polja mora da sadrži, inače može doći do greške.

40/min

Broj poziva dozvoljen po ovlašćenom nalogu na ovom endpointu, kao i na svakom endpointu Accounts API-ja.

Šta endpoint vraća?

Javne objave naloga: video-snimke prikazane na profilu, foto i tekstualne objave i video-snimke Only show in ads, koje se puštaju kao reklame bez prikazivanja na profilu. media_type razlikuje VIDEO od PHOTO, što obuhvata foto i tekstualne objave. Objave koje je TikTok filtrirao zbog kršenja pravila, na primer zbog autorskih prava nad muzikom, ne ulaze u listu.

Kako se poziva?

Metodom GET i parametrima u URL-u: business_id, fields kao JSON niz i, opciono, filters, cursor i max_count, koji podrazumevano iznosi 10. Token ide u zaglavlje Access-Token, a aplikacija za programere treba dozvolu 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?

Pored metrika, koje idu od video_views do impression_sources, lista sadrži i ova polja, sva pod opsegom video.list:

  • item_id: ID objave, koji koriste pozivi za komentare i filters.video_ids.
  • media_type: VIDEO, ili PHOTO za foto ili tekstualnu objavu.
  • is_ad: da li se objava koristi u reklami.
  • create_time: kada je objava objavljena, kao Unix sekunde u UTC.
  • caption: opis objave, uključujući heštegove.
  • share_url: link za deljenje, koji se ponaša drugačije na telefonu i računaru.
  • embed_url: link za plejer na drugim sajtovima, koji ne reprodukuje objave postavljene na Friends ili Only you.
  • thumbnail_url: privremeni pregled slike čiji se rok važenja nalazi u parametru x-expires.
  • video_duration: dužina u sekundama, sa tri decimale.

Kako izgleda stranica rezultata?

Niz videos u redosledu koji vraća TikTok, plus cursor, vrednost za sledeći zahtev, i has_more, koji kaže da li postoji još jedna stranica. create_time stiže kao string Unix sekundi. TikTok-ov primer, 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 radi paginacija?

Po vremenu. cursor podrazumevano je trenutak u milisekundama, pa prva stranica sadrži najnovije objave, a svaki odgovor vraća cursor za sledeći zahtev. Prosledite ga dok je has_more true. Prilagođeni vremenski žig izlistava objave objavljene pre tog trenutka, a pravila o bezbednosti i poverenju kod TikTok-a mogu učiniti stranicu kraćom od max_count, čak i kada još ima 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 navodi ID-jeve objava koje treba vratiti, na primer post_ids iz statusa objavljivanja. ad_post_only, važeće samo uz video_ids, zadržava samo objave koje su oglašivačima odobrene za Spark Ads. Filtrirani zahtev uzima ista polja kao 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 važe?

Accounts API dozvoljava 40 poziva u minuti po ovlašćenom nalogu na ovom endpointu, a ukupno pozivi Accounts API-ja po aplikaciji iznose 600 u minuti na Basic nivou, odnosno 1.000 iznad njega. Opisna polja su u realnom vremenu, brojači obično kasne 24 do 48 sati, a podaci o objavi prestaju da se ažuriraju 365 dana nakon objavljivanja.

Kako easyCoexistence izlistava video-snimke?

Pomoću list_social_posts, koji uzima account_id i opciono limit, od 1 do 20 za TikTok. Vraća prvu stranicu TikTok-a: najnovije objave sa item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments i shares, a uz to cursor i has_more. Kasnije stranice i ostala polja dolaze iz vašeg sopstvenog koda, sa 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>

Česte greške

  • Traženje polja bez item_id. TikTok-ova referenca upozorava da zahtev sa više polja bez njega može da ne uspe.
  • Zaustavljanje kada stranica stigne kraća. TikTok može vratiti manje od max_count objava dok je has_more i dalje true, zato pratite has_more.
  • Čuvanje thumbnail_url za kasnije. To je privremeni link koji ističe u vreme navedeno u parametru x-expires, zato ga po potrebi zatražite ponovo.
  • Traženje privatnih objava na listi. Endpoint vraća samo javne objave.
Ovo radite uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mesečno, uz pad cene kako dodajete veze, i besplatni probni period od 3 dana.

Često postavljana pitanja

Koliko TikTok video-snimaka API može da izlista odjednom?

Do 20 po stranici iz /business/video/list/. max_count određuje veličinu stranice i podrazumevano iznosi 10; za još objava pratite cursor.

Da li TikTok API izlistava i foto objave?

Da. /business/video/list/ vraća javne video, foto i tekstualne objave, a media_type razlikuje VIDEO od PHOTO.

Da li lista TikTok video-snimaka uključuje objave samo za oglase?

Da. /business/video/list/ vraća i video-snimke Only show in ads, koje se puštaju kao reklame bez prikazivanja na profilu, a is_ad kaže da li se objava koristi u reklami.

Zašto objava na TikToku nedostaje na listi iz API-ja?

Endpoint izlistava javne objave, a TikTok izostavlja objave filtrirane zbog kršenja pravila, na primer zbog autorskih prava nad muzikom.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na