Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Pobieranie listy filmów konta TikTok przez API

API for Business TikToka wyświetla publiczne posty konta żądaniem GET /business/video/list/, zaczynając od najnowszych, do 20 na stronę. Wskaż pola do zwrócenia, na przykład item_id, caption, share_url i video_views, i przechodź dalej za pomocą cursor, dopóki has_more ma wartość true. filters.video_ids wybiera konkretne posty, a każdy item_id to ID, którego używają wywołania komentarzy.

easyCoexistence wyświetla ostatnie posty konta TikTok przez list_social_posts z poziomu Claude, ChatGPT lub własnego kodu, z item_id, opisem, linkiem i licznikami każdego posta, a get_social_credentials daje własnemu kodowi token do kolejnych stron i innych pól.

20

Maksymalna liczba postów na stronę, jaką zwraca /business/video/list/; max_count domyślnie wynosi 10.

Milliseconds

Jednostką kursora jest sygnatura czasowa Unix w UTC; endpoint zwraca posty opublikowane przed nią.

item_id

Pole domyślne, które musi znaleźć się w żądaniu z kilkoma wskazanymi polami, inaczej może wystąpić błąd.

40/min

Liczba wywołań dozwolona na autoryzowane konto w tym endpoincie, tak jak w każdym endpoincie Accounts API.

Co zwraca endpoint?

Publiczne posty konta: filmy widoczne na jego profilu, posty ze zdjęciami i tekstem oraz filmy typu „Only show in ads”, które są wyświetlane jako reklamy i nie pojawiają się na profilu. media_type odróżnia VIDEO od PHOTO, czyli postów ze zdjęciami i tekstem. Posty odfiltrowane przez TikToka za naruszenia, na przykład praw autorskich do muzyki, są pominięte na liście.

Jak go wywołać?

Żądaniem GET z parametrami URL: business_id, fields jako tablica JSON oraz opcjonalnie filters, cursor i max_count, którego wartość domyślna to 10. Token przekazuje się w nagłówku Access-Token, a aplikacja deweloperska potrzebuje uprawnienia Get Account Media w sekcji 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'

Które pola opisują post?

Oprócz metryk, od video_views do impression_sources, lista zawiera te pola, wszystkie w zakresie video.list:

  • item_id: ID posta, używane przez wywołania komentarzy oraz przez filters.video_ids.
  • media_type: VIDEO albo PHOTO dla postu ze zdjęciem lub tekstem.
  • is_ad: czy post jest wykorzystywany w reklamie.
  • create_time: moment publikacji posta jako sekundy Unix w UTC.
  • caption: opis posta razem z hashtagami.
  • share_url: link do udostępniania, który zachowuje się inaczej na telefonie i na komputerze.
  • embed_url: link do odtwarzacza na innych stronach; nie odtwarza postów ustawionych na Friends lub Only you.
  • thumbnail_url: tymczasowy podgląd obrazu, którego wygaśnięcie zależy od parametru x-expires.
  • video_duration: długość w sekundach, z trzema miejscami po przecinku.

Jak wygląda strona wyników?

Tablica videos w kolejności zwróconej przez TikToka, a także cursor, wartość do wysłania przy następnej stronie, oraz has_more, mówiące, czy taka strona istnieje. create_time przychodzi jako ciąg sekund Unix. Przykład TikToka, przycięty do pól opisowych i liczników:

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
  }
}

Jak działa stronicowanie?

Według czasu. cursor domyślnie wskazuje bieżący moment w milisekundach, więc pierwsza strona zawiera najnowsze posty, a każda odpowiedź zwraca cursor do następnego żądania. Przekazuj go, dopóki has_more ma wartość true. Własny znacznik czasu wyświetla posty opublikowane przed tym momentem, a zasady bezpieczeństwa i zaufania TikToka mogą sprawić, że strona będzie krótsza niż max_count, mimo że postów jest jeszcze więcej.

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"]

Jak pobrać konkretne posty?

Za pomocą filters, obiektu JSON: video_ids zawiera listę ID postów do zwrócenia, na przykład post_ids ze statusu publikacji. ad_post_only, ważne tylko obok video_ids, zostawia jedynie posty autoryzowane dla reklamodawców w Spark Ads. Żądanie z filtrem przyjmuje te same pola co każde inne, więc jedno wywołanie może zwrócić najnowsze liczby dla kilku znanych postów.

The filters parameter
filters={"video_ids":["6995316737801538821","8015388216995316737"]}

Jakie obowiązują limity?

Accounts API pozwala na 40 wywołań na minutę dla każdego autoryzowanego konta na tym endpoincie, a wywołania Accounts API aplikacji łącznie dostają 600 na minutę na poziomie Basic i 1,000 powyżej niego. Pola opisowe są aktualne w czasie rzeczywistym, liczniki zwykle opóźniają się o 24 do 48 godzin, a dane posta przestają się aktualizować 365 dni po jego publikacji.

Jak easyCoexistence wyświetla filmy?

Za pomocą list_social_posts, który przyjmuje account_id i opcjonalny limit, od 1 do 20 dla TikToka. Zwraca pierwszą stronę wyników TikToka: najnowsze posty z item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments i shares, a także cursor oraz has_more. Kolejne strony i inne pola pochodzą z własnego kodu, z tokenem i business_id z 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>

Typowe błędy

  • Żądanie pól bez item_id. Dokumentacja TikToka ostrzega, że żądanie nazywające kilka pól bez niego może się nie powieść.
  • Zatrzymywanie się, gdy strona przychodzi niepełna. TikTok może zwrócić mniej niż max_count postów, mimo że has_more nadal ma wartość true, więc trzymaj się has_more.
  • Zapisywanie thumbnail_url na później. To tymczasowy link, który wygasa o czasie zapisanym w parametrze x-expires, więc pobierz świeży, gdy będzie potrzebny.
  • Szukanie prywatnych postów na liście. Endpoint zwraca wyłącznie posty publiczne.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Ile filmów TikToka API może wyświetlić naraz?

Do 20 na stronę z /business/video/list/. max_count określa rozmiar strony i domyślnie wynosi 10; kolejne posty pobierasz przez cursor.

Czy API TikToka wyświetla też posty ze zdjęciami?

Tak. /business/video/list/ zwraca publiczne posty wideo, ze zdjęciami i tekstowe, a media_type odróżnia VIDEO od PHOTO.

Czy lista filmów TikToka obejmuje posty tylko do reklam?

Tak. /business/video/list/ zwraca również filmy „Only show in ads”, które są wyświetlane jako reklamy bez pojawiania się na profilu, a is_ad mówi, czy post jest wykorzystywany w reklamie.

Dlaczego posta brakuje na liście API?

Endpoint wyświetla publiczne posty, a TikTok pomija posty odfiltrowane za naruszenia, na przykład praw autorskich do muzyki.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w