Menyenaraikan video akaun TikTok melalui API
API untuk Perniagaan TikTok menyenaraikan siaran awam akaun dengan GET /business/video/list/, bermula dari yang terbaru, sehingga 20 setiap halaman. Namakan medan yang hendak dikembalikan, seperti item_id, caption, share_url dan video_views, dan halaman demi halaman gunakan cursor selagi has_more bernilai true. filters.video_ids memilih siaran tertentu, dan setiap item_id ialah ID yang digunakan oleh panggilan komen.
easyCoexistence menyenaraikan siaran terkini akaun TikTok dengan list_social_posts daripada Claude, ChatGPT atau kod anda sendiri, dengan item_id, caption, pautan dan kiraan setiap siaran, dan get_social_credentials memberi kod anda sendiri token bagi halaman seterusnya serta medan lain.
Kebanyakan siaran yang dikembalikan oleh /business/video/list/ setiap halaman; max_count lalai kepada 10.
Unit kursor ialah cap masa Unix UTC; endpoint mengembalikan siaran yang diterbitkan sebelum masa itu.
Medan lalai, yang mesti disertakan dalam permintaan yang menamakan beberapa medan, jika tidak ralat boleh berlaku.
Panggilan dibenarkan bagi setiap akaun yang diberi kuasa pada endpoint ini, sama seperti setiap endpoint Accounts API.
Apakah yang dikembalikan oleh endpoint?
Siaran awam akaun: video yang dipaparkan pada profilnya, siaran foto dan teks, serta video Only show in ads, yang berjalan sebagai iklan tanpa muncul pada profil. media_type membezakan VIDEO daripada PHOTO, yang merangkumi siaran foto dan teks. Siaran yang ditapis oleh TikTok kerana pelanggaran, seperti hak cipta muzik, tidak dimasukkan dalam senarai.
Bagaimana anda memanggilnya?
Dengan GET dan parameter URL: business_id, fields sebagai tatasusunan JSON, dan secara pilihan filters, cursor dan max_count, yang lalai kepada 10. Token dimasukkan dalam header Access-Token, dan aplikasi pembangun memerlukan kebenaran 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'Medan mana yang menerangkan siaran?
Selain metrik, yang merentang dari video_views hingga impression_sources, senarai ini membawa medan berikut, semuanya di bawah skop video.list:
item_id: ID siaran, digunakan oleh panggilan komen dan oleh filters.video_ids.media_type: VIDEO, atau PHOTO bagi siaran foto atau teks.is_ad: sama ada siaran sedang digunakan dalam iklan.create_time: bila siaran diterbitkan, sebagai saat Unix dalam UTC.- caption: penerangan siaran, termasuk hashtag.
share_url: pautan untuk dikongsi, yang berkelakuan berbeza pada telefon bimbit dan desktop.embed_url: pautan pemain untuk laman lain, yang tidak dimainkan bagi siaran yang ditetapkan kepada Friends atau Only you.thumbnail_url: imej pratonton sementara yang tarikh luputnya terdapat dalam parameter x-expires.video_duration: panjang dalam saat, hingga tiga titik perpuluhan.
Bagaimana rupa satu halaman hasil?
Tatasusunan videos mengikut susunan TikTok mengembalikannya, ditambah cursor, iaitu nilai yang dihantar untuk halaman seterusnya, dan has_more, yang menyatakan sama ada ada satu lagi. create_time tiba sebagai rentetan saat Unix. Contoh TikTok, dipangkas kepada medan deskriptif dan kiraan:
{
"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 penomboran berfungsi?
Mengikut masa. cursor lalai kepada saat semasa dalam milisaat, jadi halaman pertama memegang siaran terbaru, dan setiap respons mengembalikan cursor untuk permintaan seterusnya. Hantarkannya selagi has_more bernilai true. Cap masa tersuai menyenaraikan siaran yang diterbitkan sebelum masa itu, dan peraturan keselamatan dan kepercayaan TikTok boleh menjadikan halaman lebih pendek daripada max_count walaupun masih ada siaran lain.
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 anda mengambil siaran tertentu?
Dengan filters, objek JSON: video_ids menyenaraikan ID siaran yang hendak dikembalikan, seperti post_ids daripada status penerbitan. ad_post_only, yang hanya sah bersama video_ids, mengekalkan hanya siaran yang diberi kuasa kepada pengiklan untuk Spark Ads. Permintaan yang ditapis mengambil medan yang sama seperti yang lain, jadi satu panggilan boleh mengembalikan nombor terkini bagi beberapa siaran yang diketahui.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Apakah had yang terpakai?
Accounts API membenarkan 40 panggilan seminit bagi setiap akaun yang diberi kuasa pada endpoint ini, dan panggilan Accounts API sesebuah aplikasi berjumlah 600 seminit pada tahap Basic dan 1,000 ke atas. Medan deskriptif adalah masa nyata, kiraan biasanya lewat 24 hingga 48 jam, dan data siaran berhenti dikemas kini 365 hari selepas ia diterbitkan.
Bagaimana easyCoexistence menyenaraikan video?
Dengan list_social_posts, yang mengambil account_id dan limit pilihan, dari 1 hingga 20 bagi TikTok. Ia mengembalikan halaman pertama TikTok: siaran paling terkini dengan item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments dan shares, serta cursor dan has_more. Halaman seterusnya dan medan lain datang daripada kod anda sendiri, dengan token dan business_id daripada 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>Kesilapan biasa
- Meminta medan tanpa item_id. Rujukan TikTok memberi amaran bahawa permintaan yang menamakan beberapa medan tanpanya mungkin gagal.
- Berhenti apabila halaman dikembalikan pendek. TikTok boleh mengembalikan kurang daripada max_count siaran walaupun has_more masih true, jadi ikut has_more sebagai gantinya.
- Menyimpan thumbnail_url untuk kemudian. Ia pautan sementara yang luput pada masa dalam parameter x-expires, jadi dapatkan yang baharu apabila diperlukan.
- Mencari siaran peribadi dalam senarai. Endpoint hanya mengembalikan siaran awam.
US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.
Soalan lazim
Berapa banyak video TikTok yang boleh API senaraikan sekali gus?
Sehingga 20 sehalaman daripada /business/video/list/. max_count menetapkan saiz halaman dan lalai kepada 10; ikut cursor untuk lebih banyak.
Adakah API TikTok turut menyenaraikan siaran foto?
Ya. /business/video/list/ mengembalikan siaran video, foto dan teks awam, dan media_type membezakan VIDEO daripada PHOTO.
Adakah senarai video TikTok merangkumi siaran hanya-iklan?
Ya. /business/video/list/ turut mengembalikan video Only show in ads, yang berjalan sebagai iklan tanpa muncul pada profil, dan is_ad menyatakan sama ada siaran sedang digunakan dalam iklan.
Mengapa siaran TikTok tiada dalam senarai API?
Endpoint hanya menyenaraikan siaran awam, dan TikTok meninggalkan siaran yang ditapis kerana pelanggaran seperti hak cipta muzik.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada