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

Ρυθμίσεις ανάρτησης TikTok μέσω API: ιδιωτικότητα, σχόλια, Duet και Stitch

Το API για επιχειρήσεις του TikTok δέχεται τις ρυθμίσεις μιας ανάρτησης στην κλήση δημοσίευσης, κυρίως μέσα στο post_info. Τα βίντεο παίρνουν disable_comment, disable_duet και disable_stitch, ένα εξώφυλλο από το thumbnail_offset ή το custom_thumbnail_url, τις ετικέτες is_brand_organic και is_branded_content και το is_ai_generated. Οι φωτογραφικές αναρτήσεις παίρνουν privacy_level, disable_comment, τις ίδιες ετικέτες επωνυμίας και auto_add_music. Το GET /business/video/settings/ επιστρέφει τις τιμές που επιτρέπει κάθε λογαριασμός.

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

3 levels

Επιλογές ιδιωτικότητας για τις φωτογραφικές αναρτήσεις δημόσιου λογαριασμού: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS και SELF_ONLY.

FOLLOWER_OF_CREATOR

Επίπεδο ιδιωτικότητας που παίρνει ιδιωτικός λογαριασμός αντί για PUBLIC_TO_EVERYONE: ορατό μόνο στους ακολούθους του.

false

Προεπιλογή των disable_comment, disable_duet και disable_stitch, άρα τα σχόλια, τα Duets και τα Stitches παραμένουν ενεργά εκτός αν οριστεί διαφορετικά.

1080 x 1920

Η προσαρμοσμένη εικόνα εξωφύλλου για βίντεο πρέπει να είναι τουλάχιστον 360 x 360 pixel και έως 20 MB.

Paid partnership

Η ετικέτα is_branded_content υπερισχύει όταν το is_brand_organic είναι επίσης true.

privacy_level

Υποχρεωτικό πεδίο του post_info μιας φωτογραφικής ανάρτησης, περιορισμένο στις επιλογές που επιστρέφει το GET /business/video/settings/ για τον λογαριασμό.

Ποιες ρυθμίσεις δέχεται κάθε endpoint δημοσίευσης;

Τα /business/video/publish/ και /business/photo/publish/ μοιράζονται κάποιες ρυθμίσεις και διαφέρουν σε άλλες. Οι περισσότερες βρίσκονται μέσα στο post_info, ενώ τα custom_thumbnail_url και photo_cover_index βρίσκονται στο ανώτατο επίπεδο του σώματος. Παρακάτω, όπως τα αναφέρουν οι οδηγοί του TikTok, με Χωρίς πεδίο όπου ένα endpoint δεν τεκμηριώνει κάποια ρύθμιση:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

Τι επιτρέπει ο λογαριασμός;

Το GET /business/video/settings/ με business_id επιστρέφει τα όρια του λογαριασμού για τις αναρτήσεις του. Διαβάστε το πριν από τη δημοσίευση, αφού το TikTok δέχεται μόνο τις τιμές που εμφανίζει:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS και SELF_ONLY για δημόσιο λογαριασμό· FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS και SELF_ONLY για ιδιωτικό.
  • comment_disabled: true όταν ο λογαριασμός δεν δέχεται σχόλια από κανέναν, και τότε το disable_comment δέχεται μόνο true.
  • duet_disabled και stitch_disabled: true όταν ο λογαριασμός επιτρέπει το Duet ή το Stitch μόνο για «Only you», ή είναι ιδιωτικός· ο αντίστοιχος διακόπτης δέχεται τότε μόνο true.
  • max_video_post_duration_sec: η μεγαλύτερη διάρκεια βίντεο που μπορεί να δημοσιεύσει ο λογαριασμός· ένα μεγαλύτερο βίντεο αποτυγχάνει.
Read an account's post settings
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "comment_disabled": false,
    "duet_disabled": false,
    "max_video_post_duration_sec": 600,
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "stitch_disabled": false
  }
}

Ποιος μπορεί να δει την ανάρτηση;

Σε φωτογραφική ανάρτηση, το privacy_level που στέλνετε: PUBLIC_TO_EVERYONE για άτομα μέσα ή έξω από το TikTok, MUTUAL_FOLLOW_FRIENDS για ακολούθους που ο λογαριασμός ακολουθεί πίσω, FOLLOWER_OF_CREATOR για τους ακολούθους ιδιωτικού λογαριασμού, ή SELF_ONLY. Το endpoint βίντεο δεν έχει πεδίο ιδιωτικότητας, αφού δημοσιεύει δημόσιες αναρτήσεις βίντεο. Μια ανάρτηση ορισμένη σε «Friends» ή «Only you» δεν μπορεί να προβληθεί ούτε μέσω του embed_url της.

Πώς λειτουργούν τα σχόλια, το Duet και το Stitch;

Το καθένα είναι διακόπτης που απενεργοποιεί τη λειτουργία όταν οριστεί σε true. Το disable_comment υπάρχει και στα δύο endpoints· τα disable_duet και disable_stitch υπάρχουν μόνο στα βίντεο. Όλα έχουν προεπιλογή false, που αφήνει τη λειτουργία ενεργή, μέσα στα όρια των δικών του ρυθμίσεων ιδιωτικότητας: ένας λογαριασμός που δεν δέχεται σχόλια από κανέναν ή περιορίζει το Duet ή το Stitch στο «Only you» μπορεί να δημοσιεύσει μόνο με τον αντίστοιχο διακόπτη σε true.

Πώς επιλέγεται το εξώφυλλο;

Στο βίντεο, με δύο τρόπους. Το post_info.thumbnail_offset επιλέγει ένα καρέ με τον χρόνο του σε χιλιοστά του δευτερολέπτου, με προεπιλογή 0, στρογγυλοποιημένο στο πλησιέστερο καρέ· ένας χρόνος μετά το τέλος του βίντεο στέλνει ένα webhook αποτυχίας και το βίντεο δεν δημοσιεύεται. Το custom_thumbnail_url, στο ανώτατο επίπεδο του σώματος, δίνει μια εικόνα αντί γι' αυτό και κάνει το TikTok να αγνοεί το offset. Σε φωτογραφική ανάρτηση, το photo_cover_index επιλέγει μία από τις εικόνες, μετρώντας από το 0.

  • Προσαρμοσμένη εικόνα εξωφύλλου: JPG, JPEG, WebP ή PNG, έως 20 MB.
  • Μέγεθος: από 360 x 360 pixel έως 1080 x 1920, ή 1920 x 1080.
  • Τοποθεσία: ένα domain ή πρόθεμα URL επαληθευμένο για την εφαρμογή, όπως και το ίδιο το βίντεο.

Τι σημαίνουν οι ετικέτες επωνυμίας;

Γνωστοποιήσεις που εμφανίζει το TikTok στην ανάρτηση. Όταν το is_brand_organic οριστεί σε true, την σημειώνει ως Promotional content, για αναρτήσεις που προωθούν την ίδια την επιχείρηση του λογαριασμού. Όταν το is_branded_content οριστεί σε true, την σημειώνει ως Paid partnership, για αναρτήσεις σε πληρωμένη συνεργασία με μάρκα, και υπερισχύει όταν και τα δύο είναι true. Σε βίντεο με is_branded_content, το tto_invite_link μπορεί να συνδέσει την ανάρτηση με μια καμπάνια TikTok One Creator Marketplace στην οποία έχει εγγραφεί ο λογαριασμός.

Ποιες άλλες επιλογές υπάρχουν στο post_info;

Μερικές ακόμη, καθεμία τεκμηριωμένη στο endpoint που την δέχεται:

  • is_ai_generated, βίντεο: σημειώνει την ανάρτηση ως Creator labeled as AI-generated, κάτι που δεν αλλάζει μετά τη δημοσίευση.
  • location_id με location_name: ετικέτα τοποθεσίας που βρίσκεται μέσω του GET /business/publish/location/.
  • music_sound_info: εμπορικός ήχος με ID· στα βίντεο και η ένταση, 0 έως 100, και η αρχή και το τέλος του, σε χιλιοστά του δευτερολέπτου.
  • auto_add_music, φωτογραφικές αναρτήσεις: προσθέτει προτεινόμενη μουσική, που μπορεί να αλλάξει αργότερα στην εφαρμογή TikTok.
  • upload_to_draft ή is_draft: στέλνει την ανάρτηση στα εισερχόμενα του δημιουργού ως πρόχειρο, μαζί με το βίντεο, με το scope video.upload.
  • is_ads_only, βίντεο: δημοσιεύει ανάρτηση Only show in ads που παραμένει εκτός του προφίλ.

Ποιες ρυθμίσεις ορίζει το publish_tiktok_post;

Τρεις προέρχονται από το αίτημά σας: η λεζάντα, ο τίτλος μιας φωτογραφικής ανάρτησης και το disable_comment. Το easyCoexistence στέλνει τα is_brand_organic και is_branded_content ως false, δημοσιεύει τις φωτογραφικές αναρτήσεις ως PUBLIC_TO_EVERYONE με την πρώτη εικόνα ως εξώφυλλο, και αφήνει έξω τις υπόλοιπες ρυθμίσεις ενός βίντεο, ώστε να ισχύουν οι προεπιλογές του TikTok: disable_duet και disable_stitch false, thumbnail_offset 0 και is_ai_generated false.

Πώς στέλνετε τις υπόλοιπες ρυθμίσεις;

Από τον δικό σας κώδικα, με το token και το business_id του λογαριασμού από το get_social_credentials, σε διαδρομές του Business API κάτω από το business/. Ένα GET στο business/video/settings/ διαβάζει τα όρια του λογαριασμού. Ένα POST στο business/video/publish/ ή στο business/photo/publish/ μπορεί να φέρει ολόκληρο το τεκμηριωμένο σώμα, και φτάνει στο TikTok όπως είναι γραμμένο, με τα URL των πολυμέσων μέσα, γι' αυτό πρέπει να βρίσκονται σε domain ή πρόθεμα URL επαληθευμένο για την εφαρμογή. Το publish_tiktok_post είναι η κλήση που δρομολογεί τον σύνδεσμό σας μέσω της επαληθευμένης διαδρομής πολυμέσων του easyCoexistence.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

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

  • Αναμονή ότι το privacy_level λειτουργεί σε βίντεο. Το endpoint βίντεο δημοσιεύει δημόσιες αναρτήσεις και η τεκμηρίωσή του δεν έχει πεδίο ιδιωτικότητας· οι φωτογραφικές αναρτήσεις δέχονται privacy_level.
  • Ενεργοποίηση σχολίων σε λογαριασμό που δεν δέχεται κανένα. Όταν το comment_disabled είναι true, το TikTok δέχεται το disable_comment μόνο ως true.
  • Ορισμός thumbnail_offset πέρα από το τέλος του βίντεο. Το TikTok στέλνει ένα webhook αποτυχίας και το βίντεο δεν δημοσιεύεται.
  • Αποστολή PUBLIC_TO_EVERYONE για ιδιωτικό λογαριασμό. Οι privacy_level_options του έχουν FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS και SELF_ONLY.
Κάντε το με EasyCoexistence

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

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

Μπορώ να δημοσιεύσω ιδιωτικό βίντεο TikTok μέσω API;

Όχι με το endpoint βίντεο, που δημοσιεύει δημόσιες αναρτήσεις. Οι φωτογραφικές αναρτήσεις δέχονται privacy_level, συμπεριλαμβανομένου του SELF_ONLY, ενώ ένα βίντεο μπορεί να σταλεί ως πρόχειρο στα εισερχόμενα του δημιουργού με upload_to_draft.

Πώς απενεργοποιώ τα Duets και τα Stitches μέσω API;

Ορίστε post_info.disable_duet και post_info.disable_stitch σε true στο /business/video/publish/. Όταν ο λογαριασμός τα περιορίζει ήδη, το TikTok δέχεται μόνο true.

Μπορώ να προσθέσω ετικέτα τοποθεσίας μέσω του API του TikTok;

Ναι. Το post_info δέχεται location_id με location_name, για ετικέτα τοποθεσίας που βρίσκεται μέσω του GET /business/publish/location/.

Ποια είναι η διαφορά μεταξύ του is_brand_organic και του is_branded_content;

Το is_brand_organic προσθέτει ετικέτα Promotional content για την ίδια την επιχείρηση του λογαριασμού· το is_branded_content προσθέτει ετικέτα Paid partnership και υπερισχύει όταν και τα δύο είναι true.

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

Πώς να ανεβάσετε βίντεο στο TikTok μέσω του APIΑνεβάστε βίντεο στο TikTok με το API for Business: το publish endpoint, το JSON body, το share_id και την κλήση status, σε curl και Python.Επισήμανση περιεχομένου AI στο TikTok μέσω του APIΠώς να επισημαίνετε βίντεο με AI μέσω του TikTok API for Business με το post_info.is_ai_generated και τι απαιτεί η πολιτική TikTok για το περιεχόμενο AI.Φωτογραφικές αναρτήσεις και καρουζέλ TikTok μέσω του API: έως 35 εικόνεςΤο API for Business του TikTok δημοσιεύει φωτογραφικές αναρτήσεις: 1 έως 35 εικόνες JPEG ή WebP έως 20 MB η καθεμία, τίτλο 90 χαρακτήρων, λεζάντα, εξώφυλλο.TikTok media URLs: επαληθευμένα domains και URL prefixesΠώς το API for Business του TikTok λαμβάνει τα media από επαληθευμένα domains και URL prefixes, με έλεγχο DNS TXT ή αρχείου υπογραφής.Όρια λεζαντών TikTok μέσω API: μήκος, hashtags και @mentionsΤο μέγιστο μήκος λεζάντας TikTok μέσω του API for Business, πώς λειτουργούν hashtags και @mentions, πότε φαίνονται οι αλλαγές γραμμής και τα όρια φωτογραφιών.

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

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

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

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