> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # X API > Параметри для публікації за допомогою X API ## X BYO API Keys Починаючи з 31 березня 2026 року, всі операції X/Twitter вимагають Ваших власних API-облікових даних. Після зв'язування Вашого облікового запису X через OAuth, додавайте ці 2 заголовки в кожен запит, який спрямований на X: | Заголовок | Значення | | ----------------------------- | ------------------------------------ | | `X-Twitter-OAuth1-Api-Key` | Ваш API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Ваш API Key Secret (Consumer Secret) | Ще не пов'язані? Див. [X BYO Key Setup Guide](/dashboard/connect-social-accounts/x-twitter-byo-keys) для під'єднання Вашого облікового запису X. Ayrshare більше не накладає власних місячних або денних обмежень швидкості X/Twitter. Оскільки запити X використовують Ваші власні облікові дані (BYO), Ваше використання регулюється лише лімітами Вашого власного X Developer App. Див. [документацію лімітів швидкості X API](https://developer.x.com/en/docs/x-api/rate-limits) для деталей. ## Публікація в X (Twitter) JSON для базового допису з посиланням та зображенням за допомогою X API, раніше відомого як Twitter API: ```json X Post theme={"system"} { "post": "The best Tweet ever #best https://www.twitter.com", // порожній рядок дозволено "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["twitter"] } ``` ## Параметри X Ви можете встановити додаткові параметри для допису, використовуючи параметр `twitterOptions`. ```json X Options theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"], "blockCountries": ["US", "CA"], // або "allowCountries": ["GB", "IE"] "longPost": true, "longVideo": true, "poll": { "duration": 5, // обов'язково. Число в хвилинах "options": ["yes", "maybe", "no"] // обов'язково }, "quoteTweetId": "651601430669664256", "replySettings": "mentioned", "subscribersOnly": true, "thumbNail": "https://img.ayrshare.com/012/gb.jpg", // Метадані відео "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release.", // Субтитри / Титри для відео "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English", // Параметри потоку "thread": true, "threadNumber": true, "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], } } ``` Параметри X — це опціональні поля, які можна використовувати для керування дописом. Альтернативний текст для зображень, що допомагає з доступністю та програмами зчитування з екрана. Максимум 1 000 символів на alt text. Для отримання додаткової інформації див. [Alt Text](/apis/post/social-networks/x-twitter#alt-text). Обмежте медіа певними країнами, блокуючи певні регіони. Використовуйте [коди країн](/iso-codes/country). Не можна використовувати з `allowCountries`. Для отримання додаткової інформації див. [Geo Restrictions](/apis/post/social-networks/x-twitter#geo-restrictions). Обмежте медіа певними країнами, дозволяючи певні регіони. Використовуйте [коди країн](/iso-codes/country). Не можна використовувати з `blockCountries`. Для отримання додаткової інформації див. [Geo Restrictions](/apis/post/social-networks/x-twitter#geo-restrictions). Увімкнути публікацію довших дописів до 25 000 символів для користувачів Premium. Для отримання додаткової інформації див. [Long Post](/apis/post/social-networks/x-twitter#long-post). Дозволити публікацію відео тривалістю понад 2 хвилини 20 секунд для затверджених облікових записів. Для отримання додаткової інформації див. [Long Video](/apis/post/social-networks/x-twitter#long-video). Проводьте опитування з користувацькими параметрами та тривалістю. Обов'язкові поля: `duration` (число в хвилинах), `options` (масив рядків). Для отримання додаткової інформації див. [Polls](/apis/post/social-networks/x-twitter#polls). Цитуйте інший твіт, вказавши Tweet ID. Для отримання додаткової інформації див. [Quote Tweet](/apis/post/social-networks/x-twitter#quote-tweet). Керуйте тим, хто може відповідати на допис. Значення: `following`, `mentioned`, `subscribers` або `verified`. Для отримання додаткової інформації див. [Reply Settings](/apis/post/social-networks/x-twitter#reply-settings). Зробіть допис видимим лише для передплатників. Для отримання додаткової інформації див. [Subscribers Only](/apis/post/social-networks/x-twitter#subscribers-only). Додайте субтитри/титри до відео за допомогою файлів SRT. Має бути дійсний URL файлу SRT, що закінчується на `.srt`. Для отримання додаткової інформації див. [Subtitles / Captions for Videos](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos). Мова субтитрів. Має бути дійсним [кодом мови](/iso-codes/language). Назва треку титрів. Максимум 150 символів. Встановіть мініатюру (обкладинку) для відео. Має бути URL файлу зображення JPEG, PNG, BMP або WebP. Для отримання додаткової інформації див. [Video Thumbnail](/apis/post/social-networks/x-twitter#video-thumbnail) та [X Media Guidelines](/media-guidelines/x_twitter#video-thumbnail) для вимог до зображень. Встановіть заголовок для відео. Відображається у полі заголовка в X Media Studio. Для отримання додаткової інформації див. [Video Metadata](/apis/post/social-networks/x-twitter#video-metadata). Встановіть опис для відео. Відображається у полі опису в X Media Studio. Для отримання додаткової інформації див. [Video Metadata](/apis/post/social-networks/x-twitter#video-metadata). Розбийте довгі дописи на серії пов'язаних потоків з опціональною нумерацією та медіа. Для отримання додаткової інформації див. [Threads](/apis/post/social-networks/x-twitter#thread). Автоматично додавати номери в кінці потоків у форматі 1/n. Вимагає `thread: true`. Додайте медіа-об'єкти до потоків. Один медіа-об'єкт буде додано до кожного потоку за порядком. Використовуйте `null`, щоб пропустити медіа для конкретного потоку. Використовуйте об'єкти з кількома URL для кількох медіа на потік. ## Alt Text Додайте альтернативний текст, також відомий як alt text, до зображення Tweet. X alt text — це функція доступності, що використовується для додаткової інформації користувача та програм зчитування з екрана. Використовуйте `altText` в об'єкті `twitterOptions`. ```json X Alt Text theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Масив Alt Texts } } ``` Кожен alt text повинен відповідати зображенню в масиві `mediaUrls`. Alt text буде застосовано до кожного зображення за порядком. Alt text не можна застосувати до відео. Якщо відео включено в `mediaUrls` з `altText`, відео не буде опубліковано. Alt text повинен бути 1 000 символів або менше. ## Geo Restrictions Ви можете обмежити медіа X, наприклад зображення або відео, певними країнами, використовуючи параметри `blockCountries` та `allowCountries` з [кодами країн](/iso-codes/country). Допис все одно буде показано в усіх країнах, але медіа не буде доступне у вказаних країнах. ```json Block Countries theme={"system"} { "twitterOptions": { "blockCountries": ["US", "CA"] } } ``` ```json Allow Countries theme={"system"} { "twitterOptions": { "allowCountries": ["GB", "IE"] } } ``` Ви повинні використовувати лише один з параметрів `blockCountries` або `allowCountries` за раз. Якщо використовуються обидва параметри або країна не підтримується X, геообмеження буде ігноровано. ## Long Post Користувачі з обліковими записами Premium X, такими як Premium або Premium Plus, мають можливість публікувати довші дописи до 25 000 символів. Ayrshare автоматично дозволяє довгі дописи для користувачів з обліковими записами Premium X. Якщо користувач змінює свій статус X Premium, будь ласка, зачекайте 24 години, щоб він відобразився в Ayrshare. Ви можете перевірити статус підписки Premium користувача за допомогою кінцевих точок [/user](/apis/user/overview) або [/analytics](/apis/analytics/social). Ви також можете примусово прийняти допис у довгій формі за допомогою параметра тіла `longPost`. Це можна зробити, включивши наступний JSON у Ваш запит: ```json X Long Post theme={"system"} { "twitterOptions": { "longPost": true } } ``` Однак, якщо користувач без облікового запису Premium намагається опублікувати довгий твіт, система поверне помилку `code: 111`. ## Long Video *Потрібен план Business або Enterprise.* X вимагає, щоб відео мали [максимальну тривалість](/media-guidelines/x_twitter#video) 2 хвилини та 20 секунд. Однак, якщо Вас затвердив X для завантаження довших відео, наприклад, якщо обліковий запис користувача X є Premium або в [програмі Amplify Partner](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers), Ви можете публікувати відео тривалістю до 10+ хвилин. Будь ласка, перевірте, що обліковий запис Вашого користувача X є Premium або в програмі [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) перед використанням параметра `longVideo`. Якщо обліковий запис Вашого користувача X не авторизовано для публікації довгих відео, система поверне помилку. Використовуйте параметр twitterOptions `longVideo` при публікації довгого відео: ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## Згадування Згадайте інший handle X, додавши `@handle` у текст допису. Наприклад: ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` Будь ласка, перегляньте [важливі правила](/testing/post-verification#mentions) щодо згадувань. ## Опитування Проводьте X Poll за допомогою параметра `poll` `twitterOptions`. ```json X Poll theme={"system"} { "twitterOptions": { "poll": { "duration": 5, // обов'язково. Число в хвилинах "options": ["yes", "maybe", "no"] // обов'язково } } } ``` ## Quote Tweet Ви можете цитувати інший Tweet, вказавши низькорівневий Tweet ID. ID можна отримати через відповідь [`/post`](/apis/post/post) у полі `postIds`, [get history](/apis/history/get-history), або безпосередньо з URL Tweet: [https://twitter.com/Ayrshare/status/**1651601430669664256**](https://twitter.com/Ayrshare/status/1651601430669664256) ```json X Quote Tweet theme={"system"} { "twitterOptions": { "quoteTweetId": "651601430669664256" // low-level Tweet Id } } ``` ## Reply Settings Ви можете встановити налаштування відповідей для допису, щоб дозволяти відповіді лише певним типам користувачів. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` Параметр `replySettings` може мати одне з наступних значень: ## Subscribers Only Ви можете встановити допис видимим лише для передплатників, використовуючи параметр `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Субтитри / Титри для відео Ви можете додати X субтитри, також відомі як X титри, до відео, включивши [файл SRT](https://en.wikipedia.org/wiki/SubRip). Використовуйте поле `subTitleUrl` в об'єкті `twitterOptions`, щоб вказати URL Вашого файлу SRT. ```json X Subtitles theme={"system"} { "twitterOptions": { "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English" } } ``` ## Video Thumbnail Встановіть мініатюру (обкладинку) для відео Twitter/X. Мініатюра відображається до відтворення відео та допомагає користувачам зрозуміти вміст відео. Використовуйте `thumbNail` в об'єкті `twitterOptions`. ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## Video Metadata Встановіть заголовок та опис для відео, опублікованого в X. Вони відображаються у полях заголовка та опису в X Media Studio. Використовуйте поля `videoTitle` та `videoDescription` в об'єкті `twitterOptions`. ```json X Video Metadata theme={"system"} { "twitterOptions": { "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release." } } ``` ## Video Monetization (Pro Media) Ayrshare підтримує монетизацію відео X (Twitter) для придатних облікових записів через програму X Pro Media. Це можливість з обмеженим доступом — [зв'яжіться з нами](mailto:support@ayrshare.com), якщо Ви хочете отримати доступ. ## Thread X Thread, також відомий як tweetstorm, — це пов'язана серія дописів у X (раніше Twitter), яка дозволяє Вам ділитися довшими ідеями за межами обмеження символів одного допису, з'являючись як одна безперервна оповідь при перегляді разом. X Thread ### Публікація Thread X Thread можна опублікувати через API. Thread — це допис, розбитий на набір reply-потоків та пов'язаний у X лінією. Ви можете або автоматично розбити допис, або вказати [розриви потоків](/apis/post/social-networks/x-twitter#thread-breaks) у тексті допису. ```json X Thread theme={"system"} { "twitterOptions": { "thread": true, // обов'язково для TweetStorm "threadNumber": true, // опціонально для додавання номерів до кожного потоку "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...] // опціонально: один медіа-об'єкт додається до потоку за порядком } } ``` Якщо допис надіслано як X Thread, повернута аналітика допису буде масивом Tweets, `"twitter": []`. Для отримання додаткової інформації див. [Post Analytics 200 Response](/apis/analytics/post). #### Медіа Thread ##### Пропустити медіа Пропустіть медіа для потоку, використовуючи `null` у масиві. Наприклад: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Це розмістить image1 на першому Tweet, без зображення на другому Tweet та image2 на третьому Tweet. ##### Кілька медіа Кілька медіа-об'єктів можна додати до Tweet у Thread, додавши об'єкт `{}` з URL медіа в масиві `mediaUrls`. Можна використовувати будь-які унікальні ключі об'єкта. Наприклад: ```json X Thread with Multiple Media URLs theme={"system"} { "twitterOptions": { "thread": true, "threadNumber": true, "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", { "1": "https://img.ayrshare.com/random/photo-2.jpg", "2": "https://img.ayrshare.com/random/photo-3.jpg" }, "https://img.ayrshare.com/random/photo-4.jpg" ] } } ``` У цьому прикладі перший Tweet міститиме photo-1.jpg, другий Tweet — photo-2.jpg та photo-3.jpg, а третій Tweet — photo-4.jpg. #### Розриви Thread Ayrshare автоматично розбиває текст допису на twets відповідної довжини (> 280 символів). Створюючи потоки, ми пріоритизуємо збереження повних речень в одному дописі, коли це можливо. Якщо речення не поміщається, ми розбиваємо між реченнями. Для дуже довгих речень ми розбиваємо між словами. У рідкісних випадках, коли слово занадто довге, ми розбиваємо саме слово. Ви також можете вручну додавати абзаци з `\n\n` у текст допису, щоб вказати, що повинен бути створений унікальний потік. Якщо у Вас є `\n\n` у тексті допису, ми не будемо автоматично розбивати допис на потоки. Наприклад: ```json Example X Thread theme={"system"} { "post": "This is tweet 1\n\nThis is tweet 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` призведе до двох Tweets у потоці. Якщо Ви хочете додати абзаци, але не розбивати на Tweets, використовуйте `\u2063\n\u2063\n` ```json X Thread with Paragraphs theme={"system"} { "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` призведе до одного Tweet з двома абзацами, оскільки допис має менше 280 символів. ### Видалити Thread Щоб видалити Tweet Storm, викличте [кінцеву точку видалення /post](/apis/post/delete-post) з верхньорівневим ID допису, повернутим у відповіді. Усі потоки буде видалено. ## Обмеження символів Для отримання додаткової інформації див. [Обмеження символів X/Twitter](/help-center/technical-support/character_limits#x%2Ftwitter-character-limits). ## Сумісність відео 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](https://www.ayrshare.com/twitter-api-how-to-post-and-get-analytics-with-the-twitter-api#twitter-api-examples) див. тут. ## Subscribers Only Ви можете встановити допис видимим лише для передплатників, використовуючи параметр `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Reply Settings Ви можете встановити налаштування відповідей для допису, щоб дозволяти відповіді лише певним типам користувачів. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` Параметр `replySettings` може мати одне з наступних значень: