ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Πώς να ανεβάσετε βίντεο στο TikTok μέσω του API

Για να ανεβάσετε βίντεο μέσω του TikTok API for Business, στείλτε POST /business/video/publish/ με το business_id του λογαριασμού, ένα video_url σε επαληθευμένο domain ή URL prefix και ένα αντικείμενο post_info με τη λεζάντα και τις ρυθμίσεις, μαζί με την κεφαλίδα Access-Token. Το TikTok απαντά με ένα share_id. Περάστε το ως publish_id στο /business/publish/status/ έως ότου η κατάσταση γίνει PUBLISH_COMPLETE και εμφανιστούν τα post_ids.

Το easyCoexistence αναρτά βίντεο TikTok με το publish_tiktok_post από το Claude, το ChatGPT ή τον δικό σας agent: περάστε έναν σύνδεσμο HTTPS, τη λεζάντα και αν τα σχόλια είναι ενεργά, και παρακολουθήστε την ανάρτηση με το get_tiktok_publish_status, ενώ το αρχείο φτάνει στο TikTok μέσα από την επαληθευμένη διαδρομή media.

share_id

Επιστρέφεται από την κλήση δημοσίευσης, όπως το v_pub_url~v1.2345123456789123456, και περνά στην κλήση status ως publish_id.

Nov 16, 2023

Από τότε, το TikTok αρνείται να δημοσιεύσει βίντεο από URL του οποίου το domain ή το URL prefix δεν είναι επαληθευμένο.

6 a minute

Το όριο του TikTok για αναρτήσεις βίντεο ανά λογαριασμό μέσω του publish endpoint, με το πολύ 15 την ημέρα.

3 min

Πόση ώρα μπορεί να χρειαστούν τα post_ids μετά το PUBLISH_COMPLETE. Το TikTok προτείνει να ξαναδοκιμάσετε μετά από τρία λεπτά.

post_id

Αποστέλλεται στο webhook post.publish.publicly_available μόλις μια ανάρτηση περάσει τον έλεγχο περιεχομένου, έτοιμη για ερώτηση των insights της.

Τι χρειάζεστε πριν από την πρώτη κλήση;

Τρία πράγματα. Ένα access token λογαριασμού TikTok και το open_id του λογαριασμού, από την ανταλλαγή token. Μια εφαρμογή προγραμματιστή με το δικαίωμα Video Publish στο TikTok Accounts. Και το βίντεο σε δημόσιο URL HTTPS ή HTTP που βρίσκεται κάτω από domain ή URL prefix επαληθευμένο για την εφαρμογή. Το TikTok κατεβάζει το αρχείο μόνο του, οπότε πρέπει να παραμένει προσβάσιμο, και το TikTok συνιστά ένα URL που ισχύει για τουλάχιστον 30 λεπτά.

Πώς μοιάζει το αίτημα δημοσίευσης;

Ένα POST στο https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, με το token του λογαριασμού στην κεφαλίδα Access-Token και Content-Type ορισμένο σε application/json. Το JSON body ονομάζει τον λογαριασμό στο business_id, το αρχείο στο video_url και τις ρυθμίσεις της ανάρτησης στο post_info. Αυτό το παράδειγμα δημοσιεύει ένα βίντεο με λεζάντα, με τα σχόλια, το Duet και το Stitch ενεργοποιημένα:

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

Τι κάνει κάθε πεδίο του body;

Τα πεδία που αναφέρει η αναφορά του TikTok για μια ανάρτηση βίντεο, από το ανώτερο επίπεδο προς τα κάτω. Στο ίδιο body βρίσκονται και το εξώφυλλο, η ετικέτα για περιεχόμενο που δημιουργήθηκε με AI, μια τοποθεσία, τα πρόχειρα και η επιλογή μόνο για διαφημίσεις:

  • business_id: το open_id του λογαριασμού από την ανταλλαγή token.
  • video_url: το αρχείο που κατεβάζει το TikTok, σε MP4, MOV ή WebM, σε επαληθευμένο domain ή URL prefix.
  • post_info: υποχρεωτικό σε κάθε κλήση, ακόμη και ως κενό αντικείμενο, και περιέχει τις ρυθμίσεις της ανάρτησης.
  • post_info.caption: έως 2.200 χαρακτήρες μετρημένους σε UTF-16, με #hashtags και έως 30 @mentions.
  • post_info.is_brand_organic και is_branded_content: οι ετικέτες «Προωθητικό περιεχόμενο» και «Επί πληρωμή συνεργασία», που ο πίνακας του TikTok σημειώνει ως υποχρεωτικές.
  • post_info.disable_comment, disable_duet και disable_stitch: το true απενεργοποιεί τα σχόλια, το Duet ή το Stitch. Και τα τρία έχουν προεπιλογή false.

