Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

API ile TikTok'a video nasıl yayımlanır

TikTok'un işletme API'si üzerinden video yayımlamak için POST /business/video/publish/ isteğini gönderin. İsteğe hesabın business_id değerini, doğrulanmış bir alan adı veya URL öneki altındaki bir video_url'i ve açıklama ile ayarları taşıyan bir post_info nesnesini ekleyin; Access-Token başlığını da kullanın. TikTok bir share_id döndürür. Bunu publish_id olarak /business/publish/status/ çağrısına verin ve durum PUBLISH_COMPLETE olup post_ids görünene kadar sorgulayın.

easyCoexistence, Claude, ChatGPT veya kendi ajanınızdan publish_tiktok_post ile TikTok videoları yayımlar: bir HTTPS URL'si, açıklama ve yorumların açık olup olmadığını verin; ardından gönderiyi get_tiktok_publish_status ile izleyin.

share_id

Yayım çağrısının döndürdüğü ve durum çağrısına publish_id olarak iletilen değer, örneğin v_pub_url~v1.2345123456789123456.

Nov 16, 2023

Bu tarihten itibaren TikTok, alan adı veya URL öneki doğrulanmamış URL'lerden video yayımlamayı reddediyor.

6 a minute

TikTok'un yayım uç noktasıyla hesap başına video gönderisi sınırı: günde en fazla 15.

3 min

PUBLISH_COMPLETE durumundan sonra post_ids değerlerinin görünmesi birkaç dakika sürebilir; TikTok üç dakika sonra yeniden denemeyi öneriyor.

post_id

Gönderi denetimden geçtiğinde post.publish.publicly_available webhook'unda gönderilir ve analizleri sorgulamaya hazır olur.

İlk çağrıdan önce neler gerekir?

Üç şey. Token değişiminden alınan bir TikTok hesap erişim token'ı ve hesabın open_id değeri; TikTok Accounts altında Video Publish iznine sahip bir geliştirici uygulaması; ve uygulama için doğrulanmış bir alan adı veya URL öneki altında duran, herkese açık bir HTTPS veya HTTP URL'sindeki video. TikTok dosyayı kendisi indirir, bu yüzden erişilebilir kalmalıdır; TikTok en az 30 dakika yaşayan bir URL önerir.

Yayım isteği nasıl görünür?

https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ adresine POST isteği; hesabın token'ı Access-Token başlığında ve Content-Type application/json olarak ayarlanır. JSON gövdesi hesabı business_id ile, dosyayı video_url ile ve gönderinin ayarlarını post_info ile belirtir. Bu örnek, yorumları, Duet'i ve Stitch'i açık bırakarak açıklamalı bir video yayımlar:

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
    }
  }'

Gövdedeki her alan ne yapar?

TikTok'un referansında bir video gönderisi için listelenen alanlar, en üstten başlayarak. Kapak, yapay zekâ ile üretildi etiketi, konum, taslaklar ve yalnızca reklam seçeneği aynı gövdede yer alır:

  • business_id: token değişiminden gelen hesabın open_id değeri.
  • video_url: TikTok'un indirdiği dosya; MP4, MOV veya WebM, doğrulanmış bir alan adı veya URL öneki altında.
  • post_info: her çağrıda zorunlu, boş bir nesne bile olsa; gönderinin ayarlarının bulunduğu yer.
  • post_info.caption: UTF-16 ile sayılan en fazla 2.200 karakter; #etiketler ve en fazla 30 @etiket ile.
  • post_info.is_brand_organic ve is_branded_content: TikTok'un tablosunda zorunlu işaretlenen Ticari içerik ve Ücretli iş birliği etiketleri.
  • post_info.disable_comment, disable_duet ve disable_stitch: true değeri yorumları, Duet'i veya Stitch'i kapatır; üçü de varsayılan olarak false.

TikTok ne döndürür?

Olağan zarf, yayım görevinin kimliği ise data içinde yer alır. 0 kodu, TikTok'un görevi kabul ettiği anlamına gelir; videonun yayında olduğu anlamına gelmez. TikTok hâlâ dosyayı indirmeli, kontrol etmeli ve gönderiyi denetlemelidir. TikTok'un örneklerinde video share_id'si v_pub_url ile, fotoğraf gönderisininki p_pub_url ile başlar.

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

Gönderi yayına girene kadar nasıl izlenir?

business_id ve share_id'yi publish_id olarak vererek GET /business/publish/status/ ile. TikTok dosyayı çekerken durum PROCESSING_DOWNLOAD olur; gönderi denetimden geçtiğinde PUBLISH_COMPLETE, başarısız olursa nedeniyle birlikte FAILED olur. post_ids, gönderi herkese açık olarak görüntülenebildiğinde PUBLISH_COMPLETE ile birlikte gelir ve üç dakikaya kadar gecikebilir. Tüm akış Python'da:

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

