Skip to main content
PUT
Lên lịch hàng loạt bài đăng bằng tệp CSV (Comma Separated Values) chứa dữ liệu các bài đăng. Content-Type phải là multipart/form-data.
Chúng tôi khuyến nghị sử dụng endpoint Post trực tiếp thay vì phương thức bulk này để lên lịch bài đăng. Endpoint trực tiếp cung cấp bộ tính năng toàn diện hơn và khả năng gỡ lỗi dễ dàng hơn.

Tham số Header

string
bắt buộc
Định dạng: Authorization: Bearer API_KEY. Xem tổng quan API để biết thêm thông tin.
string
Profile Key của một user profile.
string
bắt buộc
Content-Type: multipart/form-data

Tham số Body

object
Tệp CSV multipart form-data chứa các bài đăng đã lên lịch. Xem bên dưới để biết mẫu CSV.

Ví dụ Request

Một multipart form-data chứa tệp CSV các bài đăng sẽ lên lịch chúng cho một ngày trong tương lai. Tệp CSV chứa các trường sau (mẫu bên dưới) và đều bắt buộc:
  • post: Nội dung bài đăng.
  • platforms: Danh sách các nền tảng phân tách bằng dấu phẩy, ví dụ: “twitter, facebook, instagram”.
  • mediaUrls: URL của phương tiện, chẳng hạn như hình ảnh hoặc video để bao gồm trong bài đăng.
  • scheduleDate: Thời gian lên lịch bài đăng theo định dạng UTC. Ví dụ, dùng định dạng YYYY-MM-DDThh:mm:ssZ và gửi dưới dạng 2026-07-08T12:30:00Z. Vui lòng xem utctime để biết thêm ví dụ.
Không lên lịch các bài đăng trùng lặp cách nhau chưa đến 24 giờ.Mỗi bài đăng sẽ được kiểm tra trong khung 48 giờ lấy chính scheduleDate của nó làm tâm — 24 giờ trước và 24 giờ sau. Nếu trong khung đó có một bài đăng khác với nội dung giống hệt hoặc gần giống, bài đăng sẽ bị từ chối với lỗi 137. Khung này nhìn cả về phía trước lẫn phía sau, nên một dòng có thể bị từ chối vì một dòng được lên lịch sau nó. Việc kiểm tra diễn ra ngay khi bài đăng được gửi hoặc lên lịch, chứ không chỉ ngay trước khi đăng. Điều này nhằm bảo vệ tài khoản của bạn tại các mạng xã hội; họ có thể tạm ngưng hoặc shadow-ban các tài khoản đăng trùng lặp thường xuyên.

Mẫu CSV

Tải xuống mẫu và lưu dưới dạng tệp .csv. Mẫu CSV Ayrshare