X BYO API Keys
Починаючи з 31 березня 2026 року, всі операції X/Twitter вимагають Ваших власних API-облікових даних. Після зв’язування Вашого облікового запису X через OAuth, додавайте ці 2 заголовки в кожен запит, який спрямований на X:
Ще не пов’язані? Див. X BYO Key Setup Guide для під’єднання Вашого облікового запису X.
Ayrshare більше не накладає власних місячних або денних обмежень швидкості X/Twitter. Оскільки запити X використовують
Ваші власні облікові дані (BYO), Ваше використання регулюється лише лімітами Вашого власного X Developer App. Див.
документацію лімітів швидкості X API для деталей.
Публікація в X (Twitter)
JSON для базового допису з посиланням та зображенням за допомогою X API, раніше відомого як Twitter API:X Post
- X автоматично попередньо переглядає посилання в Tweet, якщо не включено зображення або відео. У наведеному вище прикладі буде показано зображення. Видалення зображення призведе до відображення попереднього перегляду посилання.
- Якщо Ваше відео не закінчується відомим розширенням відео, як mp4, будь ласка, використовуйте параметр
isVideo. Для деталей див. кінцеву точку /post. - X також підтримує надсилання медіа без тексту допису. Якщо Ви не хочете, щоб текст допису був включений,
надішліть порожній рядок
post: "". - Ви можете завантажити до 4 зображень або відео в одному Tweet. Будь ласка, див. важливі рекомендації та обмеження щодо публікації відео Twitter.
- Для отримання додаткової інформації див. X Media Guidelines та X Authorization.
Параметри X
Ви можете встановити додаткові параметри для допису, використовуючи параметрtwitterOptions.
X Options
Альтернативний текст для зображень, що допомагає з доступністю та програмами зчитування з екрана. Максимум 1 000 символів на alt text.Для отримання додаткової інформації див. Alt Text.
Обмежте медіа певними країнами, блокуючи певні регіони. Використовуйте коди країн.Не можна використовувати з
allowCountries. Для отримання додаткової інформації див. Geo Restrictions.Обмежте медіа певними країнами, дозволяючи певні регіони. Використовуйте коди країн.Не можна використовувати з
blockCountries. Для отримання додаткової інформації див. Geo Restrictions.Увімкнути публікацію довших дописів до 25 000 символів для користувачів Premium.Для отримання додаткової інформації див. Long Post.
Дозволити публікацію відео тривалістю понад 2 хвилини 20 секунд для затверджених облікових записів.Для отримання додаткової інформації див. Long Video.
Проводьте опитування з користувацькими параметрами та тривалістю.Обов’язкові поля:
duration (число в хвилинах), options (масив рядків).Для отримання додаткової інформації див. Polls.Цитуйте інший твіт, вказавши Tweet ID.Для отримання додаткової інформації див. Quote Tweet.
Керуйте тим, хто може відповідати на допис.Значення:
following, mentioned, subscribers або verified.Для отримання додаткової інформації див. Reply Settings.Зробіть допис видимим лише для передплатників.Для отримання додаткової інформації див. Subscribers Only.
Додайте субтитри/титри до відео за допомогою файлів SRT. Має бути дійсний URL файлу SRT, що закінчується на
.srt.Для отримання додаткової інформації див. Subtitles / Captions for Videos.Мова субтитрів. Має бути дійсним кодом мови.
Назва треку титрів. Максимум 150 символів.
Встановіть мініатюру (обкладинку) для відео. Має бути URL файлу зображення JPEG, PNG, BMP або WebP.Для отримання додаткової інформації див. Video Thumbnail та X Media Guidelines для вимог до зображень.
Встановіть заголовок для відео. Відображається у полі заголовка в X Media Studio.Для отримання додаткової інформації див. Video Metadata.
Встановіть опис для відео. Відображається у полі опису в X Media Studio.Для отримання додаткової інформації див. Video Metadata.
Розбийте довгі дописи на серії пов’язаних потоків з опціональною нумерацією та медіа.Для отримання додаткової інформації див. Threads.
Автоматично додавати номери в кінці потоків у форматі 1/n.Вимагає
thread: true.Додайте медіа-об’єкти до потоків. Один медіа-об’єкт буде додано до кожного потоку за порядком.Використовуйте
null, щоб пропустити медіа для конкретного потоку. Використовуйте об’єкти з кількома URL для кількох медіа на потік.Alt Text
Додайте альтернативний текст, також відомий як alt text, до зображення Tweet. X alt text — це функція доступності, що використовується для додаткової інформації користувача та програм зчитування з екрана. ВикористовуйтеaltText в об’єкті twitterOptions.
X Alt Text
mediaUrls. Alt text буде застосовано до кожного зображення за порядком.
Alt text не можна застосувати до відео. Якщо відео включено в
mediaUrls з altText,
відео не буде опубліковано. Alt text повинен бути 1 000 символів або менше.Geo Restrictions
Ви можете обмежити медіа X, наприклад зображення або відео, певними країнами, використовуючи параметриblockCountries та allowCountries з кодами країн.
Допис все одно буде показано в усіх країнах, але медіа не буде доступне у вказаних країнах.
blockCountries: Масив кодів країн для блокування. Див. коди країн.allowCountries: Масив кодів країн для дозволу. Див. коди країн.
blockCountries або allowCountries за раз.
Якщо використовуються обидва параметри або країна не підтримується X, геообмеження буде ігноровано.
Long Post
Користувачі з обліковими записами Premium X, такими як Premium або Premium Plus, мають можливість публікувати довші дописи до 25 000 символів. Ayrshare автоматично дозволяє довгі дописи для користувачів з обліковими записами Premium X. Якщо користувач змінює свій статус X Premium, будь ласка, зачекайте 24 години, щоб він відобразився в Ayrshare. Ви можете перевірити статус підписки Premium користувача за допомогою кінцевих точок /user або /analytics. Ви також можете примусово прийняти допис у довгій формі за допомогою параметра тілаlongPost. Це можна зробити, включивши наступний JSON у Ваш запит:
X Long Post
code: 111.
Long Video
Потрібен план Business або Enterprise. X вимагає, щоб відео мали максимальну тривалість 2 хвилини та 20 секунд. Однак, якщо Вас затвердив X для завантаження довших відео, наприклад, якщо обліковий запис користувача X є Premium або в програмі Amplify Partner, Ви можете публікувати відео тривалістю до 10+ хвилин. Використовуйте параметр twitterOptionslongVideo при публікації довгого відео:
X Long Video
Згадування
Згадайте інший handle X, додавши@handle у текст допису. Наприклад:
X Mention
Опитування
Проводьте X Poll за допомогою параметраpoll twitterOptions.
X Poll
duration: Кількість хвилин, що вказує тривалість проведення опитування.options: Масив рядків опцій опитування.
Quote Tweet
Ви можете цитувати інший Tweet, вказавши низькорівневий Tweet ID. ID можна отримати через відповідь/post у полі postIds, get history, або безпосередньо з URL Tweet: https://twitter.com/Ayrshare/status/1651601430669664256
X Quote Tweet
Reply Settings
Ви можете встановити налаштування відповідей для допису, щоб дозволяти відповіді лише певним типам користувачів.X Reply Settings
replySettings може мати одне з наступних значень:
following: Тільки користувачі, на яких підписаний обліковий запис X, можуть відповідати.mentioned: Тільки користувачі, згадані в дописі, можуть відповідати.subscribers: Тільки користувачі, які є передплатниками облікового запису X, що опублікував допис, можуть відповідати.verified: Тільки користувачі, верифіковані в X, можуть відповідати на допис.
Subscribers Only
Ви можете встановити допис видимим лише для передплатників, використовуючи параметрsubscribersOnly.
X Subscribers Only
Субтитри / Титри для відео
Ви можете додати X субтитри, також відомі як X титри, до відео, включивши файл SRT. Використовуйте полеsubTitleUrl в об’єкті twitterOptions, щоб вказати URL Вашого файлу SRT.
X Subtitles
subTitleUrl: Дійсний файл SRT. URL має починатися зhttps://і закінчуватися на.srtі бути дійсним файлом SRT.subTitleLanguage: Опціонально: Мова субтитрів. Має бути дійсним кодом мови. За замовчуванням: “en”.subTitleName: Опціонально: Назва треку титрів. Назва призначена для видимості користувачу як опція під час відтворення. Максимальна підтримувана довжина назви — 150 символів. За замовчуванням: “English”.
Video Thumbnail
Встановіть мініатюру (обкладинку) для відео Twitter/X. Мініатюра відображається до відтворення відео та допомагає користувачам зрозуміти вміст відео. ВикористовуйтеthumbNail в об’єкті twitterOptions.
Twitter/X Video Thumbnail
- “thumbNail”: URL зображення мініатюри. Підтримувані формати зображень: JPEG, PNG, BMP та WebP.
- Зображення мініатюри повинне представляти вміст відео та бути візуально привабливим для заохочення взаємодії.
- Для вимог до зображень див. X Media Guidelines.
Video Metadata
Встановіть заголовок та опис для відео, опублікованого в X. Вони відображаються у полях заголовка та опису в X Media Studio. Використовуйте поляvideoTitle та videoDescription в об’єкті twitterOptions.
X Video Metadata
videoTitle: Заголовок для відео, відображається в полі заголовка X Media Studio.videoDescription: Опис для відео, відображається в полі опису X Media Studio.
Video Monetization (Pro Media)
Ayrshare підтримує монетизацію відео X (Twitter) для придатних облікових записів через програму X Pro Media. Це можливість з обмеженим доступом — зв’яжіться з нами, якщо Ви хочете отримати доступ.Thread
X Thread, також відомий як tweetstorm, — це пов’язана серія дописів у X (раніше Twitter), яка дозволяє Вам ділитися довшими ідеями за межами обмеження символів одного допису, з’являючись як одна безперервна оповідь при перегляді разом.
Публікація Thread
X Thread можна опублікувати через API. Thread — це допис, розбитий на набір reply-потоків та пов’язаний у X лінією. Ви можете або автоматично розбити допис, або вказати розриви потоків у тексті допису.X Thread
thread: trueдля автоматичного розбиття тексту допису на потоки на основі переносів рядків.threadNumber: trueдля автоматичного додавання номерів у кінці потоків у форматі 1/n. Наприклад, 2-й з 5 потоків матиме додаток: 2/5mediaUrls: [масив url]для додавання кожного медіа-об’єкта, зображення або відео, до потоку за порядком. До потоку буде додано лише один медіа-об’єкт за порядком.
"twitter": []. Для отримання додаткової інформації див. Post Analytics 200 Response.
Медіа Thread
Пропустити медіа
Пропустіть медіа для потоку, використовуючиnull у масиві. Наприклад:
["https://site.com/image1.png", null, "https://site.com/image2.png"]
Це розмістить image1 на першому Tweet, без зображення на другому Tweet та image2 на третьому Tweet.
Кілька медіа
Кілька медіа-об’єктів можна додати до Tweet у Thread, додавши об’єкт{} з URL медіа в масиві mediaUrls. Можна використовувати будь-які унікальні ключі об’єкта. Наприклад:
X Thread with Multiple Media URLs
Розриви Thread
Ayrshare автоматично розбиває текст допису на twets відповідної довжини (> 280 символів). Створюючи потоки, ми пріоритизуємо збереження повних речень в одному дописі, коли це можливо. Якщо речення не поміщається, ми розбиваємо між реченнями. Для дуже довгих речень ми розбиваємо між словами. У рідкісних випадках, коли слово занадто довге, ми розбиваємо саме слово. Ви також можете вручну додавати абзаци з\n\n у текст допису, щоб вказати, що повинен бути створений унікальний потік.
Якщо у Вас є \n\n у тексті допису, ми не будемо автоматично розбивати допис на потоки.
Наприклад:
Example X Thread
\u2063\n\u2063\n
X Thread with Paragraphs
Видалити Thread
Щоб видалити Tweet Storm, викличте кінцеву точку видалення /post з верхньорівневим ID допису, повернутим у відповіді. Усі потоки буде видалено.Обмеження символів
Для отримання додаткової інформації див. Обмеження символів X/Twitter.Сумісність відео X
Деяке програмне забезпечення для відео створює файли MP4, які не сумісні з X. Наприклад, версії Camtasia старіші за 2019.0.9 створюють файли MP4, які X відхиляє. Також більше однієї аудіодоріжки часто спричиняє проблеми. Якщо Ви отримуєте наступне повідомлення під час публікації, це означає, що відео не сумісне з Twitter і потрібно перекодувати."file is currently unsupported"
Будь ласка, перевірте сумісність Вашого програмного забезпечення для відео. Наприклад, Adobe Media Encoder має пресет експорту для Twitter 1080p Full HD.

Subscribers Only
Ви можете встановити допис видимим лише для передплатників, використовуючи параметрsubscribersOnly.
X Subscribers Only
Reply Settings
Ви можете встановити налаштування відповідей для допису, щоб дозволяти відповіді лише певним типам користувачів.X Reply Settings
replySettings може мати одне з наступних значень:
following: Тільки користувачі, на яких підписаний обліковий запис X, можуть відповідати.mentioned: Тільки користувачі, згадані в дописі, можуть відповідати.subscribers: Тільки користувачі, які є передплатниками облікового запису X, що опублікував допис, можуть відповідати.verified: Тільки користувачі, верифіковані в X, можуть відповідати на допис.
