Mengambil daftar video akun TikTok melalui API
API for Business TikTok mengambil postingan publik sebuah akun dengan GET /business/video/list/, dimulai dari yang terbaru, hingga 20 per halaman. Sebutkan field yang ingin dikembalikan, seperti item_id, caption, share_url dan video_views, lalu telusuri halaman dengan cursor selama has_more bernilai true. filters.video_ids memilih postingan tertentu, dan setiap item_id adalah ID yang dipakai panggilan komentar tersebut.
easyCoexistence menampilkan postingan terbaru akun TikTok dengan list_social_posts dari Claude, ChatGPT, atau kode Anda sendiri, lengkap dengan item_id, caption, tautan, dan angka tiap postingan, dan get_social_credentials memberi kode Anda sendiri token untuk halaman berikutnya dan field lainnya.
Jumlah postingan maksimum yang dikembalikan /business/video/list/ per halaman; max_count default-nya 10.
Satuan cursor adalah timestamp Unix UTC; endpoint mengembalikan postingan yang diterbitkan sebelum waktu tersebut.
Field default, yang harus disertakan jika permintaan menyebut beberapa field, atau kesalahan dapat terjadi.
Jumlah panggilan yang diizinkan per akun yang telah diotorisasi pada endpoint ini, sama seperti setiap endpoint Accounts API.
Apa yang dikembalikan endpoint ini?
Postingan publik akun: video yang tampil di profilnya, postingan foto dan teks, serta video Only show in ads, yang tayang sebagai iklan tanpa muncul di profil. media_type membedakan VIDEO dari PHOTO, yang mencakup postingan foto dan teks. Postingan yang disaring TikTok karena pelanggaran, misalnya hak cipta musik, tidak masuk dalam daftar.
Bagaimana cara memanggilnya?
Dengan GET dan parameter URL: business_id, fields sebagai array JSON, dan opsional filters, cursor serta max_count, yang default-nya 10. Token dikirim di header Access-Token, dan aplikasi developer memerlukan izin Get Account Media di bawah 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'Field apa saja yang menggambarkan postingan?
Selain metrik, yang berkisar dari video_views hingga impression_sources, daftar ini memuat field berikut, semuanya di bawah scope video.list:
item_id: ID postingan, dipakai oleh panggilan komentar dan oleh filters.video_ids.media_type: VIDEO, atau PHOTO untuk postingan foto atau teks.is_ad: apakah postingan sedang dipakai dalam iklan.create_time: waktu postingan diterbitkan, dalam detik Unix UTC.- caption: deskripsi postingan, termasuk hashtag.
share_url: tautan yang bisa dibagikan, yang berperilaku berbeda di seluler dan desktop.embed_url: tautan pemutar untuk situs lain, yang tidak dapat diputar untuk postingan yang diatur ke Friends atau Only you.thumbnail_url: gambar pratinjau sementara yang masa berlakunya ada di parameter x-expires.video_duration: durasi dalam detik, hingga tiga desimal.
Seperti apa satu halaman hasil?
Array videos sesuai urutan yang dikembalikan TikTok, ditambah cursor, nilai yang dikirim untuk halaman berikutnya, dan has_more, yang menyatakan apakah ada halaman berikutnya. create_time tiba sebagai string detik Unix. Contoh dari TikTok, dipangkas hanya ke field deskriptif dan jumlah:
{
"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
}
}Bagaimana paginasi bekerja?
Berdasarkan waktu. cursor default-nya adalah momen saat ini dalam milidetik, sehingga halaman pertama berisi postingan terbaru, dan setiap respons mengembalikan cursor untuk permintaan berikutnya. Kirimkan selama has_more bernilai true. Timestamp kustom menampilkan postingan yang diterbitkan sebelum momen itu, dan aturan kepercayaan dan keamanan TikTok dapat membuat halaman lebih pendek dari max_count meskipun masih ada postingan.
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"]Bagaimana cara mengambil postingan tertentu?
Dengan filters, berupa objek JSON: video_ids berisi daftar ID postingan yang akan dikembalikan, misalnya post_ids dari status publikasi. ad_post_only, yang hanya berlaku bersama video_ids, menyaring hanya postingan yang diotorisasi untuk pengiklan dalam Spark Ads. Permintaan yang difilter menerima field yang sama seperti permintaan lain, sehingga satu panggilan dapat mengembalikan angka terbaru untuk beberapa postingan yang sudah diketahui.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Batasan apa yang berlaku?
Accounts API mengizinkan 40 panggilan per menit untuk setiap akun yang telah diotorisasi pada endpoint ini, dan total panggilan Accounts API sebuah aplikasi mendapat 600 per menit di tingkat Basic dan 1,000 di atasnya. Field deskriptif bersifat waktu nyata, sedangkan angka biasanya tertinggal 24 hingga 48 jam, dan data postingan berhenti diperbarui 365 hari setelah diterbitkan.
Bagaimana easyCoexistence menampilkan daftar video?
Dengan list_social_posts, yang menerima account_id dan limit opsional, dari 1 hingga 20 untuk TikTok. Hasilnya adalah halaman pertama dari TikTok: postingan terbaru dengan item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments dan shares, ditambah cursor dan has_more. Halaman berikutnya dan field lainnya berasal dari kode Anda sendiri, dengan token dan business_id dari 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>Kesalahan umum
- Meminta field tanpa item_id. Referensi TikTok memperingatkan bahwa permintaan yang menyebut beberapa field tanpanya dapat gagal.
- Berhenti ketika sebuah halaman kembali lebih pendek. TikTok dapat mengembalikan kurang dari max_count postingan selagi has_more masih true, jadi ikuti has_more.
- Menyimpan thumbnail_url untuk nanti. Itu tautan sementara yang kedaluwarsa pada waktu di parameter x-expires, jadi ambil yang baru saat dibutuhkan.
- Mencari postingan privat dalam daftar. Endpoint hanya mengembalikan postingan publik.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Berapa banyak video TikTok yang bisa dicantumkan API sekaligus?
Hingga 20 per halaman dari /business/video/list/. max_count menentukan ukuran halaman dan default-nya 10; ikuti cursor untuk data selanjutnya.
Apakah TikTok API juga mencantumkan postingan foto?
Ya. /business/video/list/ mengembalikan postingan publik berupa video, foto, dan teks, dan media_type membedakan VIDEO dari PHOTO.
Apakah daftar video TikTok menyertakan postingan khusus iklan?
Ya. /business/video/list/ juga mengembalikan video Only show in ads, yang tayang sebagai iklan tanpa muncul di profil, dan is_ad menyatakan apakah sebuah postingan sedang dipakai dalam iklan.
Mengapa postingan TikTok tidak ada dalam daftar API?
Endpoint hanya mencantumkan postingan publik, dan TikTok menghilangkan postingan yang disaring karena pelanggaran seperti hak cipta musik.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada