Jinsi ya kuchapisha video kwenye TikTok kupitia API
Ili kuchapisha video kupitia API for Business ya TikTok, tuma POST /business/video/publish/ ikiwa na business_id ya akaunti, video_url kwenye domeni au kiambishi cha URL kilichothibitishwa, na kitu cha post_info chenye maelezo na mipangilio, pamoja na kichwa cha Access-Token. TikTok inajibu kwa share_id; ipeleke kama publish_id kwa /business/publish/status/ hadi hali isome PUBLISH_COMPLETE na post_ids zionekane.
easyCoexistence huchapisha video za TikTok kwa publish_tiktok_post kutoka Claude, ChatGPT au agent yako mwenyewe: pitisha kiungo cha HTTPS, maelezo na kama maoni yamewashwa, kisha fuatilia chapisho kwa get_tiktok_publish_status, huku faili likifika TikTok kupitia njia yake ya midia iliyothibitishwa.
Inarudishwa na ombi la kuchapisha, mfano v_pub_url~v1.2345123456789123456, na kupelekwa kwenye ombi la hali kama publish_id.
Tangu hapo, TikTok hukataa kuchapisha video kutoka URL ambazo domeni au kiambishi chake hakijathibitishwa.
Kikomo cha TikTok cha machapisho ya video kwa akaunti kupitia endpoint ya kuchapisha, yasiyozidi 15 kwa siku.
Muda ambao post_ids zinaweza kuchukua kuonekana baada ya PUBLISH_COMPLETE; TikTok inasema ujaribu tena baada ya dakika tatu.
Hutumwa kwenye webhook ya post.publish.publicly_available chapisho likipita uhakiki, tayari kwa kuuliza takwimu zake.
Unahitaji nini kabla ya ombi la kwanza?
Vitu vitatu. Access token ya akaunti ya TikTok na open_id ya akaunti, kutoka kubadilishana kwa token; developer app yenye ruhusa ya Video Publish chini ya TikTok Accounts; na video kwenye URL ya umma ya HTTPS au HTTP iliyo chini ya domeni au kiambishi cha URL kilichothibitishwa kwa app. TikTok hupakua faili yenyewe, kwa hiyo lazima ibaki inafikika, na TikTok inapendekeza URL inayodumu angalau dakika 30.
Ombi la kuchapisha linaonekanaje?
POST kwenda https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ ikiwa na token ya akaunti kwenye kichwa cha Access-Token na Content-Type ikiwekwa application/json. Mwili wa JSON unataja akaunti kwenye business_id, faili kwenye video_url, na mipangilio ya chapisho kwenye post_info; mfano huu unachapisha video yenye maelezo huku maoni, Duet na Stitch vikiwa vimewashwa:
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
}
}'Kila sehemu ya mwili wa ombi inafanya nini?
Sehemu zinazoorodheshwa na rejea ya TikTok kwa chapisho la video, kuanzia ya juu. Jalada, lebo ya AI, eneo, rasimu na chaguo la matangazo pekee pia viko kwenye mwili huo huo:
business_id:open_idya akaunti kutoka kubadilishana kwa token.video_url: faili ambalo TikTok hupakua, MP4, MOV au WebM, kwenye domeni au kiambishi cha URL kilichothibitishwa.post_info: inahitajika kwenye kila ombi, hata kama kitu tupu, na ndiko mipangilio ya chapisho ilipo.post_info.caption: hadi herufi 2,200 zinazohesabiwa kwa UTF-16, pamoja na #hashtags na hadi @mentions 30.post_info.is_brand_organicnais_branded_content: lebo za Maudhui ya kutangaza na Ushirikiano wa kulipwa, ambazo jedwali la TikTok linaweka kama lazima.post_info.disable_comment,disable_duetnadisable_stitch: true huzima maoni, Duet au Stitch; zote tatu zina thamani chaguo-msingi false.
TikTok inarudisha nini?
Bahasha ya kawaida, yenye ID ya kazi ya kuchapisha kwenye data. Msimbo 0 unamaanisha TikTok imekubali kazi, si kwamba video iko hewani: TikTok bado inapaswa kupakua faili, kuikagua na kuhakiki chapisho. Katika mifano ya TikTok, share_id ya video huanza na v_pub_url na ya chapisho la picha na p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Unafuatiliaje chapisho hadi liwe hewani?
Kwa GET /business/publish/status/, ukipitisha business_id na share_id kama publish_id. status husoma PROCESSING_DOWNLOAD TikTok inapopakua faili, PUBLISH_COMPLETE chapisho likishapita uhakiki, au FAILED pamoja na sababu. post_ids hufika pamoja na PUBLISH_COMPLETE chapisho likiwa linaonekana hadharani, na linaweza kuchelewa hadi dakika tatu. Mtiririko mzima kwa 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"])
breakJe, webhook inaweza kuchukua nafasi ya ukaguzi wa hali?
Ndiyo, kwa programu inayojisajili event_type VIDEO kwa /business/webhook/update/. TikTok kisha hutuma post.publish.failed au post.publish.complete baada ya kupakua na kukagua faili, post.publish.publicly_available pamoja na post_id mpya chapisho likipita uhakiki, na post.publish.no_longer_publicly_available chapisho likiacha kuonekana hadharani baadaye. Kila tukio linataja kazi kwenye publish_id, thamani sawa na share_id.
Unachapishaje video kupitia MCP?
Omba kwa maneno ya kawaida kutoka Claude, ChatGPT au mteja mwingine aliyeunganishwa na https://easycoexistence.com/api/mcp. Msaidizi huita publish_tiktok_post kwa account_id kutoka list_social_accounts, video_url ya HTTPS, maelezo na, ukitaka maoni yazimwe, disable_comment. Matokeo yana share_id ya TikTok, na get_tiktok_publish_status, ikipewa account_id na share_id hiyo, inarudisha hali, post_ids na reason ya TikTok kama zilivyo.
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>"] }publish_tiktok_post inatuma nini kwa TikTok?
Ombi la endpoint hiyo hiyo, likijazwa kutoka ombi lako. Kiungo chako kinakwenda TikTok kama kiungo kilichosainiwa kupitia njia ya midia iliyothibitishwa ya easyCoexistence yenyewe, kwa hiyo hakihitaji uthibitishaji wake; caption na disable_comment zinakwenda kama ulivyoweka; na is_brand_organic na is_branded_content zinakwenda kama false. Mipangilio mingine, kama Duet, Stitch, jalada na lebo ya AI, inabaki na chaguo-msingi za TikTok, na video inachapishwa kama chapisho la umma, kama endpoint ilivyojengwa kufanya.
Unaweza kufanya nini ukiwa na credentials kutoka Partner API?
Kuita TikTok moja kwa moja kama akaunti. GET /channels/{id}?credentials=1 kwenye https://easycoexistence.com/api/v1, ukiwa na ufunguo wako ec_live_ kama bearer token, inarudisha channel pamoja na kitu cha credentials: api_base, business_id, access_token ya sasa na token_expires_at. Ukaguzi wa hali, orodha za video, maoni na takwimu kisha huendeshwa kutoka msimbo wako. Kuchapisha ndiko kunapaswa kupangwa: ombi la moja kwa moja la kuchapisha hupeleka video_url kwa TikTok bila kubadilishwa, mali za URL huongezwa kwa ID na siri ya developer app yako mwenyewe, na kiambishi ambacho app ya easyCoexistence imethibitisha ni njia yake ya midia, ambayo publish_tiktok_post hutumia.
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>'Jinsi ya kuisanidi
- 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.
Makosa ya kawaida
- Kuacha post_info. TikTok inahitaji kitu hiki kwenye kila ombi, hata kisipobadilika mpangilio wowote.
- Kutafuta post ID kwenye jibu la kuchapisha. Linarudisha share_id pekee; post IDs hupatikana kwenye ombi la hali au webhook ya publicly_available.
- Kurudia ombi la kuchapisha lililokwisha muda. Ombi la kwanza huenda lilifika TikTok, kwa hiyo kagua machapisho ya hivi karibuni ya akaunti kabla ya kulituma tena.
- Kuchukulia msimbo 0 kama video iko hewani. Unamaanisha TikTok imekubali kazi, na faili bado linaweza kushindwa ukaguzi wake baada ya kupakuliwa.
Kuanzia US$ 9 kwa kila muunganisho kwa mwezi, hadi US$ 0.75 kadri unavyoongeza miunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Ni endpoint ipi inachapisha video kwenye TikTok?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, ikiwa na token ya akaunti kwenye kichwa cha Access-Token na business_id, video_url na post_info kwenye mwili wa JSON.
Je, TikTok API inaweza kupakia faili la video moja kwa moja?
Si kupitia /business/video/publish/. Inachukua video_url na kupakua faili kutoka hapo, kwa hiyo video inahitaji URL kwenye domeni au kiambishi cha URL kilichothibitishwa.
Ninapataje ID ya video iliyochapishwa kupitia API?
Kutoka post_ids kwenye /business/publish/status/ hali ikiwa PUBLISH_COMPLETE na chapisho liko hadharani, au kutoka post_id kwenye webhook ya post.publish.publicly_available.
Je, ninaweza kupanga video ya TikTok ichapishwe baadaye kupitia API?
Endpoint ya kuchapisha huchapisha inapoitwa na haina sehemu ya muda. easyCoexistence huhifadhi machapisho yaliyopangwa kwenye foleni yake na kuita TikTok wakati uliouweka.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye