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.
Maksymalna liczba postów na stronę, jaką zwraca /business/video/list/; max_count domyślnie wynosi 10.
Jednostką kursora jest sygnatura czasowa Unix w UTC; endpoint zwraca posty opublikowane przed nią.
Pole domyślne, które musi znaleźć się w żądaniu z kilkoma wskazanymi polami, inaczej może wystąpić błąd.
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:
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:
{
"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.
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.
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:
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.
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