Paano mag-post ng video sa TikTok gamit ang API
Para mag-post ng video sa pamamagitan ng API for Business ng TikTok, magpadala ng POST sa /business/video/publish/ kasama ang business_id ng account, isang video_url mula sa na-verify na domain o URL prefix, at isang post_info object na naglalaman ng caption at mga setting, kasama ang Access-Token header. Sasagot ang TikTok ng share_id; ipasa ito bilang publish_id sa /business/publish/status/ hanggang sa lumabas na PUBLISH_COMPLETE ang status at lumitaw ang post_ids.
Nagpo-post ang easyCoexistence ng mga video sa TikTok gamit ang publish_tiktok_post mula sa Claude, ChatGPT, o sarili ninyong agent: ipasa ang HTTPS link, ang caption, at kung nakabukas ang comments, pagkatapos ay sundan ang post gamit ang get_tiktok_publish_status, habang nakakarating ang file sa TikTok sa pamamagitan ng na-verify nitong media route.
Ibinabalik ng publish call, halimbawa v_pub_url~v1.2345123456789123456, at ipinapasa sa status call bilang publish_id.
Mula noon, tumatanggi na ang TikTok na mag-publish ng video mula sa mga URL na hindi na-verify ang domain o URL prefix.
Limitasyon ng TikTok sa bilang ng video post kada account sa publish endpoint, hanggang 15 kada araw.
Gaano katagal bago lumitaw ang post_ids pagkatapos ng PUBLISH_COMPLETE; sabi ng TikTok, mag-retry pagkalipas ng tatlong minuto.
Ipinapadala sa post.publish.publicly_available webhook kapag lumusot ang post sa moderation, handa nang i-query ang insights nito.
Ano ang kailangan bago ang unang call?
Tatlo po ang kailangan. Isang TikTok account access token at ang open_id ng account, mula sa token exchange; isang developer app na may Video Publish permission sa ilalim ng TikTok Accounts; at ang video sa isang public HTTPS o HTTP URL na nasa domain o URL prefix na na-verify para sa app. Ang TikTok mismo ang nagda-download ng file, kaya dapat itong manatiling ma-access, at inirerekomenda ng TikTok ang URL na tumatagal nang hindi bababa sa 30 minuto.
Ano ang itsura ng publish request?
Isang POST sa https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ na may token ng account sa Access-Token header at Content-Type na nakatakda sa application/json. Ipinapangalan ng JSON body ang account sa business_id, ang file sa video_url, at ang mga setting ng post sa post_info; ang halimbawang ito ay nag-publish ng may caption na video habang nakabukas ang comments, Duet, at Stitch:
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
}
}'Ano ang ginagawa ng bawat field sa body?
Ang mga field na nakalista sa reference ng TikTok para sa video post, mula sa pinakataas na level. Nasa parehong body rin ang cover, ang AI-generated label, lokasyon, drafts, at ang ads-only option:
business_id: angopen_idng account mula sa token exchange.video_url: ang file na dina-download ng TikTok, MP4, MOV, o WebM, sa na-verify na domain o URL prefix.post_info: kinakailangan sa bawat call, kahit bilang walang laman na object, at dito nakalagay ang mga setting ng post.post_info.caption: hanggang 2,200 characters na binibilang sa UTF-16, may #hashtags at hanggang 30 @mentions.post_info.is_brand_organicatis_branded_content: ang mga label na Promotional content at Paid partnership, na minamarkahang kinakailangan ng table ng TikTok.post_info.disable_comment,disable_duet, atdisable_stitch: kapag true, naka-off ang comments, Duet, o Stitch; lahat ng tatlo ay default na false.
Ano ang ibinabalik ng TikTok?
Ang karaniwang envelope, kasama ang ID ng publishing task sa data. Ang code na 0 ay nangangahulugang tinanggap ng TikTok ang task, hindi ibig sabihing live na ang video: kailangan pa ring i-download ng TikTok ang file, suriin ito, at i-moderate ang post. Sa mga halimbawa ng TikTok, nagsisimula ang share_id ng video sa v_pub_url, at ang sa photo post sa p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Paano sinusundan ang post hanggang maging live?
Sa pamamagitan ng GET /business/publish/status/, ipinapasa ang business_id at ang share_id bilang publish_id. Nagbabasa ang status ng PROCESSING_DOWNLOAD habang kinukuha ng TikTok ang file, PUBLISH_COMPLETE kapag lumusot ang post sa moderation, o FAILED kasama ang dahilan. Lumalabas ang post_ids kasabay ng PUBLISH_COMPLETE kapag makikita na ang post sa publiko, at maaaring maantala ng hanggang tatlong minuto. Ang buong daloy sa 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"])
breakPuwede bang palitan ng webhook ang mga status check?
Oo, para sa app na nag-subscribe sa event_type VIDEO gamit ang /business/webhook/update/. Magpapadala ang TikTok ng post.publish.failed o post.publish.complete kapag na-download at nasuri na ang file, post.publish.publicly_available kasama ang bagong post_id kapag lumusot ang moderation, at post.publish.no_longer_publicly_available kung kalaunan ay mawala ang post sa public view. Tinutukoy ng bawat event ang task sa publish_id, na kapareho ng share_id.
Paano mag-post ng video sa pamamagitan ng MCP?
Hilingin lang po sa karaniwang wika mula sa Claude, ChatGPT, o ibang client na konektado sa https://easycoexistence.com/api/mcp. Tatawagin ng assistant ang publish_tiktok_post gamit ang account_id mula sa list_social_accounts, isang HTTPS video_url, ang caption, at, kung gusto ninyong naka-off ang comments, ang disable_comment. Dala ng resulta ang share_id ng TikTok, at ibinabalik ng get_tiktok_publish_status, kapag ibinigay ang account_id at ang share_id na iyon, ang status, post_ids, at reason ng TikTok ayon sa kasalukuyan.
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>"] }Ano ang ipinapadala ng publish_tiktok_post sa TikTok?
Isang tawag sa parehong endpoint, na pinupunan mula sa hiling ninyo. Ipinapadala ang link ninyo sa TikTok bilang signed link sa ilalim ng sariling na-verify na media route ng easyCoexistence, kaya hindi na kailangan ang sariling verification; ipinapadala ang caption at disable_comment gaya ng ibinigay ninyo; at ipinapadala ang is_brand_organic at is_branded_content bilang false. Nananatili sa default ng TikTok ang iba pang setting, gaya ng Duet, Stitch, cover, at AI-generated label, at ipo-post ang video bilang public post, gaya ng pagkakabuo ng endpoint.
Ano ang magagawa gamit ang credentials mula sa Partner API?
Tawagan ang TikTok nang direkta bilang account. Ang GET /channels/{id}?credentials=1 sa https://easycoexistence.com/api/v1, kasama ang inyong ec_live_ key bilang bearer token, ay nagbabalik ng channel na may credentials object: api_base, business_id, kasalukuyang access_token, at token_expires_at. Mula sa sarili ninyong code na tatakbo ang status check, video list, comments, at insights. Ang dapat planuhin ay ang publishing: ipinapasa ng direktang publish call ang video_url sa TikTok nang walang pagbabago, idinadagdag ang URL properties gamit ang sariling ID at secret ng developer app, at ang prefix na na-verify ng app ng easyCoexistence ay ang media route nito, na ginagamit ng publish_tiktok_post.
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>'Paano ito i-set up
- 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.
- 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.
- 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/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- 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.
Mga karaniwang pagkakamali
- Pagkalimot sa post_info. Kinakailangan ito ng TikTok sa bawat call, kahit walang nagbabagong setting.
- Paghahanap ng post ID sa publish response. Share_id lang ang ibinabalik nito; nagmumula ang post ID sa status call o sa publicly_available webhook.
- Pag-ulit ng publish call na nag-time out. Maaaring naabot na ng unang request ang TikTok, kaya tingnan muna ang pinakabagong post ng account bago ito ipadala muli.
- Pagturing sa code 0 bilang live na video. Ibig sabihin lang nito na tinanggap ng TikTok ang task, at maaari pa ring bumagsak ang file sa mga pagsusuri nito pagkatapos ng download.
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at kasama ang free trial na 3 araw.
Mga madalas itanong
Aling endpoint ang nagpo-post ng video sa TikTok?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, na may token ng account sa Access-Token header at business_id, video_url, at post_info sa JSON body.
Puwede bang mag-upload ng video file nang direkta ang TikTok API?
Hindi sa /business/video/publish/. Kumukuha ito ng video_url at dina-download ang file mula roon, kaya kailangang may URL ang video sa na-verify na domain o URL prefix.
Paano makukuha ang ID ng video na na-publish sa pamamagitan ng API?
Mula sa post_ids sa /business/publish/status/ kapag PUBLISH_COMPLETE na ang status at public na ang post, o mula sa post_id sa post.publish.publicly_available webhook.
Puwede bang i-schedule ang video sa TikTok para sa ibang oras gamit ang API?
Nagpo-post ang publish endpoint sa sandaling tawagin ito at walang time field. Hawak ng easyCoexistence ang mga naka-schedule na post sa sarili nitong queue at tumatawag sa TikTok sa oras na itinakda ninyo.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong