Tùy chọn theo nền tảng

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 (<platform>_<field>). 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ự
`tiktok_description`	String	Caption dài cho bài ảnh (≤ 4.000 ký tự), xem Giới hạn ký tự

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í.

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

  -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

facebook_page_id bị bỏ qua khi Profile đang ghim một Page: bài vẫn đi tới Page đã ghim và vẫn báo thành công. Xem Ghim một Page vào Profile.

Để đă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.

  -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ự
`youtube_description`	String	Mô tả video (≤ 5.000 ký tự), xem Giới hạn ký tự

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

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ự
`pinterest_description`	String	Mô tả pin (≤ 500 ký tự), xem Giới hạn ký tự

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

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ự
`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

  -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ự. Hãy để link trong bio của profile hoặc trong ảnh/video.

  -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

  -F "threads_topic_tag=coffeetime" \
  -F "threads_long_text_as_post=true"

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

  -F "target_linkedin_page_id=urn:li:organization:12345678" \
  -F "linkedin_link_url=https://example.com/launch" \
  -F "visibility=PUBLIC"

target_linkedin_page_id nhận URN đầy đủ dạng urn:li:organization:…. Liệt kê các tổ chức mà một Profile đăng bài được bằng GET /v1/connections/linkedin/pages, xem LinkedIn Pages. Trường này bị bỏ qua khi Profile đang ghim một trang tổ chức, xem Ghim một Page vào Profile.

Bluesky

Field	Kiểu	Tác dụng
`bluesky_link_url`	String	Link đính kèm bài đăng

  -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

# 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"

Kênh nhập thông tin thủ công

Mười một kênh được kết nối bằng cách dán thông tin xác thực của chính bạn thay vì qua OAuth. Xem Kênh để biết danh sách trường và endpoint kết nối. Chúng chỉ nhận caption / title dùng chung: không có tuỳ chọn sáng tạo bổ sung, và không kênh nào trả về dữ liệu analytics. Nhiều kênh trong nhóm này chỉ nhận một loại bài. Gửi sai loại sẽ bị từ chối tại chỗ bằng 400 invalid_request trước khi có gì được đăng. Bảng ở Kênh là chỗ tra.

Kênh chat

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ự:

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ự.
Slack: chỉ nhận bài chữ.

Fediverse

Mastodon: nhận chữ, ảnh và video. Giới hạn mỗi bài do chính máy chủ bạn kết nối quy định (phần lớn là 500 ký tự, nhưng máy chủ có thể nới), nên Hub không kiểm trước.
Lemmy: nhận chữ và ảnh. caption dùng chung sẽ thành tiêu đề bài; cộng đồng đích được cố định lúc kết nối.
Nostr: chỉ nhận bài chữ, phát tới các relay bạn khai lúc kết nối.

Kênh xuất bản

WordPress: nhận chữ, ảnh và video. caption dùng chung sẽ thành tiêu đề bài.
dev.to, Hashnode: chỉ nhận bài chữ; caption dùng chung thành tiêu đề bài viết.
Whop: chỉ nhận bài chữ, đăng vào experience bạn khai lúc kết nối.
listmonk: chỉ nhận bài chữ, gửi tới danh sách bạn khai lúc kết nối. Kênh này gửi email thật tới người nhận thật, hãy thử với một danh sách nhỏ trước.

Bắt đầu

Khái niệm

Tích hợp

Tham chiếu API

Tùy chọn theo nền tảng

TikTok

Instagram

Facebook

YouTube

Pinterest

Reddit

X (Twitter)

Threads

LinkedIn

Bluesky

Google Business

Kênh nhập thông tin thủ công

Kênh chat

Fediverse

Kênh xuất bản

​TikTok

​Instagram

​Facebook

​YouTube

​Pinterest

​Reddit

​X (Twitter)

​Threads

​LinkedIn

​Bluesky

​Google Business

​Kênh nhập thông tin thủ công

​Kênh chat

​Fediverse

​Kênh xuất bản

TikTok

Instagram

Facebook

YouTube

Pinterest

Reddit

X (Twitter)

Threads

LinkedIn

Bluesky

Google Business

Kênh nhập thông tin thủ công

Kênh chat

Fediverse

Kênh xuất bản