MasukMulai uji coba gratis
easyCoexistence API resmi

Cara memposting video ke TikTok melalui API

Untuk memposting video lewat API for Business TikTok, kirim POST /business/video/publish/ dengan business_id akun, video_url pada domain atau awalan URL yang terverifikasi, dan objek post_info yang berisi caption dan pengaturan, beserta header Access-Token. TikTok membalas dengan share_id; teruskan sebagai publish_id ke /business/publish/status/ hingga status bertuliskan PUBLISH_COMPLETE dan post_ids muncul.

easyCoexistence memposting video TikTok dengan publish_tiktok_post dari Claude, ChatGPT, atau agen Anda sendiri: berikan tautan HTTPS, caption, dan apakah komentar aktif, lalu pantau postingan dengan get_tiktok_publish_status, sementara file sampai ke TikTok melalui rute media terverifikasinya.

share_id

Dikembalikan oleh panggilan publish, misalnya v_pub_url~v1.2345123456789123456, dan diteruskan ke panggilan status sebagai publish_id.

Nov 16, 2023

Sejak itu, TikTok menolak memublikasikan video dari URL yang domain atau awalan URL-nya belum terverifikasi.

6 a minute

Batas TikTok untuk postingan video per akun melalui endpoint publish, dengan paling banyak 15 per hari.

3 min

Berapa lama post_ids bisa muncul setelah PUBLISH_COMPLETE; TikTok menyarankan untuk mencoba kembali setelah tiga menit.

post_id

Dikirim dalam webhook post.publish.publicly_available setelah postingan lolos moderasi, siap untuk di-query insight-nya.

Apa yang dibutuhkan sebelum panggilan pertama?

Tiga hal. Access token akun TikTok dan open_id akun, dari pertukaran token; aplikasi developer yang memiliki izin Video Publish di bawah TikTok Accounts; dan video di URL HTTPS atau HTTP publik yang berada di bawah domain atau awalan URL yang terverifikasi untuk aplikasi. TikTok mengunduh file itu sendiri, jadi file harus tetap bisa diakses, dan TikTok menyarankan URL yang aktif minimal 30 menit.

Seperti apa permintaan publish?

Sebuah POST ke https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ dengan token akun di header Access-Token dan Content-Type diatur ke application/json. Body JSON menyebutkan akun di business_id, file di video_url, dan pengaturan postingan di post_info; contoh ini memublikasikan video dengan caption dan komentar, Duet, serta Stitch tetap aktif:

Publish a video with curl
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

Apa fungsi setiap field body?

Field yang tercantum di referensi TikTok untuk postingan video, dimulai dari level teratas. Cover, label yang dibuat AI, lokasi, draf, dan opsi khusus iklan juga berada di body yang sama:

  • business_id: open_id akun dari pertukaran token.
  • video_url: file yang diunduh TikTok, MP4, MOV, atau WebM, pada domain atau awalan URL yang terverifikasi.
  • post_info: wajib pada setiap panggilan, meski hanya berupa objek kosong, dan menjadi tempat pengaturan postingan.
  • post_info.caption: hingga 2,200 karakter dihitung dalam UTF-16, dengan #hashtag dan hingga 30 @mention.
  • post_info.is_brand_organic dan is_branded_content: label Promotional content dan Paid partnership, yang oleh tabel TikTok ditandai wajib.
  • post_info.disable_comment, disable_duet, dan disable_stitch: true mematikan komentar, Duet, atau Stitch; ketiganya default ke false.

Apa yang dikembalikan TikTok?

Respons standar, dengan ID tugas publikasi di data. Kode 0 berarti TikTok menerima tugas, bukan bahwa video sudah tayang: TikTok masih harus mengunduh file, memeriksanya, dan memoderasi postingan. Dalam contoh TikTok, share_id video diawali v_pub_url dan share_id postingan foto diawali p_pub_url.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

Bagaimana memantau postingan sampai tayang?

Dengan GET /business/publish/status/, meneruskan business_id dan share_id sebagai publish_id. status menunjukkan PROCESSING_DOWNLOAD selama TikTok mengambil file, PUBLISH_COMPLETE setelah postingan lolos moderasi, atau FAILED beserta alasannya. post_ids muncul bersama PUBLISH_COMPLETE saat postingan dapat dilihat publik, dan bisa tertinggal hingga tiga menit. Seluruh alur dalam Python:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

Bisakah webhook menggantikan pemeriksaan status?

Bisa, untuk aplikasi yang berlangganan event_type VIDEO dengan /business/webhook/update/. TikTok kemudian mengirim post.publish.failed atau post.publish.complete setelah mengunduh dan memeriksa file, post.publish.publicly_available dengan post_id baru setelah moderasi lolos, dan post.publish.no_longer_publicly_available jika postingan kemudian tidak lagi tampil publik. Setiap event menyebut tugas di publish_id, nilai yang sama dengan share_id.

Bagaimana memposting video lewat MCP?

Minta dengan bahasa biasa dari Claude, ChatGPT, atau klien lain yang terhubung ke https://easycoexistence.com/api/mcp. Asisten memanggil publish_tiktok_post dengan account_id dari list_social_accounts, video_url HTTPS, caption, dan, jika ingin komentar dimatikan, disable_comment. Hasilnya memuat share_id dari TikTok, dan get_tiktok_publish_status, dengan account_id dan share_id tersebut, mengembalikan status, post_ids, dan reason dari TikTok apa adanya.

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

Apa yang dikirim publish_tiktok_post ke TikTok?

Panggilan ke endpoint yang sama, diisi dari permintaan Anda. Tautan Anda dikirim ke TikTok sebagai tautan bertanda tangan melalui rute media terverifikasi milik easyCoexistence sendiri, sehingga tidak memerlukan verifikasi tersendiri; caption dan disable_comment dikirim sesuai yang Anda berikan; dan is_brand_organic serta is_branded_content dikirim sebagai false. Pengaturan lain, seperti Duet, Stitch, cover, dan label yang dibuat AI, tetap memakai default TikTok, dan video dipublikasikan sebagai postingan publik, sesuai cara endpoint dibangun.

Apa yang bisa dilakukan dengan kredensial dari Partner API?

Memanggil TikTok langsung sebagai akun tersebut. GET /channels/{id}?credentials=1 pada https://easycoexistence.com/api/v1, dengan kunci ec_live_ Anda sebagai bearer token, mengembalikan channel dengan objek credentials: api_base, business_id, access_token yang berlaku, dan token_expires_at. Pemeriksaan status, daftar video, komentar, dan insight kemudian berjalan dari kode Anda sendiri. Publikasi adalah bagian yang perlu direncanakan: panggilan publish langsung meneruskan video_url ke TikTok apa adanya, properti URL ditambahkan dengan ID dan rahasia aplikasi developer sendiri, dan awalan yang telah diverifikasi aplikasi easyCoexistence adalah rute media-nya, yang digunakan publish_tiktok_post.

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

Cara mengonfigurasi

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

Kesalahan umum

  • Melewatkan post_info. TikTok mewajibkan objek ini pada setiap panggilan, meski tidak ada pengaturan yang berubah.
  • Mencari ID postingan di respons publish. Respons hanya berisi share_id; ID postingan berasal dari panggilan status atau webhook publicly_available.
  • Mengulangi panggilan publish yang kehabisan waktu. Permintaan pertama mungkin sudah sampai ke TikTok, jadi periksa postingan terbaru akun sebelum mengirimnya lagi.
  • Menganggap kode 0 sebagai video yang sudah tayang. Itu berarti TikTok menerima tugas, dan file tetap bisa gagal pemeriksaan setelah diunduh.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Endpoint mana yang memposting video ke TikTok?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, dengan token akun di header Access-Token dan business_id, video_url, serta post_info di body JSON.

Bisakah TikTok API mengunggah file video langsung?

Tidak melalui /business/video/publish/. Endpoint ini menerima video_url dan mengambil file dari sana, sehingga video memerlukan URL pada domain atau awalan URL yang terverifikasi.

Bagaimana cara mendapatkan ID video yang dipublikasikan lewat API?

Dari post_ids di /business/publish/status/ setelah status PUBLISH_COMPLETE dan postingan bersifat publik, atau dari post_id di webhook post.publish.publicly_available.

Bisakah saya menjadwalkan video TikTok untuk nanti lewat API?

Endpoint publish memposting saat dipanggil dan tidak memiliki field waktu. easyCoexistence menyimpan postingan terjadwal di antrean sendiri dan memanggil TikTok pada waktu yang Anda atur.

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