Webhook durum kontrollerinin yerini alabilir mi?

Evet; event_type VIDEO için /business/webhook/update/ ile abone olan bir uygulama için. TikTok dosyayı indirip kontrol ettikten sonra post.publish.failed veya post.publish.complete gönderir; denetim geçildiğinde yeni post_id ile post.publish.publicly_available gönderir; gönderi daha sonra herkese açık görünümden çıkarsa post.publish.no_longer_publicly_available gönderir. Her olay görevi publish_id içinde adlandırır; bu değer share_id ile aynıdır.

Videoyu MCP üzerinden nasıl yayımlarsınız?

Claude, ChatGPT veya https://easycoexistence.com/api/mcp adresine bağlı başka bir istemciden düz bir dille isteyin. Asistan, list_social_accounts'tan gelen account_id ile publish_tiktok_post'u çağırır; bir HTTPS video_url, açıklama ve yorumları kapatmak isterseniz disable_comment ile. Sonuç TikTok'un share_id değerini taşır. account_id ve bu share_id verilen get_tiktok_publish_status ise TikTok'un durumunu, post_ids değerlerini ve nedeni olduğu gibi döndürür.

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>"] }

publish_tiktok_post TikTok'a ne gönderir?

Aynı uç noktaya yapılan bir çağrı; isteğinizden doldurulmuş olarak. Bağlantınız, easyCoexistence'ın kendi doğrulanmış medya rotası altında imzalı bir URL olarak TikTok'a gider; bu yüzden ayrıca doğrulama gerektirmez. Açıklama ve disable_comment verdiğiniz gibi gider; is_brand_organic ve is_branded_content false olarak gider. Duet, Stitch, kapak ve yapay zekâ ile üretildi etiketi gibi diğer ayarlar TikTok'un varsayılanlarını korur ve uç nokta öyle tasarlandığı için video herkese açık bir gönderi olarak yayımlanır.

Partner API'den alınan kimlik bilgileriyle ne yapabilirsiniz?

TikTok'u doğrudan hesap olarak çağırabilirsiniz. https://easycoexistence.com/api/v1 üzerinde, ec_live_ anahtarınızı taşıyıcı token olarak kullanarak GET /channels/{id}?credentials=1 çağrısı; api_base, business_id, güncel bir access_token ve token_expires_at içeren credentials nesneli kanalı döndürür. Durum kontrolleri, video listeleri, yorumlar ve analizler bundan sonra kendi kodunuzdan çalışır. Yayım kısmı planlanmalıdır: doğrudan yayım çağrısı video_url'i TikTok'a olduğu gibi iletir, URL özellikleri geliştirici uygulamasının kendi kimliği ve gizli anahtarıyla eklenir; easyCoexistence uygulamasının doğruladığı önek ise publish_tiktok_post'un kullandığı medya rotasıdır.

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>'

Nasıl kurulur

  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.

Yaygın hatalar

  • post_info'yu atlamak. TikTok, hiçbir ayar değişmese bile her çağrıda bu nesneyi ister.
  • Yayım yanıtında bir gönderi kimliği aramak. Yalnızca share_id döner; gönderi kimlikleri durum çağrısından veya herkese açık olduğuna dair webhook'tan gelir.
  • Zaman aşımına uğrayan bir yayım çağrısını tekrarlamak. İlk istek TikTok'a ulaşmış olabilir; yeniden göndermeden önce hesabın en son gönderilerini kontrol edin.
  • Kod 0'ı yayında bir video sanmak. Görevin TikTok tarafından kabul edildiği anlamına gelir; dosya indirildikten sonra kontrollerden yine de geçemeyebilir.
Bunu EasyCoexistence'la yapmak

Dosya ise doğrulanmış medya rotası üzerinden TikTok'a ulaşır. Bağlantı başına ayda US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

Hangi uç nokta TikTok'a video yayımlar?

https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ adresine POST; hesap token'ı Access-Token başlığında, business_id, video_url ve post_info ise JSON gövdesinde.

TikTok API bir video dosyasını doğrudan yükleyebilir mi?

/business/video/publish/ üzerinden hayır. Bu uç nokta video_url alır ve dosyayı oradan çeker; bu yüzden video, doğrulanmış bir alan adı veya URL öneki altındaki bir URL'de olmalıdır.

API ile yayımlanan videonun kimliğini nasıl alırım?

/business/publish/status/ içindeki post_ids'ten, durum PUBLISH_COMPLETE olup gönderi herkese açık olduğunda; ya da post.publish.publicly_available webhook'undaki post_id'den.

API üzerinden bir TikTok videosunu ileri bir tarihe planlayabilir miyim?

Yayım uç noktası çağrıldığında hemen yayımlar ve zaman alanı yoktur. easyCoexistence zamanlanmış gönderileri kendi kuyruğunda tutar ve belirlediğiniz zamanda TikTok'u çağırır.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi