Chuyển đến nội dung chính

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:
HeaderGiá trị
X-Twitter-OAuth1-Api-KeyAPI Key (Consumer Key) của bạn
X-Twitter-OAuth1-Api-SecretAPI Key Secret (Consumer Secret) của bạn
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.
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 GuidelinesX 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
Các tùy chọn X là các trường tùy chọn có thể được sử dụng để kiểm soát bài đăng.
altText
array of strings
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.
blockCountries
array of strings
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.
allowCountries
array of strings
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.
longPost
boolean
mặc định:false
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.
longVideo
boolean
mặc định:false
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.
poll
object
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.
quoteTweetId
string
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.
replySettings
string
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.
subscribersOnly
boolean
mặc định:false
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.
subTitleUrl
string
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.
subTitleLanguage
string
mặc định:"en"
Ngôn ngữ của phụ đề. Phải là mã ngôn ngữ hợp lệ.
subTitleName
string
Tên của track caption. Tối đa 150 ký tự.
thumbNail
string
Đặ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.
videoTitle
string
Đặ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.
videoDescription
string
Đặ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.
thread
boolean
mặc định:false
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.
threadNumber
boolean
mặc định:false
Tự động thêm số ở cuối các thread theo định dạng 1/n.Yêu cầu thread: true.
mediaUrls
array of strings
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ụng altText trong đối tượng twitterOptions.
X Alt Text
Mỗi alt text phải tương ứng với một hình ảnh trong mảng 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ố blockCountriesallowCountries 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.
Bạn chỉ được sử dụng một trong các tham số 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ố body longPost. Đ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
Tuy nhiên, nếu một người dùng không có tài khoản Premium cố gắng đăng một tweet dài, hệ thống sẽ trả về lỗi 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.
Vui lòng xác minh rằng tài khoản X của người dùng của bạn là Premium hoặc trong Amplify Partner Program trước khi sử dụng tham số longVideo. Nếu tài khoản X của người dùng không được cấp phép đăng video dài, hệ thống sẽ trả về lỗi.
Sử dụng tham số twitterOptions longVideo 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
Vui lòng xem lại các quy tắc quan trọng về nhắc tên.

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
Tham số 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ường subTitleUrl 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ằng https:// và kết thúc bằng .srt và 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ụng thumbNail 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ường videoTitlevideoDescription 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. X Thread

Đă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/5
  • mediaUrls: [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ự.
Nếu bài đăng được gửi dưới dạng X Thread, phân tích bài đăng được trả về sẽ là một mảng các Tweet, "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ụng null 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
Trong ví dụ này, Tweet đầu tiên sẽ chứa photo-1.jpg, Tweet thứ hai photo-2.jpg và photo-3.jpg, và Tweet thứ ba photo-4.jpg.

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
sẽ dẫn đến hai Tweet trong thread. Nếu bạn muốn thêm đoạn văn nhưng không chia thành các Tweet, hãy sử dụng \u2063\n\u2063\n
X Thread with Paragraphs
sẽ dẫn đến một Tweet với hai đoạn văn vì bài đăng dưới 280 ký tự.

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. Adobe Media Encoder Vui lòng xem tại đây để biết thêm ví dụ về X API.

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
Tham số 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.