Перейти до основного вмісту

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
Параметри X — це опціональні поля, які можна використовувати для керування дописом.
altText
array of strings
Альтернативний текст для зображень, що допомагає з доступністю та програмами зчитування з екрана. Максимум 1 000 символів на alt text.Для отримання додаткової інформації див. Alt Text.
blockCountries
array of strings
Обмежте медіа певними країнами, блокуючи певні регіони. Використовуйте коди країн.Не можна використовувати з allowCountries. Для отримання додаткової інформації див. Geo Restrictions.
allowCountries
array of strings
Обмежте медіа певними країнами, дозволяючи певні регіони. Використовуйте коди країн.Не можна використовувати з blockCountries. Для отримання додаткової інформації див. Geo Restrictions.
longPost
boolean
за замовчуванням:false
Увімкнути публікацію довших дописів до 25 000 символів для користувачів Premium.Для отримання додаткової інформації див. Long Post.
longVideo
boolean
за замовчуванням:false
Дозволити публікацію відео тривалістю понад 2 хвилини 20 секунд для затверджених облікових записів.Для отримання додаткової інформації див. Long Video.
poll
object
Проводьте опитування з користувацькими параметрами та тривалістю.Обов’язкові поля: duration (число в хвилинах), options (масив рядків).Для отримання додаткової інформації див. Polls.
quoteTweetId
string
Цитуйте інший твіт, вказавши Tweet ID.Для отримання додаткової інформації див. Quote Tweet.
replySettings
string
Керуйте тим, хто може відповідати на допис.Значення: following, mentioned, subscribers або verified.Для отримання додаткової інформації див. Reply Settings.
subscribersOnly
boolean
за замовчуванням:false
Зробіть допис видимим лише для передплатників.Для отримання додаткової інформації див. Subscribers Only.
subTitleUrl
string
Додайте субтитри/титри до відео за допомогою файлів SRT. Має бути дійсний URL файлу SRT, що закінчується на .srt.Для отримання додаткової інформації див. Subtitles / Captions for Videos.
subTitleLanguage
string
за замовчуванням:"en"
Мова субтитрів. Має бути дійсним кодом мови.
subTitleName
string
Назва треку титрів. Максимум 150 символів.
thumbNail
string
Встановіть мініатюру (обкладинку) для відео. Має бути URL файлу зображення JPEG, PNG, BMP або WebP.Для отримання додаткової інформації див. Video Thumbnail та X Media Guidelines для вимог до зображень.
videoTitle
string
Встановіть заголовок для відео. Відображається у полі заголовка в X Media Studio.Для отримання додаткової інформації див. Video Metadata.
videoDescription
string
Встановіть опис для відео. Відображається у полі опису в X Media Studio.Для отримання додаткової інформації див. Video Metadata.
thread
boolean
за замовчуванням:false
Розбийте довгі дописи на серії пов’язаних потоків з опціональною нумерацією та медіа.Для отримання додаткової інформації див. Threads.
threadNumber
boolean
за замовчуванням:false
Автоматично додавати номери в кінці потоків у форматі 1/n.Вимагає thread: true.
mediaUrls
array of strings
Додайте медіа-об’єкти до потоків. Один медіа-об’єкт буде додано до кожного потоку за порядком.Використовуйте null, щоб пропустити медіа для конкретного потоку. Використовуйте об’єкти з кількома URL для кількох медіа на потік.

Alt Text

Додайте альтернативний текст, також відомий як alt text, до зображення Tweet. X alt text — це функція доступності, що використовується для додаткової інформації користувача та програм зчитування з екрана. Використовуйте altText в об’єкті twitterOptions.
X Alt Text
Кожен 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
Однак, якщо користувач без облікового запису Premium намагається опублікувати довгий твіт, система поверне помилку code: 111.

Long Video

Потрібен план Business або Enterprise. X вимагає, щоб відео мали максимальну тривалість 2 хвилини та 20 секунд. Однак, якщо Вас затвердив X для завантаження довших відео, наприклад, якщо обліковий запис користувача X є Premium або в програмі Amplify Partner, Ви можете публікувати відео тривалістю до 10+ хвилин.
Будь ласка, перевірте, що обліковий запис Вашого користувача X є Premium або в програмі Amplify Partner Program перед використанням параметра longVideo. Якщо обліковий запис Вашого користувача X не авторизовано для публікації довгих відео, система поверне помилку.
Використовуйте параметр twitterOptions longVideo при публікації довгого відео:
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), яка дозволяє Вам ділитися довшими ідеями за межами обмеження символів одного допису, з’являючись як одна безперервна оповідь при перегляді разом. X Thread

Публікація Thread

X Thread можна опублікувати через API. Thread — це допис, розбитий на набір reply-потоків та пов’язаний у X лінією. Ви можете або автоматично розбити допис, або вказати розриви потоків у тексті допису.
X Thread
  • thread: true для автоматичного розбиття тексту допису на потоки на основі переносів рядків.
  • threadNumber: true для автоматичного додавання номерів у кінці потоків у форматі 1/n. Наприклад, 2-й з 5 потоків матиме додаток: 2/5
  • mediaUrls: [масив url] для додавання кожного медіа-об’єкта, зображення або відео, до потоку за порядком. До потоку буде додано лише один медіа-об’єкт за порядком.
Якщо допис надіслано як X Thread, повернута аналітика допису буде масивом Tweets, "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
У цьому прикладі перший Tweet міститиме photo-1.jpg, другий Tweet — photo-2.jpg та photo-3.jpg, а третій Tweet — photo-4.jpg.

Розриви Thread

Ayrshare автоматично розбиває текст допису на twets відповідної довжини (> 280 символів). Створюючи потоки, ми пріоритизуємо збереження повних речень в одному дописі, коли це можливо. Якщо речення не поміщається, ми розбиваємо між реченнями. Для дуже довгих речень ми розбиваємо між словами. У рідкісних випадках, коли слово занадто довге, ми розбиваємо саме слово. Ви також можете вручну додавати абзаци з \n\n у текст допису, щоб вказати, що повинен бути створений унікальний потік. Якщо у Вас є \n\n у тексті допису, ми не будемо автоматично розбивати допис на потоки. Наприклад:
Example X Thread
призведе до двох Tweets у потоці. Якщо Ви хочете додати абзаци, але не розбивати на Tweets, використовуйте \u2063\n\u2063\n
X Thread with Paragraphs
призведе до одного Tweet з двома абзацами, оскільки допис має менше 280 символів.

Видалити 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. Adobe Media Encoder Для отримання більше прикладів X API див. тут.

Subscribers Only

Ви можете встановити допис видимим лише для передплатників, використовуючи параметр subscribersOnly.
X Subscribers Only

Reply Settings

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