Videos eines TikTok-Kontos über die API auflisten
Die API for Business von TikTok listet die öffentlichen Beiträge eines Kontos mit GET /business/video/list/ auf, beginnend mit den neuesten, bis zu 20 pro Seite. Nennen Sie die zurückzugebenden Felder, etwa item_id, caption, share_url und video_views, und blättern Sie mit cursor weiter, solange has_more true ist. filters.video_ids wählt bestimmte Beiträge aus, und jede item_id ist die ID, die Kommentar-Aufrufe entgegennehmen.
easyCoexistence listet die neuesten Beiträge eines TikTok-Kontos mit list_social_posts von Claude, ChatGPT oder Ihrem eigenen Code auf, mit item_id, caption, Link und Zählwerten jedes Beitrags.
Höchstens Beiträge pro Seite liefert /business/video/list/; max_count ist standardmäßig 10.
Die Einheit von cursor ist ein UTC-Unix-Zeitstempel; der Endpoint liefert Beiträge, die davor veröffentlicht wurden.
Das Standardfeld muss eine Anfrage mit mehreren Feldern enthalten, sonst kann ein Fehler auftreten.
Zulässige Aufrufe pro autorisiertem Konto für diesen Endpoint, wie bei jedem Endpoint der Accounts API.
Was liefert der Endpoint zurück?
Die öffentlichen Beiträge des Kontos: Videos auf seinem Profil, Foto- und Textbeiträge sowie Videos mit „Only show in ads“, die als Anzeigen laufen, ohne auf dem Profil zu erscheinen. media_type unterscheidet VIDEO von PHOTO, was Foto- und Textbeiträge umfasst. Beiträge, die TikTok wegen Verstößen gefiltert hat, etwa wegen Musikurheberrecht, fehlen in der Liste.
Wie rufen Sie ihn auf?
Mit einem GET und URL-Parametern: business_id, fields als JSON-Array und optional filters, cursor und max_count, das standardmäßig 10 beträgt. Das Token steht im Header Access-Token, und die Entwickler-App braucht die Berechtigung Get Account Media unter 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'Welche Felder beschreiben einen Beitrag?
Neben den Kennzahlen, die von video_views bis impression_sources reichen, enthält die Liste diese Felder, alle unter dem Scope video.list:
item_id: die ID des Beitrags, die von Kommentar-Aufrufen und von filters.video_idsverwendet wird.media_type: VIDEO oder PHOTO für einen Foto- oder Textbeitrag.is_ad: ob der Beitrag in einer Anzeige verwendet wird.create_time: wann der Beitrag veröffentlicht wurde, als Unix-Sekunden in UTC.- caption: die Beschreibung des Beitrags, einschließlich Hashtags.
share_url: ein teilbarer Link, der sich auf Mobilgeräten und am Desktop unterschiedlich verhält.embed_url: ein Player-Link für andere Websites, der Beiträge nicht abspielt, die auf Freunde oder Nur ich gesetzt sind.thumbnail_url: ein temporäres Vorschaubild, dessen Ablauf im Parameter x-expires steht.video_duration: die Länge in Sekunden, auf drei Dezimalstellen genau.
Wie sieht eine Seite mit Ergebnissen aus?
Ein Array videos in der Reihenfolge, die TikTok liefert, dazu cursor, der Wert für die nächste Seite, und has_more, das angibt, ob es eine gibt. create_time kommt als Zeichenkette mit Unix-Sekunden an. Das Beispiel von TikTok, gekürzt auf die beschreibenden Felder und die Zählwerte:
{
"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
}
}Wie funktioniert die Paginierung?
Nach Zeit. cursor ist standardmäßig der aktuelle Zeitpunkt in Millisekunden, sodass die erste Seite die neuesten Beiträge enthält, und jede Antwort liefert den cursor für die nächste Anfrage. Übergeben Sie ihn, solange has_more true ist. Ein eigener Zeitstempel listet die Beiträge, die davor veröffentlicht wurden, und die Trust-and-Safety-Regeln von TikTok können eine Seite kürzer machen als max_count, selbst wenn noch Beiträge übrig sind.
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"]Wie rufen Sie bestimmte Beiträge ab?
Mit filters, einem JSON-Objekt: video_ids listet die IDs der Beiträge auf, die zurückgegeben werden sollen, etwa die post_ids aus einem Veröffentlichungsstatus. ad_post_only, nur gültig zusammen mit video_ids, behält nur die Beiträge, die für Spark Ads für Werbetreibende freigegeben sind. Eine gefilterte Anfrage akzeptiert dieselben Felder wie jede andere, sodass ein einziger Aufruf die neuesten Werte für eine Handvoll bekannter Beiträge liefern kann.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Welche Limits gelten?
Die Accounts API erlaubt 40 Aufrufe pro Minute für jedes autorisierte Konto an diesem Endpoint, und die Accounts-API-Aufrufe einer App werden insgesamt mit 600 pro Minute auf der Basisstufe und 1,000 darüber begrenzt. Beschreibende Felder sind in Echtzeit, Zählwerte hinken meist 24 bis 48 Stunden hinterher, und die Daten eines Beitrags werden 365 Tage nach seiner Veröffentlichung nicht mehr aktualisiert.
Wie listet easyCoexistence die Videos auf?
Mit list_social_posts, das account_id und optional limit entgegennimmt, für TikTok von 1 bis 20. Es liefert die erste Seite von TikTok: die neuesten Beiträge mit item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments und shares sowie cursor und has_more. Weitere Seiten und andere Felder kommen aus Ihrem eigenen Code, mit dem Token und der business_id aus 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>Häufige Fehler
- Felder anfordern, ohne item_id. Die Referenz von TikTok warnt, dass eine Anfrage mit mehreren Feldern ohne sie fehlschlagen kann.
- Abbrechen, sobald eine Seite zu kurz ausfällt. TikTok kann weniger als max_count Beiträge liefern, während has_more noch true ist. Folgen Sie deshalb has_more.
- thumbnail_url für später speichern. Es ist ein temporärer Link, der zu der Zeit in seinem Parameter x-expires abläuft. Holen Sie bei Bedarf einen neuen.
- In der Liste nach privaten Beiträgen suchen. Der Endpoint liefert nur öffentliche Beiträge.
Für weitere Seiten und andere Felder gibt get_social_credentials Ihrem eigenen Code das Token. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Wie viele TikTok-Videos kann die API auf einmal auflisten?
Bis zu 20 pro Seite über /business/video/list/. max_count legt die Seitengröße fest und ist standardmäßig 10; folgen Sie cursor für weitere.
Listet die TikTok-API auch Fotobeiträge auf?
Ja. /business/video/list/ liefert öffentliche Video-, Foto- und Textbeiträge, und media_type unterscheidet VIDEO von PHOTO.
Enthält die TikTok-Videoliste auch Beiträge nur für Anzeigen?
Ja. /business/video/list/ liefert auch Videos mit „Only show in ads“, die als Anzeigen laufen, ohne auf dem Profil zu erscheinen, und is_ad zeigt, ob ein Beitrag in einer Anzeige verwendet wird.
Warum fehlt ein TikTok-Beitrag in der API-Liste?
Der Endpoint listet öffentliche Beiträge, und TikTok lässt Beiträge weg, die wegen Verstößen wie Musikurheberrecht gefiltert wurden.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am