Bài đăng

​

Chọn endpoint theo loại media

​

Số ảnh mỗi bài

​

Phân phối với platforms[]

curl -X POST https://api.madiad.com/v1/posts/photos \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Idempotency-Key: 9f1c2e7a-4b6d-4e2a-9c10-7b3f8d5a1e22" \
  -F "profile_id=prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z" \
  -F "platforms[]=instagram" \
  -F "platforms[]=facebook" \
  -F "platforms[]=tiktok" \
  -F "caption=New blend dropping today" \
  -F "photos[]=@./launch.jpg"

​

Đăng ảnh bằng URL

curl -X POST https://api.madiad.com/v1/posts/photos \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3ab77c14-08e5-4d69-b2f1-6c5904ad7e83" \
  -d '{
    "profile_id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
    "platforms": ["instagram", "facebook"],
    "caption": "New blend dropping today",
    "photo_urls": [
      "https://cdn.example.com/launch-1.jpg",
      "https://cdn.example.com/launch-2.jpg"
    ]
  }'

• Mỗi URL phải là link ảnh trực tiếp, công khai, dùng https:// (hostname, không dùng địa chỉ IP). Link trang chia sẻ mở ra một trang web (ví dụ trang xem của drive) sẽ bị từ chối kèm thông báo lỗi rõ ràng. Hãy dùng URL file trực tiếp. Redirect được theo tối đa 5 bước, nhưng mọi bước đều phải là https://.
• Tối đa 40 URL mỗi request, 30 MB mỗi ảnh và tổng 120 MB.
• Cũng dùng được trong multipart: gửi photo_urls[] dưới dạng field text, và trộn thoải mái với photos[] dạng file trong cùng một request. Với carousel, file tải lên đứng trước, rồi tới ảnh từ URL, mỗi nhóm theo thứ tự gửi.

​

Ghi đè theo từng nền tảng

  -F "caption=New blend dropping today" \
  -F "instagram_caption=New blend dropping today ☕ #specialtycoffee" \
  -F "x_caption=New blend out now →"

​

Giới hạn ký tự

• Đăng nhiều nền tảng cùng lúc? caption chỉ bị từ chối ngay khi nó dài hơn giới hạn của mọi nền tảng được chọn. Nếu vừa với ít nhất một nền tảng, request vẫn chạy và mỗi nền tảng trả kết quả riêng, nên hãy đặt <platform>_caption cho nền tảng có giới hạn chặt hơn.
• Phần ghi đè theo từng nền tảng cũng được kiểm tra, với những nền tảng có giới hạn cứng: Instagram, LinkedIn, TikTok, YouTube, Reddit, Pinterest và Google Business. Một <platform>_title (hoặc <platform>_caption) vượt giới hạn (ví dụ tiktok_title > 90 cho bài ảnh, reddit_title > 300, hay instagram_caption > 2.200) sẽ bị báo lỗi rõ ràng trước khi đăng. X, Threads và Bluesky không kiểm trước vì chúng tự tách thành chuỗi bài thay vì từ chối; Telegram và Discord thì cắt bớt; còn ghi đè cho Facebook chỉ bị giới hạn ở Reels. Những trường hợp này được gửi thẳng tới nền tảng và tự báo kết quả riêng.
• Link trên X. Mọi URL mà X biến thành liên kết bấm được sẽ bị gỡ khỏi bài X trước khi đăng. Hãy để link trong hồ sơ hoặc trong ảnh/video.

​

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

​

Bình luận đầu tiên (first comment)

  -F "caption=New blend dropping today" \
  -F "first_comment=Mua ngay tại 👉 link trong bio" \
  -F "instagram_first_comment=Bấm link trong bio ☕ #specialtycoffee"

• X và Threads: đăng dưới dạng reply cho bài. Với bài X tự tách chuỗi, nó reply vào tweet cuối của chuỗi.
• YouTube: đăng thành bình luận cấp cao nhất dưới video.
• Instagram: chỉ áp dụng cho bài ảnh và video (Instagram không có bài chỉ văn bản).

  -F "first_comment=Bộ ảnh chi tiết bên dưới 👇" \
  -F "first_comment_media[]=@./detail-1.jpg" \
  -F "first_comment_media[]=@./detail-2.jpg"

​

Caption sinh bằng AI

  -F "autogenerate=true" \
  -F "autogenerate_language=vi"

​

Yêu cầu của từng nền tảng

​

Đọc response

{
  "status": "processing",
  "profile_id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
  "platforms": ["instagram", "facebook", "tiktok"],
  "request_id": "req_01HZX9H6S8T0V2W4X6Y8Z0A2B4",
  "job_id": null,
  "results": null
}

• completed: đã xuất bản đồng bộ, results chứa kết quả theo từng nền tảng.
• processing: đang tải lên (thường gặp với video). Poll bằng request_id, hoặc đăng ký webhooks.
• scheduled: đã lên lịch cho thời điểm tương lai, poll bằng job_id.
• partial: một số nền tảng đã đăng thành công và ít nhất một nền tảng bị từ chối, kiểm tra từng mục trong results.
• failed: tất cả nền tảng nhắm tới đều từ chối bài đăng. Mã HTTP vẫn là 200, lý do theo từng nền tảng nằm trong results.
• unknown: chưa xác định được kết quả trong thời gian chờ (trả về HTTP 502 với mã upstream_timeout). Bài có thể đã lên, đừng retry ngay; xem Lỗi và Idempotency.

{
  "results": {
    "instagram": { "success": true, "publish_id": "17912345678901234", "url": "https://instagram.com/p/abc123" },
    "tiktok":    { "success": false, "error": "TikTok đã nhận 15/15 bài trong 24 giờ qua…", "error_code": "daily_cap_reached" }
  }
}

​

Kiểm tra trạng thái sau

curl "https://api.madiad.com/v1/posts/status?request_id=req_01HZX9H6S8T0V2W4X6Y8Z0A2B4" \
  -H "Authorization: Bearer $MADIAD_API_KEY"