কীভাবে API-এর মাধ্যমে TikTok-এ ভিডিও পোস্ট করবেন
TikTok-এর API for Business-এ ভিডিও পোস্ট করতে অ্যাকাউন্টের business_id, যাচাই করা ডোমেইন বা URL প্রিফিক্সের একটি video_url, এবং ক্যাপশন ও সেটিংস ধারণকারী post_info অবজেক্ট সহ POST /business/video/publish/ পাঠান, সঙ্গে Access-Token হেডার দিন। TikTok একটি share_id ফেরত দেয়; স্ট্যাটাস PUBLISH_COMPLETE না হওয়া এবং post_ids না আসা পর্যন্ত সেটি publish_id হিসেবে /business/publish/status/-এ পাঠান।
easyCoexistence publish_tiktok_post দিয়ে Claude, ChatGPT বা আপনার নিজস্ব এজেন্ট থেকে TikTok ভিডিও পোস্ট করে: একটি HTTPS লিংক, ক্যাপশন দিন এবং কমেন্ট চালু থাকবে কি না বলুন, তারপর get_tiktok_publish_status দিয়ে পোস্টটি অনুসরণ করুন, আর ফাইলটি যাচাই করা মিডিয়া রুটের মাধ্যমে TikTok-এ পৌঁছায়।
প্রকাশ কল থেকে ফেরত আসে, যেমন v_pub_url~v1.2345123456789123456, এবং সেটি স্ট্যাটাস কলে publish_id হিসেবে পাঠানো হয়।
তখন থেকে, যে URL-এর ডোমেইন বা URL প্রিফিক্স যাচাই করা হয়নি, TikTok সেই URL থেকে ভিডিও প্রকাশ করতে অস্বীকার করে।
প্রকাশ এন্ডপয়েন্টের মাধ্যমে প্রতি অ্যাকাউন্টে TikTok-এর ভিডিও পোস্টের সীমা, দিনে সর্বোচ্চ 15টি।
PUBLISH_COMPLETE-এর পর post_ids দেখা দিতে যে সময় লাগতে পারে; TikTok বলে তিন মিনিট পর আবার চেষ্টা করুন।
পোস্ট মডারেশন পাস করলে post.publish.publicly_available ওয়েবহুকে পাঠানো হয়, এবং এটি ইনসাইটস অনুসন্ধানের জন্য প্রস্তুত থাকে।
প্রথম কলের আগে কী লাগবে?
তিনটি জিনিস। একটি TikTok অ্যাকাউন্টের অ্যাক্সেস টোকেন ও টোকেন এক্সচেঞ্জ থেকে পাওয়া অ্যাকাউন্টের open_id; TikTok Accounts-এর অধীনে Video Publish অনুমতিসহ একটি ডেভেলপার অ্যাপ; এবং একটি পাবলিক HTTPS বা HTTP URL-এ ভিডিও, যা অ্যাপের জন্য যাচাই করা ডোমেইন বা URL প্রিফিক্সের অধীনে থাকে। TikTok ফাইলটি নিজে ডাউনলোড করে, তাই এটি অ্যাক্সেসযোগ্য থাকতে হবে, এবং TikTok অন্তত 30 মিনিট স্থায়ী একটি URL-এর সুপারিশ করে।
প্রকাশ রিকোয়েস্টটি কেমন দেখায়?
একটি POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/-এ, অ্যাকাউন্টের টোকেন Access-Token হেডারে এবং Content-Type application/json-এ সেট করে। JSON বডিতে business_id দিয়ে অ্যাকাউন্ট, video_url-এ ফাইল এবং post_info-তে পোস্টের সেটিংস নির্দেশ করা হয়। এই উদাহরণটি কমেন্ট, Duet ও 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
}
}'প্রতিটি বডি ফিল্ড কী করে?
TikTok-এর রেফারেন্স ভিডিও পোস্টের জন্য যে ফিল্ডগুলো তালিকাভুক্ত করে, উপর থেকে শুরু করে। কভার, AI-generated লেবেল, লোকেশন, ড্রাফট ও শুধু বিজ্ঞাপনের অপশনও একই বডিতে থাকে:
business_id: টোকেন এক্সচেঞ্জ থেকে অ্যাকাউন্টেরopen_id।video_url: TikTok যে ফাইলটি ডাউনলোড করে, MP4, MOV বা WebM, যাচাই করা ডোমেইন বা URL প্রিফিক্সে।post_info: প্রতিটি কলে বাধ্যতামূলক, এমনকি খালি অবজেক্ট হিসেবেও, এবং পোস্টের সেটিংস এখানে থাকে।post_info.caption: UTF-16 গণনায় সর্বোচ্চ 2,200 অক্ষর, #হ্যাশট্যাগ ও সর্বোচ্চ 30টি @মেনশনসহ।post_info.is_brand_organicওis_branded_content: Promotional content ও Paid partnership লেবেল, যেগুলো TikTok-এর টেবিলে আবশ্যক হিসেবে চিহ্নিত।post_info.disable_comment,disable_duetওdisable_stitch: true হলে কমেন্ট, Duet বা Stitch বন্ধ হয়; তিনটির ডিফল্ট false।
TikTok কী ফেরত দেয়?
স্বাভাবিক এনভেলপ, যেখানে data-তে প্রকাশের টাস্কের আইডি থাকে। কোড 0 মানে TikTok টাস্কটি গ্রহণ করেছে, ভিডিওটি লাইভ হয়েছে তা নয়: TikTok তখনও ফাইলটি ডাউনলোড, পরীক্ষা ও পোস্টের মডারেশন করবে। TikTok-এর উদাহরণে ভিডিওর share_id v_pub_url দিয়ে এবং ফটো পোস্টের share_id p_pub_url দিয়ে শুরু হয়।
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}পোস্ট লাইভ না হওয়া পর্যন্ত কীভাবে অনুসরণ করবেন?
GET /business/publish/status/ দিয়ে, business_id ও share_id-কে publish_id হিসেবে পাঠিয়ে। TikTok ফাইল আনার সময় স্ট্যাটাস PROCESSING_DOWNLOAD দেখায়, পোস্ট মডারেশন পাস করলে PUBLISH_COMPLETE, অথবা কারণসহ FAILED। পোস্ট পাবলিকভাবে দেখা গেলে PUBLISH_COMPLETE-এর সাথে post_ids আসে, এবং তা তিন মিনিট পর্যন্ত পিছিয়ে থাকতে পারে। পুরো প্রবাহটি 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ওয়েবহুক কি স্ট্যাটাস পরীক্ষা প্রতিস্থাপন করতে পারে?
পারে, এমন অ্যাপের জন্য যেটি /business/webhook/update/ দিয়ে event_type VIDEO-তে সাবস্ক্রাইব করে। ফাইলটি ডাউনলোড ও পরীক্ষা শেষ হলে TikTok post.publish.failed বা post.publish.complete ইভেন্ট পাঠায়; মডারেশন পাস করলে নতুন post_id সহ post.publish.publicly_available; এবং পোস্ট পরে পাবলিকভাবে দৃশ্যমান থাকা থেকে সরে গেলে post.publish.no_longer_publicly_available। প্রতিটি ইভেন্ট publish_id-তে টাস্ক নির্দেশ করে, যা share_id-এর সমান মান।
MCP-এর মাধ্যমে কীভাবে ভিডিও পোস্ট করবেন?
Claude, ChatGPT বা https://easycoexistence.com/api/mcp-এর সাথে সংযুক্ত অন্য ক্লায়েন্টকে সাধারণ ভাষায় বলুন। সহকারী list_social_accounts থেকে account_id, একটি HTTPS video_url, ক্যাপশন এবং কমেন্ট বন্ধ চাইলে disable_comment সহ publish_tiktok_post কল করে। ফলাফলে TikTok-এর share_id থাকে, এবং account_id ও সেই share_id দিয়ে get_tiktok_publish_status TikTok-এর স্ট্যাটাস, post_ids ও কারণ যেমন আছে তেমন ফেরত দেয়।
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 TikTok-এ কী পাঠায়?
একই এন্ডপয়েন্টে একটি কল, আপনার অনুরোধ থেকে পূর্ণ করা। আপনার লিংক easyCoexistence-এর নিজস্ব যাচাই করা মিডিয়া রুটের অধীনে একটি সাইন করা লিংক হিসেবে TikTok-এ যায়, তাই এর নিজস্ব যাচাইয়ের দরকার নেই। ক্যাপশন ও disable_comment যেমন দিয়েছেন তেমনই যায়, এবং is_brand_organic ও is_branded_content যায় false হিসেবে। অন্য সেটিংস, যেমন Duet, Stitch, কভার ও AI-generated লেবেল, TikTok-এর ডিফল্ট রাখে, এবং ভিডিওটি পাবলিক পোস্ট হিসেবে প্রকাশ হয়, এন্ডপয়েন্ট যেভাবে তৈরি সেভাবেই।
Partner API-এর ক্রেডেনশিয়াল দিয়ে কী করা যায়?
অ্যাকাউন্ট হিসেবে সরাসরি TikTok-কে কল করা যায়। https://easycoexistence.com/api/v1-এ GET /channels/{id}?credentials=1, Bearer টোকেন হিসেবে আপনার ec_live_ কী দিয়ে, চ্যানেলটি credentials অবজেক্টসহ ফেরত দেয়: api_base, business_id, একটি বর্তমান access_token ও token_expires_at। এরপর স্ট্যাটাস পরীক্ষা, ভিডিও তালিকা, কমেন্ট ও ইনসাইটস আপনার নিজের কোড থেকে চলতে পারে। প্রকাশ নিয়ে পরিকল্পনা করা দরকার: সরাসরি প্রকাশ কল video_url কোনো পরিবর্তন ছাড়া TikTok-এ পাঠায়; URL-এর বৈশিষ্ট্য যোগ হয় একটি ডেভেলপার অ্যাপের নিজের ID ও secret দিয়ে; এবং easyCoexistence-এর অ্যাপ যে প্রিফিক্সটি যাচাই করেছে সেটি তার মিডিয়া রুট, যা 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>'কীভাবে সেট আপ করবেন
- 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.
সাধারণ ভুলগুলো
- post_info বাদ দেওয়া। TikTok প্রতিটি কলে এই অবজেক্টটি চায়, এমনকি কোনো সেটিংস না বদলালেও।
- প্রকাশ প্রতিক্রিয়ায় পোস্ট আইডি খোঁজা। এতে শুধু share_id থাকে; পোস্ট আইডি আসে স্ট্যাটাস কল বা publicly_available ওয়েবহুক থেকে।
- টাইম আউট হওয়া প্রকাশ কল আবার পাঠানো। প্রথম অনুরোধটি TikTok-এ পৌঁছে থাকতে পারে, তাই আবার পাঠানোর আগে অ্যাকাউন্টের সাম্প্রতিক পোস্টগুলো দেখে নিন।
- কোড 0-কে লাইভ ভিডিও ধরা। এর মানে TikTok টাস্কটি গ্রহণ করেছে, এবং ডাউনলোডের পরেও ফাইলটি পরীক্ষায় ব্যর্থ হতে পারে।
প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সাথে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কোন এন্ডপয়েন্ট TikTok-এ ভিডিও পোস্ট করে?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, অ্যাকাউন্টের টোকেন Access-Token হেডারে এবং business_id, video_url ও post_info JSON বডিতে।
TikTok API কি সরাসরি ভিডিও ফাইল আপলোড করতে পারে?
/business/video/publish/ দিয়ে নয়। এটি video_url নেয় এবং সেখান থেকে ফাইল আনে, তাই ভিডিওটির যাচাই করা ডোমেইন বা URL প্রিফিক্সে একটি URL থাকতে হবে।
API দিয়ে প্রকাশিত ভিডিওর আইডি কীভাবে পাব?
স্ট্যাটাস PUBLISH_COMPLETE এবং পোস্ট পাবলিক হলে /business/publish/status/-এর post_ids থেকে, অথবা post.publish.publicly_available ওয়েবহুকের post_id থেকে।
API দিয়ে TikTok ভিডিও পরে নির্ধারিত সময়ে পোস্ট করা যায় কি?
প্রকাশ এন্ডপয়েন্ট কল করা হলেই পোস্ট করে এবং এতে কোনো সময়ের ফিল্ড নেই। easyCoexistence নির্ধারিত পোস্টগুলো নিজের কিউতে রাখে এবং আপনার সেট করা সময়ে TikTok-কে কল করে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে