Ρυθμίσεις ανάρτησης 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 για να διαβάζει τις επιτρεπόμενες ρυθμίσεις του λογαριασμού.
Επιλογές ιδιωτικότητας για τις φωτογραφικές αναρτήσεις δημόσιου λογαριασμού: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS και SELF_ONLY.
Επίπεδο ιδιωτικότητας που παίρνει ιδιωτικός λογαριασμός αντί για PUBLIC_TO_EVERYONE: ορατό μόνο στους ακολούθους του.
Προεπιλογή των disable_comment, disable_duet και disable_stitch, άρα τα σχόλια, τα Duets και τα Stitches παραμένουν ενεργά εκτός αν οριστεί διαφορετικά.
Η προσαρμοσμένη εικόνα εξωφύλλου για βίντεο πρέπει να είναι τουλάχιστον 360 x 360 pixel και έως 20 MB.
Η ετικέτα is_branded_content υπερισχύει όταν το is_brand_organic είναι επίσης true.
Υποχρεωτικό πεδίο του post_info μιας φωτογραφικής ανάρτησης, περιορισμένο στις επιλογές που επιστρέφει το GET /business/video/settings/ για τον λογαριασμό.
Ποιες ρυθμίσεις δέχεται κάθε endpoint δημοσίευσης;
Τα /business/video/publish/ και /business/photo/publish/ μοιράζονται κάποιες ρυθμίσεις και διαφέρουν σε άλλες. Οι περισσότερες βρίσκονται μέσα στο post_info, ενώ τα custom_thumbnail_url και photo_cover_index βρίσκονται στο ανώτατο επίπεδο του σώματος. Παρακάτω, όπως τα αναφέρουν οι οδηγοί του TikTok, με Χωρίς πεδίο όπου ένα endpoint δεν τεκμηριώνει κάποια ρύθμιση:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_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: η μεγαλύτερη διάρκεια βίντεο που μπορεί να δημοσιεύσει ο λογαριασμός· ένα μεγαλύτερο βίντεο αποτυγχάνει.
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.
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.
Από 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.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις