> ## Documentation Index > Fetch the complete documentation index at: https://docs.madiad.com/llms.txt > Use this file to discover all available pages before exploring further. # Tùy chọn theo nền tảng > Tùy chọn xuất bản theo từng nền tảng: quyền riêng tư, bản nháp, loại video, poll, CTA và nhiều hơn nữa. MADIAD Hub chuyển tiếp nguyên vẹn mọi tùy chọn mà nền tảng hỗ trợ, nên bạn không bị giới hạn ở các field liệt kê ở đây. Các field dưới đây là những tùy chọn phổ biến và quan trọng nhất. Thêm tiền tố tên nền tảng khi tùy chọn đó đặc thù cho nền tảng (`_`). Các field dạng mảng dùng quy ước `field[]`, lặp lại key một lần cho mỗi giá trị. Mọi field trên trang này đều là **tùy chọn** trừ khi được đánh dấu **bắt buộc**. Bỏ qua một field sẽ dùng giá trị mặc định của nền tảng. ## TikTok | Field | Kiểu | Tác dụng | | ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `privacy_level` | String | Ai có thể xem bài: `PUBLIC_TO_EVERYONE` (mặc định), `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, `SELF_ONLY` | | `post_mode` | String | `DIRECT_POST` (mặc định) đăng ngay lập tức; `MEDIA_UPLOAD` gửi media vào hộp thư đến của TikTok dưới dạng bản nháp để creator chỉnh sửa trong ứng dụng | | `auto_add_music` | Boolean | Thêm nhạc nền cho bài ảnh (mặc định `false`) | | `disable_comment` | Boolean | Tắt bình luận trên bài đăng (mặc định `false`) | | `disable_duet` | Boolean | Tắt Duet trên bài đăng (mặc định `false`) | | `disable_stitch` | Boolean | Tắt Stitch trên bài đăng (mặc định `false`) | | `brand_content_toggle` | Boolean | Đặt `true` cho nội dung hợp tác thương hiệu trả phí từ bên thứ ba (mặc định `false`) | | `brand_organic_toggle` | Boolean | Đặt `true` khi quảng bá thương hiệu của chính creator (mặc định `false`) | | `photo_cover_index` | Integer | Chỉ số của ảnh dùng làm ảnh bìa/thumbnail trong bài ảnh (mặc định `0`) | | `tiktok_title` | String | Tiêu đề bài ảnh (≤ 90 ký tự), xem [Giới hạn ký tự](/vi/concepts/posts) | | `tiktok_description` | String | Caption dài cho bài ảnh (≤ 4.000 ký tự), xem [Giới hạn ký tự](/vi/concepts/posts) | `brand_content_toggle` và `brand_organic_toggle` có thể cùng là `true`, ví dụ creator quảng bá thương hiệu của chính mình trong một hợp tác trả phí. ```bash theme={null} curl -X POST https://api.madiad.com/v1/posts/video \ -H "Authorization: Bearer $MADIAD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "profile_id": "'"$PROFILE_ID"'", "platforms": ["tiktok"], "caption": "Hậu trường sản xuất", "video_url": "https://cdn.example.com/clip.mp4", "privacy_level": "FOLLOWER_OF_CREATOR", "disable_duet": true }' ``` ## Instagram | Field | Kiểu | Tác dụng | | ------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `media_type` | String | `IMAGE` (mặc định) hoặc `STORIES`; media hỗn hợp tự động được xử lý thành carousel hoặc reel | | `collaborators` | String | Danh sách username cộng tác viên, phân cách bằng dấu phẩy | | `user_tags` | String (JSON) | Tag người dùng vào ảnh; cần một mảng JSON gồm các đối tượng `{username, x, y}` trong đó `x` và `y` là số thực 0.0-1.0 thể hiện vị trí trên ảnh | | `location_id` | String | Id địa điểm Instagram để đính kèm bài đăng | | `instagram_first_comment` | String | Tự động đăng bình luận ngay sau khi xuất bản, xem [Bình luận đầu tiên](/vi/concepts/posts) | ```bash theme={null} -F "media_type=STORIES" \ -F 'user_tags=[{"username":"jane_doe","x":0.5,"y":0.3}]' \ -F "location_id=213385402" ``` ## Facebook | Field | Kiểu | Tác dụng | | ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `facebook_page_id` | String | **Bắt buộc** khi profile có nhiều hơn một Facebook Page: chọn Page sẽ đăng lên (tự động chọn khi chỉ có một Page) | | `facebook_media_type` | String | `REELS` (mặc định, 9:16, ≤ 90 giây; video dài hơn bị cắt còn 90 giây), `STORIES` (tồn tại 24 giờ), hoặc `VIDEO` (video Page thông thường, bất kỳ tỷ lệ khung hình, tối đa 4 giờ, hỗ trợ thumbnail tùy chỉnh) | | `thumbnail_url` | String | URL thumbnail tùy chỉnh, chỉ áp dụng khi `facebook_media_type=VIDEO` | | `video_state` | String | `PUBLISHED` (mặc định) hoặc `DRAFT` (lưu video Page dưới dạng bản nháp để đăng thủ công) | | `facebook_description` | String | Mô tả dài hiển thị bên dưới video | | `facebook_first_comment` | String | Tự động đăng bình luận đầu tiên ngay sau khi xuất bản (chỉ áp dụng cho bài đăng Page), xem [Bình luận đầu tiên](/vi/concepts/posts) | Để đăng video Page dài (dọc hoặc ngang, bất kỳ độ dài lên đến 4 giờ), hãy đặt `facebook_media_type=VIDEO`. Nếu không, mặc định là `REELS` và video bị giới hạn còn 90 giây. ```bash theme={null} -F "facebook_media_type=VIDEO" \ -F "thumbnail_url=https://cdn.example.com/thumb.jpg" \ -F "facebook_description=Hướng dẫn đầy đủ — xem đến hết nhé." ``` ## YouTube | Field | Kiểu | Tác dụng | | --------------------------- | ------- | ------------------------------------------------------------------------------------------ | | `privacyStatus` | String | `public` (mặc định), `unlisted` hoặc `private` | | `tags[]` | Array | Tags video (lặp lại key một lần mỗi tag) | | `categoryId` | String | Id danh mục YouTube (mặc định `"22"`, People & Blogs) | | `selfDeclaredMadeForKids` | Boolean | Khai báo video dành cho trẻ em (mặc định `false`) | | `embeddable` | Boolean | Cho phép nhúng video trên các trang khác (mặc định `true`) | | `license` | String | `youtube` (mặc định) hoặc `creativeCommon` | | `defaultLanguage` | String | Mã ngôn ngữ BCP-47 cho metadata video (ví dụ `"en"`, `"vi"`) | | `defaultAudioLanguage` | String | Mã ngôn ngữ BCP-47 cho bản audio của video | | `thumbnail` | File | Thumbnail tùy chỉnh dạng file nhị phân (JPG/PNG/GIF/BMP, ≤ 2 MB; không hỗ trợ trên Shorts) | | `thumbnail_url` | String | Thumbnail tùy chỉnh qua URL công khai (cùng yêu cầu định dạng như `thumbnail`) | | `youtube_subtitle_file` | File | File phụ đề SRT hoặc VTT để tải lên | | `youtube_subtitle_language` | String | Mã BCP-47 cho track phụ đề, **bắt buộc** khi đặt `youtube_subtitle_file` | | `youtube_subtitle_name` | String | Tên hiển thị của track phụ đề | | `youtube_title` | String | Tiêu đề video (≤ 100 ký tự), xem [Giới hạn ký tự](/vi/concepts/posts) | | `youtube_description` | String | Mô tả video (≤ 5.000 ký tự), xem [Giới hạn ký tự](/vi/concepts/posts) | ```bash theme={null} -F "privacyStatus=unlisted" \ -F "tags[]=tutorial" \ -F "tags[]=coffee" \ -F "categoryId=26" \ -F "thumbnail=@./thumb.jpg" \ -F "youtube_subtitle_file=@./captions.srt" \ -F "youtube_subtitle_language=vi" \ -F "youtube_subtitle_name=Tiếng Việt" ``` ## Pinterest | Field | Kiểu | Tác dụng | | --------------------------- | ------ | ------------------------------------------------------------------- | | `pinterest_board_id` | String | **Bắt buộc**: mọi pin phải thuộc một board | | `pinterest_link` | String | URL đích mà pin dẫn đến | | `pinterest_alt_text` | String | Alt text hỗ trợ tiếp cận cho ảnh | | `pinterest_cover_image_url` | String | URL ảnh bìa cho video pin | | `pinterest_title` | String | Tiêu đề pin (≤ 100 ký tự), xem [Giới hạn ký tự](/vi/concepts/posts) | | `pinterest_description` | String | Mô tả pin (≤ 500 ký tự), xem [Giới hạn ký tự](/vi/concepts/posts) | ```bash theme={null} -F "pinterest_board_id=123456789" \ -F "pinterest_link=https://example.com/product" \ -F "pinterest_alt_text=Ảnh flat-lay sản phẩm mới của chúng tôi" ``` ## Reddit | Field | Kiểu | Tác dụng | | ----------------------- | ------- | --------------------------------------------------------------------------------------------------------------------- | | `subreddit` | String | **Bắt buộc**: subreddit đích, không có tiền tố `r/` | | `reddit_title` | String | Tiêu đề bài đăng, riêng biệt với phần thân; dùng `caption` nếu không truyền, xem [Giới hạn ký tự](/vi/concepts/posts) | | `flair_id` | String | Id flair để gán cho bài đăng | | `first_comment_media[]` | File(s) | Ảnh đính kèm bình luận đầu tiên (chỉ Reddit), xem [Bình luận đầu tiên](/vi/concepts/posts) | ```bash theme={null} -F "subreddit=coffee" \ -F "reddit_title=Rang cà phê tại nhà — lần đầu thử" \ -F "flair_id=abc123" \ -F "first_comment_media[]=@./roast-detail.jpg" ``` ## X (Twitter) | Field | Kiểu | Tác dụng | | ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `poll_options[]` | Array | 2-4 lựa chọn cho poll, mỗi mục ≤ 25 ký tự, không dùng được cùng `quote_tweet_id` | | `poll_duration` | Integer | Thời gian poll tính bằng phút (5-10.080; mặc định `1440` = 24 giờ) | | `reply_settings` | String | Ai có thể trả lời: `following`, `mentionedUsers`, `subscribers` hoặc `verified` | | `quote_tweet_id` | String | Quote một tweet có sẵn bằng id (không dùng được cùng media) | | `reply_to_id` | String | Đăng tweet dưới dạng reply cho tweet id này | | `community_id` | String | Đăng vào một X Community cụ thể | | `x_long_text_as_post` | Boolean | Đăng văn bản dài thành một post duy nhất (X Premium) thay vì tự tách thành thread (mặc định `false`) | | `x_thread_image_layout` | String | Danh sách phân cách bằng dấu phẩy, mỗi số cho biết bao nhiêu ảnh xuất hiện trong từng tweet của thread (mỗi giá trị 0-4, tổng phải bằng số ảnh), ví dụ `"0,4"` | | `tagged_user_ids[]` | Array | Tag tối đa 10 người dùng trong media bằng user id của họ | | `geo_place_id` | String | Đính kèm id địa điểm địa lý vào bài đăng | X loại bỏ mọi URL sẽ trở thành liên kết bấm được khỏi nội dung bài trước khi đăng. Xem [Giới hạn ký tự](/vi/concepts/posts). Hãy để link trong bio của profile hoặc trong ảnh/video. ```bash theme={null} -F "poll_options[]=Rang nhẹ" \ -F "poll_options[]=Rang đậm" \ -F "poll_options[]=Không có ý kiến" \ -F "poll_duration=4320" \ -F "reply_settings=following" ``` ## Threads | Field | Kiểu | Tác dụng | | ----------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `threads_long_text_as_post` | Boolean | Đăng văn bản dài thành một post duy nhất thay vì tự tách thành thread (mặc định `false`) | | `threads_thread_media_layout` | String | Danh sách phân cách bằng dấu phẩy, mỗi số cho biết bao nhiêu media xuất hiện trong từng post của thread (mỗi giá trị 0-10, tổng phải bằng số file), ví dụ `"0,5"` | | `threads_topic_tag` | String | Một topic tag, 1-50 ký tự, không chứa `"."` hoặc `"&"`, giúp tăng tiếp cận | ```bash theme={null} -F "threads_topic_tag=coffeetime" \ -F "threads_long_text_as_post=true" ``` ## LinkedIn | Field | Kiểu | Tác dụng | | ------------------------- | ------ | ----------------------------------------------------------------------------- | | `visibility` | String | Phạm vi hiển thị bài đăng (`PUBLIC`) | | `target_linkedin_page_id` | String | Đăng lên trang tổ chức thay vì profile cá nhân | | `linkedin_link_url` | String | Link đính kèm bài đăng | | `linkedin_first_comment` | String | Tự động đăng bình luận đầu tiên, xem [Bình luận đầu tiên](/vi/concepts/posts) | ```bash theme={null} -F "target_linkedin_page_id=urn:li:organization:12345678" \ -F "linkedin_link_url=https://example.com/launch" \ -F "visibility=PUBLIC" ``` ## Bluesky | Field | Kiểu | Tác dụng | | ------------------ | ------ | ---------------------- | | `bluesky_link_url` | String | Link đính kèm bài đăng | ```bash theme={null} -F "bluesky_link_url=https://example.com/post" ``` ## Google Business Bài đăng Google Business Profile xuất hiện trên Google Maps và trong kết quả Tìm kiếm của doanh nghiệp bạn. Tiền tố `gbp_` áp dụng cho tất cả các tùy chọn của nền tảng này. | Field | Kiểu | Tác dụng | | ----------------- | ------ | --------------------------------------------------------------------- | | `gbp_topic_type` | String | `STANDARD` (mặc định), `EVENT` hoặc `OFFER` | | `gbp_cta_type` | String | Nút CTA: `BOOK`, `ORDER`, `SHOP`, `LEARN_MORE`, `SIGN_UP` hoặc `CALL` | | `gbp_cta_url` | String | URL cho nút CTA, bắt buộc khi đặt `gbp_cta_type` | | `gbp_location_id` | String | Địa điểm sẽ đăng lên, tự động chọn khi tài khoản chỉ có một địa điểm | **Các field cho sự kiện** (khi `gbp_topic_type=EVENT`): | Field | Kiểu | Tác dụng | | ---------------------- | ------ | ------------------------------------------------------- | | `gbp_event_title` | String | **Bắt buộc**: tên sự kiện | | `gbp_event_start_date` | String | **Bắt buộc**: ngày bắt đầu theo định dạng `YYYY-MM-DD` | | `gbp_event_end_date` | String | **Bắt buộc**: ngày kết thúc theo định dạng `YYYY-MM-DD` | | `gbp_event_start_time` | String | Giờ bắt đầu theo định dạng 24 giờ `HH:MM` | | `gbp_event_end_time` | String | Giờ kết thúc theo định dạng 24 giờ `HH:MM` | **Các field cho ưu đãi** (khi `gbp_topic_type=OFFER`): | Field | Kiểu | Tác dụng | | ----------------- | ------ | --------------------------------- | | `gbp_coupon_code` | String | Mã phiếu giảm giá hoặc khuyến mãi | | `gbp_redeem_url` | String | URL để đổi ưu đãi | | `gbp_terms` | String | Nội dung điều khoản và điều kiện | ```bash theme={null} # Bài đăng tiêu chuẩn có CTA -F "gbp_topic_type=STANDARD" \ -F "gbp_cta_type=LEARN_MORE" \ -F "gbp_cta_url=https://example.com/menu" # Bài đăng sự kiện -F "gbp_topic_type=EVENT" \ -F "gbp_event_title=Khai trương cơ sở mới" \ -F "gbp_event_start_date=2025-09-01" \ -F "gbp_event_end_date=2025-09-01" \ -F "gbp_event_start_time=09:00" \ -F "gbp_event_end_time=17:00" ``` ## Telegram & Discord Telegram và Discord kết nối qua credentials thủ công thay vì OAuth, và chỉ nhận `caption` / `title` dùng chung. Không có tùy chọn sáng tạo bổ sung và không trả về dữ liệu analytics. Văn bản vượt quá giới hạn nền tảng sẽ bị **cắt bớt**, không bị từ chối, nên hãy giữ caption trong giới hạn ghi ở [Giới hạn ký tự](/vi/concepts/posts): * **Telegram**: 4.096 ký tự cho tin nhắn văn bản thuần; 1.024 ký tự cho caption kèm media. * **Discord**: 2.000 ký tự.