X BYO API Keys
Bắt đầu từ ngày 31 tháng 3 năm 2026, tất cả các thao tác X/Twitter đều yêu cầu thông tin xác thực API của riêng bạn. Sau khi liên kết tài khoản X qua OAuth, hãy bao gồm 2 header sau trong mỗi yêu cầu nhắm đến X:
Chưa liên kết? Xem Hướng dẫn thiết lập X BYO Key để kết nối tài khoản X của bạn.
| Header | Giá trị |
|---|---|
X-Twitter-OAuth1-Api-Key | API Key (Consumer Key) của bạn |
X-Twitter-OAuth1-Api-Secret | API Key Secret (Consumer Secret) của bạn |
Ayrshare không còn áp đặt giới hạn tốc độ X/Twitter hàng tháng hoặc hàng ngày của riêng mình nữa. Vì các yêu cầu X sử dụng
thông tin xác thực của riêng bạn (BYO), việc sử dụng của bạn chỉ được điều chỉnh bởi các giới hạn X Developer App của riêng bạn. Xem
tài liệu về giới hạn tốc độ X API để biết chi tiết.
Đăng bài lên X (Twitter)
JSON cho một bài đăng cơ bản với liên kết và hình ảnh bằng X API, trước đây được gọi là Twitter API:X Post
- X sẽ tự động xem trước liên kết trong Tweet trừ khi có hình ảnh hoặc video đi kèm. Trong ví dụ trên, hình ảnh sẽ hiển thị. Việc bỏ hình ảnh sẽ khiến bản xem trước liên kết hiển thị.
- Nếu video của bạn không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số
isVideo. Xem endpoint /post để biết chi tiết. - X cũng hỗ trợ gửi phương tiện mà không có nội dung bài đăng. Nếu bạn không muốn bao gồm nội dung bài đăng, hãy gửi
một chuỗi rỗng
post: "". - Bạn có thể tải lên tối đa 4 hình ảnh hoặc video trong một Tweet duy nhất. Vui lòng xem các hướng dẫn và hạn chế quan trọng về đăng video Twitter.
- Xem X Media Guidelines và X Authorization để biết thêm thông tin.
Tùy chọn X
Bạn có thể đặt các tùy chọn bổ sung cho bài đăng bằng cách sử dụng tham sốtwitterOptions.
X Options
Văn bản thay thế cho hình ảnh để hỗ trợ khả năng tiếp cận và trình đọc màn hình. Tối đa 1.000 ký tự cho mỗi alt text.Xem Alt Text để biết thêm thông tin.
Hạn chế phương tiện đến các quốc gia cụ thể bằng cách chặn một số khu vực. Sử dụng mã quốc gia.Không thể sử dụng với
allowCountries. Xem Geo Restrictions để biết thêm thông tin.Hạn chế phương tiện đến các quốc gia cụ thể bằng cách cho phép một số khu vực. Sử dụng mã quốc gia.Không thể sử dụng với
blockCountries. Xem Geo Restrictions để biết thêm thông tin.Bật đăng bài dài hơn với tối đa 25.000 ký tự cho người dùng Premium.Xem Long Post để biết thêm thông tin.
Cho phép đăng video dài hơn 2 phút 20 giây cho các tài khoản được chấp thuận.Xem Long Video để biết thêm thông tin.
Thực hiện các cuộc thăm dò với tùy chọn tùy chỉnh và thời lượng.Các trường bắt buộc:
duration (số phút), options (mảng chuỗi).Xem Polls để biết thêm thông tin.Trích dẫn một tweet khác bằng cách chỉ định Tweet ID.Xem Quote Tweet để biết thêm thông tin.
Kiểm soát ai có thể trả lời bài đăng.Các giá trị:
following, mentioned, subscribers, hoặc verified.Xem Reply Settings để biết thêm thông tin.Làm cho bài đăng chỉ hiển thị với người đăng ký.Xem Subscribers Only để biết thêm thông tin.
Thêm phụ đề/caption vào video bằng file SRT. Phải là URL file SRT hợp lệ kết thúc bằng
.srt.Xem Phụ đề / Caption cho video để biết thêm thông tin.Ngôn ngữ của phụ đề. Phải là mã ngôn ngữ hợp lệ.
Tên của track caption. Tối đa 150 ký tự.
Đặt thumbnail (hình ảnh bìa) cho video. Phải là URL đến file hình ảnh JPEG, PNG, BMP, hoặc WebP.Xem Video Thumbnail để biết thêm thông tin và X Media Guidelines để biết yêu cầu hình ảnh.
Đặt tiêu đề cho một video. Ánh xạ đến trường tiêu đề trong X Media Studio.Xem Metadata video để biết thêm thông tin.
Đặt mô tả cho một video. Ánh xạ đến trường mô tả trong X Media Studio.Xem Metadata video để biết thêm thông tin.
Chia các bài đăng dài thành chuỗi thread được kết nối với đánh số và phương tiện tùy chọn.Xem Threads để biết thêm thông tin.
Tự động thêm số ở cuối các thread theo định dạng 1/n.Yêu cầu
thread: true.Thêm các đối tượng phương tiện vào các thread. Một đối tượng phương tiện sẽ được thêm vào mỗi thread theo thứ tự.Sử dụng
null để bỏ qua phương tiện cho một thread cụ thể. Sử dụng các đối tượng với nhiều URL để nhiều phương tiện cho mỗi thread.Alt Text
Thêm văn bản thay thế, còn được gọi là alt text, cho hình ảnh của Tweet. Alt text X là một tính năng trợ năng được sử dụng cho thông tin bổ sung của người dùng và trình đọc màn hình. Sử dụngaltText trong đối tượng twitterOptions.
X Alt Text
mediaUrls. Alt text sẽ được áp dụng cho từng hình ảnh theo thứ tự.
Alt text không thể được áp dụng cho video. Nếu một video được bao gồm trong
mediaUrls với altText,
video sẽ không được đăng. Alt text phải là 1.000 ký tự trở xuống.Giới hạn địa lý
Bạn có thể hạn chế phương tiện X, chẳng hạn như hình ảnh hoặc video, đến các quốc gia cụ thể bằng cách sử dụng tham sốblockCountries và allowCountries với mã quốc gia.
Bài đăng sẽ vẫn hiển thị ở tất cả các quốc gia, nhưng phương tiện sẽ không có sẵn ở các quốc gia được chỉ định.
blockCountries: Một mảng mã quốc gia để chặn. Xem mã quốc gia.allowCountries: Một mảng mã quốc gia để cho phép. Xem mã quốc gia.
blockCountries hoặc allowCountries tại một thời điểm.
Nếu cả hai tham số được sử dụng hoặc một quốc gia không được X hỗ trợ, các hạn chế địa lý sẽ bị bỏ qua.
Bài đăng dài
Người dùng có tài khoản X Premium, chẳng hạn như Premium hoặc Premium Plus, có khả năng đăng các bài đăng dài hơn lên đến 25.000 ký tự. Ayrshare tự động cho phép các bài đăng dạng dài cho người dùng có tài khoản X Premium. Nếu người dùng thay đổi trạng thái X Premium của họ, vui lòng đợi 24 giờ để nó phản ánh trong Ayrshare. Bạn có thể kiểm tra trạng thái đăng ký Premium của một người dùng với các endpoint /user hoặc /analytics. Bạn cũng có thể buộc chấp nhận một bài đăng dạng dài với tham số bodylongPost. Điều này có thể được thực hiện bằng cách bao gồm JSON sau trong yêu cầu của bạn:
X Long Post
code: 111.
Video dài
Yêu cầu Business hoặc Enterprise Plan. X yêu cầu các video có độ dài video tối đa là 2 phút 20 giây. Tuy nhiên, nếu bạn đã được X chấp thuận để tải lên các video dài hơn, chẳng hạn như tài khoản X của người dùng là tài khoản Premium hoặc trong Amplify Partner Program, bạn có thể đăng video có độ dài lên đến hơn 10 phút. Sử dụng tham số twitterOptionslongVideo khi đăng một video dài:
X Long Video
Nhắc tên (Mentions)
Nhắc tên một handle X khác bằng cách thêm@handle vào nội dung bài đăng. Ví dụ:
X Mention
Cuộc thăm dò (Polls)
Thực hiện một cuộc thăm dò X với tham sốpoll của twitterOptions.
X Poll
duration: Số phút chỉ định thời lượng thực hiện cuộc thăm dò.options: Một mảng chuỗi các tùy chọn của cuộc thăm dò.
Trích dẫn Tweet (Quote Tweet)
Bạn có thể trích dẫn một Tweet khác bằng cách chỉ định Tweet ID cấp thấp. ID có thể được truy xuất qua phản hồi/post trong trường postIds, get history, hoặc trực tiếp từ URL Tweet: https://twitter.com/Ayrshare/status/1651601430669664256
X Quote Tweet
Cài đặt trả lời
Bạn có thể đặt cài đặt trả lời cho một bài đăng để chỉ cho phép trả lời bởi một số loại người dùng nhất định.X Reply Settings
replySettings có thể là một trong các giá trị sau:
following: Chỉ những người dùng mà tài khoản X đang theo dõi có thể trả lời.mentioned: Chỉ những người dùng được nhắc tên trong bài đăng có thể trả lời.subscribers: Chỉ những người dùng là người đăng ký của tài khoản X đã đăng bài đăng mới có thể trả lời.verified: Chỉ những người dùng được xác minh trên X mới có thể trả lời bài đăng.
Chỉ dành cho người đăng ký (Subscribers Only)
Bạn có thể đặt bài đăng chỉ hiển thị với người đăng ký bằng cách sử dụng tham sốsubscribersOnly.
X Subscribers Only
Phụ đề / Caption cho video
Bạn có thể thêm phụ đề X, còn được gọi là caption X, cho các video bằng cách bao gồm một file SRT. Sử dụng trườngsubTitleUrl trong đối tượng twitterOptions để chỉ định URL đến file SRT của bạn.
X Subtitles
subTitleUrl: Một file SRT hợp lệ. URL phải bắt đầu bằnghttps://và kết thúc bằng.srtvà là một file SRT hợp lệ.subTitleLanguage: Tùy chọn: Ngôn ngữ của phụ đề. Phải là một mã ngôn ngữ hợp lệ. Mặc định: “en”.subTitleName: Tùy chọn: Tên của track caption. Tên nhằm hiển thị cho người dùng dưới dạng tùy chọn trong quá trình phát lại. Độ dài tên tối đa được hỗ trợ là 150 ký tự. Mặc định: “English”.
Thumbnail video
Đặt thumbnail (hình ảnh bìa) cho video Twitter/X. Thumbnail được hiển thị trước khi video phát và giúp người dùng hiểu nội dung video. Sử dụngthumbNail trong đối tượng twitterOptions.
Twitter/X Video Thumbnail
- “thumbNail”: Một URL đến hình ảnh thumbnail. Các định dạng hình ảnh được hỗ trợ là JPEG, PNG, BMP, và WebP.
- Hình ảnh thumbnail nên đại diện cho nội dung video và có sức hấp dẫn về mặt hình ảnh để khuyến khích sự tương tác.
- Xem X Media Guidelines để biết yêu cầu hình ảnh.
Metadata video
Đặt tiêu đề và mô tả cho một video được đăng lên X. Chúng ánh xạ đến các trường tiêu đề và mô tả trong X Media Studio. Sử dụng các trườngvideoTitle và videoDescription trong đối tượng twitterOptions.
X Video Metadata
videoTitle: Tiêu đề cho video, được ánh xạ đến trường tiêu đề X Media Studio.videoDescription: Mô tả cho video, được ánh xạ đến trường mô tả X Media Studio.
Kiếm tiền từ video (Pro Media)
Ayrshare hỗ trợ kiếm tiền từ video X (Twitter) cho các tài khoản đủ điều kiện thông qua chương trình Pro Media của X. Đây là khả năng truy cập giới hạn — liên hệ với chúng tôi nếu bạn muốn có quyền truy cập.Thread
Một X Thread, còn được gọi là tweetstorm, là một chuỗi các bài đăng được kết nối trên X (trước đây là Twitter) cho phép bạn chia sẻ các ý tưởng dài hơn giới hạn ký tự của một bài đăng đơn lẻ, xuất hiện như một câu chuyện liên tục khi xem cùng nhau.
Đăng một Thread
Một X Thread có thể được đăng qua API. Một thread là một bài đăng được chia thành một tập hợp các thread trả lời và được liên kết trong X bằng một đường thẳng. Bạn có thể tự động chia bài đăng hoặc chỉ định các điểm ngắt thread trong nội dung bài đăng.X Thread
thread: trueđể tự động chia nội dung bài đăng thành các thread dựa trên ngắt dòng.threadNumber: trueđể tự động thêm số ở cuối các thread theo định dạng 1/n. Ví dụ thread thứ 2 trong tổng 5 thread sẽ có thêm: 2/5mediaUrls: [array of urls]để thêm từng đối tượng phương tiện, một hình ảnh hoặc video, vào một thread theo thứ tự. Chỉ một đối tượng phương tiện sẽ được thêm vào một thread theo thứ tự.
"twitter": []. Xem Post Analytics 200 Response để biết thêm thông tin.
Thread Media
Bỏ qua phương tiện
Bỏ qua phương tiện cho thread bằng cách sử dụngnull trong mảng. Ví dụ:
["https://site.com/image1.png", null, "https://site.com/image2.png"]
Điều này sẽ đặt image1 lên Tweet đầu tiên, không có hình ảnh trên Tweet thứ hai, và image2 trên Tweet thứ ba.
Nhiều phương tiện
Nhiều đối tượng phương tiện có thể được thêm vào một Tweet trong một Thread bằng cách thêm một đối tượng{} với các URL phương tiện trong mảng mediaUrls. Bất kỳ khóa đối tượng duy nhất nào cũng có thể được sử dụng. Ví dụ:
X Thread with Multiple Media URLs
Thread Breaks
Ayrshare tự động chia nội dung bài đăng thành các tweet có độ dài phù hợp (> 280 ký tự). Khi tạo threads, chúng tôi ưu tiên giữ các câu hoàn chỉnh trong một bài đăng khi có thể. Nếu một câu không vừa, chúng tôi chia giữa các câu. Đối với những câu rất dài, chúng tôi chia giữa các từ. Trong những trường hợp hiếm hoi mà một từ quá dài, chúng tôi chia chính từ đó. Bạn cũng có thể thêm thủ công các đoạn văn với\n\n vào nội dung bài đăng để chỉ ra rằng một thread duy nhất nên được tạo.
Nếu bạn có \n\n trong nội dung bài đăng, chúng tôi sẽ không tự động chia bài đăng thành các thread.
Ví dụ:
Example X Thread
\u2063\n\u2063\n
X Thread with Paragraphs
Xóa một Thread
Để xóa một Tweet Storm, hãy gọi endpoint /post delete với ID bài đăng cấp cao nhất được trả về trong phản hồi. Tất cả các thread sẽ bị xóa.Giới hạn ký tự
Vui lòng xem Giới hạn ký tự X/Twitter để biết thêm thông tin.Khả năng tương thích video X
Một số phần mềm video tạo ra các file MP4 không tương thích với X. Ví dụ, các phiên bản Camtasia cũ hơn 2019.0.9 tạo ra các file MP4 mà X từ chối. Ngoài ra, nhiều hơn một track âm thanh thường gây ra vấn đề. Nếu bạn nhận lại thông báo sau trong khi đăng bài, điều đó cho biết video không tương thích với Twitter và cần được mã hóa lại."file is currently unsupported"
Vui lòng kiểm tra phần mềm video của bạn để biết khả năng tương thích. Ví dụ, Adobe Media Encoder có một preset xuất cho Twitter 1080p Full HD.

Chỉ dành cho người đăng ký (Subscribers Only)
Bạn có thể đặt bài đăng chỉ hiển thị với người đăng ký bằng cách sử dụng tham sốsubscribersOnly.
X Subscribers Only
Cài đặt trả lời
Bạn có thể đặt cài đặt trả lời cho một bài đăng để chỉ cho phép trả lời bởi một số loại người dùng nhất định.X Reply Settings
replySettings có thể là một trong các giá trị sau:
following: Chỉ những người dùng mà tài khoản X đang theo dõi có thể trả lời.mentioned: Chỉ những người dùng được nhắc tên trong bài đăng có thể trả lời.subscribers: Chỉ những người dùng là người đăng ký của tài khoản X đã đăng bài đăng mới có thể trả lời.verified: Chỉ những người dùng được xác minh trên X mới có thể trả lời bài đăng.