Τι επιστρέφει το TikTok;

Η συνηθισμένη δομή απάντησης, με το ID της εργασίας δημοσίευσης στο data. Κωδικός 0 σημαίνει ότι το TikTok αποδέχθηκε την εργασία, όχι ότι η ανάρτηση είναι ήδη δημοσιευμένη. Το TikTok πρέπει ακόμη να κατεβάσει το αρχείο, να το ελέγξει και να ελέγξει το περιεχόμενο της ανάρτησης. Στα παραδείγματα του TikTok, το share_id ενός βίντεο αρχίζει με v_pub_url και εκείνο μιας φωτογραφικής ανάρτησης με p_pub_url.

The publish response
{
  "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. Το status δείχνει PROCESSING_DOWNLOAD όσο το TikTok κατεβάζει το αρχείο, PUBLISH_COMPLETE αφού η ανάρτηση περάσει τον έλεγχο περιεχομένου, ή FAILED με την αιτία. Τα post_ids εμφανίζονται με το PUBLISH_COMPLETE όταν η ανάρτηση είναι ορατή στο κοινό, και μπορεί να καθυστερήσουν έως τρία λεπτά. Όλη η ροή σε 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

Μπορεί ένα webhook να αντικαταστήσει τους ελέγχους status;

Ναι, για μια εφαρμογή που εγγράφεται στο event_type VIDEO με το /business/webhook/update/. Το TikTok τότε στέλνει post.publish.failed ή post.publish.complete αφού κατεβάσει και ελέγξει το αρχείο, post.publish.publicly_available με το νέο post_id μόλις περάσει ο έλεγχος περιεχομένου, και post.publish.no_longer_publicly_available αν η ανάρτηση αργότερα πάψει να είναι ορατή στο κοινό. Κάθε γεγονός ονομάζει την εργασία στο publish_id, την ίδια τιμή με το share_id.

Πώς δημοσιεύετε βίντεο μέσω MCP;

Ζητήστε το με απλά λόγια από το Claude, το ChatGPT ή άλλον πελάτη συνδεδεμένο στο https://easycoexistence.com/api/mcp. Ο βοηθός καλεί το publish_tiktok_post με το account_id από το list_social_accounts, ένα HTTPS video_url, τη λεζάντα και, αν θέλετε τα σχόλια απενεργοποιημένα, το disable_comment. Το αποτέλεσμα φέρει το share_id του TikTok. Το get_tiktok_publish_status, με το account_id και αυτό το share_id, επιστρέφει την κατάσταση του TikTok, τα post_ids και την αιτία όπως είναι αυτή τη στιγμή.

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;

Μια κλήση στο ίδιο endpoint, συμπληρωμένη από το αίτημά σας. Ο σύνδεσμός σας πηγαίνει στο TikTok ως υπογεγραμμένος σύνδεσμος μέσω της δικής του επαληθευμένης διαδρομής media του easyCoexistence, οπότε δεν χρειάζεται δική του επαλήθευση. Η λεζάντα και το disable_comment πηγαίνουν όπως τα δώσατε, και τα is_brand_organic και is_branded_content πηγαίνουν ως false. Οι υπόλοιπες ρυθμίσεις, όπως το Duet, το Stitch, το εξώφυλλο και η ετικέτα AI, διατηρούν τις προεπιλογές του TikTok, και το βίντεο δημοσιεύεται ως δημόσια ανάρτηση, όπως είναι φτιαγμένο να κάνει το endpoint.

Τι μπορείτε να κάνετε με διαπιστευτήρια από το Partner API;

Να καλείτε το TikTok απευθείας ως ο λογαριασμός. Το GET /channels/{id}?credentials=1 στο https://easycoexistence.com/api/v1, με το κλειδί σας ec_live_ ως bearer token, επιστρέφει το κανάλι με ένα αντικείμενο credentials: api_base, business_id, ένα τρέχον access_token και το token_expires_at. Οι έλεγχοι status, οι λίστες βίντεο, τα σχόλια και τα insights τρέχουν από τον δικό σας κώδικα. Η δημοσίευση είναι το κομμάτι που θέλει σχεδιασμό: μια απευθείας κλήση δημοσίευσης περνά το video_url στο TikTok αμετάβλητο, οι ιδιότητες URL προστίθενται με το ID και το secret της δικής σας εφαρμογής προγραμματιστή, και το prefix που έχει επαληθεύσει η εφαρμογή του easyCoexistence είναι η διαδρομή media της, την οποία χρησιμοποιεί το 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>'

Πώς να το ρυθμίσετε

  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.

Συνηθισμένα λάθη

  • Παράλειψη του post_info. Το TikTok απαιτεί το αντικείμενο σε κάθε κλήση, ακόμη και όταν καμία ρύθμιση δεν αλλάζει.
  • Αναζήτηση ID ανάρτησης στην απάντηση δημοσίευσης. Επιστρέφει μόνο το share_id. Τα post IDs προέρχονται από την κλήση status ή από το webhook publicly_available.
  • Επανάληψη κλήσης δημοσίευσης που έληξε χρονικό όριο. Το πρώτο αίτημα μπορεί να έφτασε στο TikTok, οπότε ελέγξτε τις τελευταίες αναρτήσεις του λογαριασμού πριν το στείλετε ξανά.
  • Αντιμετώπιση του κωδικού 0 ως δημοσιευμένου βίντεο. Σημαίνει ότι το TikTok αποδέχθηκε την εργασία, και το αρχείο μπορεί ακόμη να αποτύχει στους ελέγχους του μετά το κατέβασμα.
Κάντε το με EasyCoexistence

US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Ποιο endpoint ανεβάζει βίντεο στο TikTok;

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, με το token του λογαριασμού στην κεφαλίδα Access-Token και τα business_id, video_url και post_info στο JSON body.

Μπορεί το TikTok API να ανεβάσει αρχείο βίντεο απευθείας;

Όχι μέσω του /business/video/publish/. Δέχεται video_url και κατεβάζει το αρχείο από εκεί, οπότε το βίντεο χρειάζεται URL σε επαληθευμένο domain ή URL prefix.

Πώς παίρνω το ID ενός βίντεο που δημοσιεύτηκε μέσω του API;

Από τα post_ids στο /business/publish/status/ μόλις η κατάσταση γίνει PUBLISH_COMPLETE και η ανάρτηση είναι ορατή στο κοινό, ή από το post_id στο webhook post.publish.publicly_available.

Μπορώ να προγραμματίσω ένα βίντεο TikTok για αργότερα μέσω του API;

Το publish endpoint δημοσιεύει όταν καλείται και δεν έχει πεδίο ώρας. Το easyCoexistence κρατά τις προγραμματισμένες αναρτήσεις στη δική του ουρά και καλεί το TikTok τη στιγμή που ορίσατε.

Συνεχίστε την ανάγνωση

Ρυθμίσεις ανάρτησης TikTok μέσω API: ιδιωτικότητα, σχόλια, Duet και StitchΟι ρυθμίσεις των endpoints δημοσίευσης του TikTok: ιδιωτικότητα, σχόλια, Duet, Stitch, εξώφυλλο, ετικέτες AI και επωνυμίας.TikTok media URLs: επαληθευμένα domains και URL prefixesΠώς το API for Business του TikTok λαμβάνει τα media από επαληθευμένα domains και URL prefixes, με έλεγχο DNS TXT ή αρχείου υπογραφής.Πώς ελέγχετε την κατάσταση δημοσίευσης μιας ανάρτησης στο TikTok μέσω του APIΠώς παρακολουθείτε ανάρτηση στο TikTok που δημοσιεύεται μέσω του API: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE, FAILED, τα post IDs και αιτίες αποτυχίας.Απαιτήσεις βίντεο TikTok για το API: μορφή, μέγεθος και διάρκειαΤα βίντεο που δημοσιεύει το API for Business του TikTok: MP4, MOV ή WebM, 3 έως 600 δευτερόλεπτα, έως 1 GB, 23 έως 60 FPS, από URL που κατεβάζει το TikTok.Ρύθμιση των webhooks του TikTok API for BusinessΕγγραφή εφαρμογής TikTok API for Business σε webhooks: /business/webhook/update/, γεγονότα VIDEO και COMMENT, κανόνες callback και Tiktok-Signature.Tokens πρόσβασης του TikTok API for Business: 24 ώρες, ανανέωση και ανάκλησηΠώς το TikTok API for Business εκδίδει tokens λογαριασμού: ανταλλαγή του auth_code, πρόσβαση 24 ωρών, refresh token, ανανέωση και ανάκληση.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις