X BYO API Keys
31 मार्च, 2026 से, सभी X/Twitter ऑपरेशंस के लिए आपके अपने API क्रेडेंशियल्स की आवश्यकता होगी। OAuth के माध्यम से अपने X अकाउंट को लिंक करने के बाद, X को टारगेट करने वाले प्रत्येक अनुरोध में ये 2 headers शामिल करें:
अभी तक लिंक नहीं किया है? अपने X अकाउंट को कनेक्ट करने के लिए X BYO Key Setup Guide देखें।
Ayrshare अब अपनी स्वयं की मासिक या दैनिक X/Twitter रेट सीमाएँ नहीं लगाता। चूंकि X अनुरोध
आपके अपने क्रेडेंशियल्स (BYO) का उपयोग करते हैं, आपका उपयोग केवल आपके अपने X Developer App सीमाओं द्वारा नियंत्रित होता है। विवरण के लिए
X API rate limits documentation देखें।
X (Twitter) पर पोस्ट करना
X API, जिसे पहले Twitter API के नाम से जाना जाता था, का उपयोग करके एक लिंक और इमेज के साथ बेसिक पोस्ट के लिए JSON:X Post
- X स्वचालित रूप से Tweet में लिंक का पूर्वावलोकन करेगा जब तक कि इमेज या वीडियो शामिल न हो। उपरोक्त उदाहरण में इमेज दिखाई देगी। इमेज हटाने से लिंक पूर्वावलोकन दिखाई देगा।
- यदि आपका वीडियो mp4 जैसे किसी ज्ञात वीडियो एक्सटेंशन में समाप्त नहीं होता है, तो कृपया
isVideoपैरामीटर का उपयोग करें। विवरण के लिए /post endpoint देखें। - X पोस्ट टेक्स्ट के बिना मीडिया भेजने का भी समर्थन करता है। यदि आप पोस्ट टेक्स्ट शामिल नहीं करना चाहते हैं, तो
एक खाली String
post: ""भेजें। - आप एक ही Tweet में 4 तक इमेज या वीडियो अपलोड कर सकते हैं। कृपया Twitter वीडियो पोस्ट करने पर महत्वपूर्ण दिशानिर्देश और प्रतिबंध देखें।
- अधिक जानकारी के लिए X Media Guidelines और X Authorization देखें।
X Options
आपtwitterOptions पैरामीटर का उपयोग करके पोस्ट के लिए अतिरिक्त विकल्प सेट कर सकते हैं।
X Options
एक्सेसिबिलिटी और स्क्रीन रीडर्स में सहायता के लिए इमेज के लिए वैकल्पिक टेक्स्ट। प्रति alt text अधिकतम 1,000 अक्षर।अधिक जानकारी के लिए Alt Text देखें।
कुछ क्षेत्रों को ब्लॉक करके मीडिया को विशिष्ट देशों तक सीमित करें। country codes का उपयोग करें।
allowCountries के साथ उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए Geo Restrictions देखें।कुछ क्षेत्रों को अनुमति देकर मीडिया को विशिष्ट देशों तक सीमित करें। country codes का उपयोग करें।
blockCountries के साथ उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए Geo Restrictions देखें।Premium उपयोगकर्ताओं के लिए 25,000 अक्षरों तक की लंबी पोस्ट पोस्ट करने की सुविधा सक्षम करें।अधिक जानकारी के लिए Long Post देखें।
अनुमोदित अकाउंट्स के लिए 2 मिनट 20 सेकंड से अधिक लंबे वीडियो पोस्ट करने की अनुमति दें।अधिक जानकारी के लिए Long Video देखें।
कस्टम विकल्पों और अवधि के साथ पोल आयोजित करें।आवश्यक फील्ड्स:
duration (मिनट में संख्या), options (स्ट्रिंग्स की array)।अधिक जानकारी के लिए Polls देखें।Tweet ID निर्दिष्ट करके किसी अन्य tweet को quote करें।अधिक जानकारी के लिए Quote Tweet देखें।
नियंत्रित करें कि पोस्ट का उत्तर कौन दे सकता है।मान:
following, mentioned, subscribers, या verified।अधिक जानकारी के लिए Reply Settings देखें।पोस्ट को केवल subscribers के लिए दृश्यमान बनाएं।अधिक जानकारी के लिए Subscribers Only देखें।
SRT फाइलों का उपयोग करके वीडियो में subtitles/captions जोड़ें। एक मान्य SRT फाइल URL होना चाहिए जो
.srt में समाप्त होता हो।अधिक जानकारी के लिए Subtitles / Captions for Videos देखें।Subtitles की भाषा। एक मान्य language code होना चाहिए।
Caption track का नाम। अधिकतम 150 अक्षर।
वीडियो के लिए एक थंबनेल (कवर इमेज) सेट करें। JPEG, PNG, BMP, या WebP इमेज फाइल का URL होना चाहिए।अधिक जानकारी के लिए Video Thumbnail और इमेज आवश्यकताओं के लिए X Media Guidelines देखें।
वीडियो के लिए टाइटल सेट करें। X Media Studio में title फील्ड से मैप होता है।अधिक जानकारी के लिए Video Metadata देखें।
वीडियो के लिए विवरण सेट करें। X Media Studio में description फील्ड से मैप होता है।अधिक जानकारी के लिए Video Metadata देखें।
वैकल्पिक नंबरिंग और मीडिया के साथ लंबी पोस्ट को कनेक्टेड thread सीरीज़ में विभाजित करें।अधिक जानकारी के लिए Threads देखें।
1/n के प्रारूप में threads के अंत में स्वचालित रूप से नंबर जोड़ें।
thread: true की आवश्यकता है।Threads में मीडिया ऑब्जेक्ट्स जोड़ें। क्रम में प्रत्येक thread में एक मीडिया ऑब्जेक्ट जोड़ा जाएगा।किसी विशिष्ट thread के लिए मीडिया छोड़ने के लिए
null का उपयोग करें। प्रति thread एकाधिक मीडिया के लिए एकाधिक URLs के साथ ऑब्जेक्ट्स का उपयोग करें।Alt Text
Tweet की इमेज में वैकल्पिक टेक्स्ट, जिसे alt text भी कहा जाता है, जोड़ें। X alt text एक एक्सेसिबिलिटी फीचर है जिसका उपयोग अतिरिक्त उपयोगकर्ता जानकारी और स्क्रीन रीडर्स के लिए किया जाता है।twitterOptions ऑब्जेक्ट में altText का उपयोग करें।
X Alt Text
mediaUrls array में एक इमेज के अनुरूप होना चाहिए। Alt text प्रत्येक इमेज पर क्रम में लागू होगा।
Alt text वीडियो पर लागू नहीं किया जा सकता। यदि
altText के साथ mediaUrls में एक वीडियो शामिल है,
तो वीडियो पोस्ट नहीं किया जाएगा। Alt text 1,000 अक्षर या उससे कम होना चाहिए।Geo Restrictions
आप country codes के साथblockCountries और allowCountries पैरामीटर का उपयोग करके X मीडिया, जैसे कि एक इमेज या वीडियो, को विशिष्ट देशों तक सीमित कर सकते हैं।
पोस्ट सभी देशों में दिखाई देगी, लेकिन मीडिया निर्दिष्ट देशों में उपलब्ध नहीं होगा।
blockCountries: ब्लॉक करने के लिए country codes की array। country codes देखें।allowCountries: अनुमति देने के लिए country codes की array। country codes देखें।
blockCountries या allowCountries में से एक पैरामीटर का उपयोग करना चाहिए।
यदि दोनों पैरामीटर का उपयोग किया जाता है या X द्वारा किसी देश का समर्थन नहीं किया जाता है, तो geo restrictions को अनदेखा कर दिया जाएगा।
Long Post
Premium X अकाउंट्स वाले उपयोगकर्ता, जैसे Premium या Premium Plus, 25,000 अक्षरों तक की लंबी पोस्ट पोस्ट करने की क्षमता रखते हैं। Ayrshare स्वचालित रूप से Premium X अकाउंट्स वाले उपयोगकर्ताओं के लिए लंबी पोस्ट की अनुमति देता है। यदि उपयोगकर्ता अपनी X Premium स्थिति बदलता है, तो कृपया Ayrshare में इसे प्रतिबिंबित होने में 24 घंटे प्रतीक्षा करें। आप /user या /analytics endpoints के साथ एक उपयोगकर्ता की Premium सब्सक्रिप्शन स्थिति की जांच कर सकते हैं। आपlongPost body पैरामीटर के साथ एक long form पोस्ट को स्वीकार करने के लिए भी मजबूर कर सकते हैं। यह आपके अनुरोध में निम्नलिखित JSON शामिल करके किया जा सकता है:
X Long Post
code: 111 एरर लौटाएगा।
Long Video
Business या Enterprise Plan आवश्यक है। X के लिए वीडियो में अधिकतम वीडियो लंबाई 2 मिनट और 20 सेकंड होनी चाहिए। हालांकि, यदि आपको X द्वारा लंबे वीडियो अपलोड करने की अनुमोदन प्राप्त है, जैसे कि यदि उपयोगकर्ता का X अकाउंट Premium अकाउंट है या Amplify Partner Program में है, तो आप 10+ मिनट तक की लंबाई के वीडियो पोस्ट कर सकते हैं। लंबा वीडियो पोस्ट करते समयlongVideo twitterOptions पैरामीटर का उपयोग करें:
X Long Video
Mentions
पोस्ट टेक्स्ट में@handle जोड़कर किसी अन्य X handle का उल्लेख करें। उदाहरण के लिए:
X Mention
Polls
twitterOptions poll पैरामीटर के साथ एक X Poll आयोजित करें।
X Poll
duration: पोल की अवधि निर्दिष्ट करने वाली मिनटों की संख्या।options: पोल विकल्पों की स्ट्रिंग्स की array।
Quote Tweet
आप low-level Tweet ID निर्दिष्ट करके किसी अन्य Tweet को quote कर सकते हैं। ID को/post response में postIds फील्ड, get history के माध्यम से, या सीधे Tweet URL से प्राप्त किया जा सकता है: https://twitter.com/Ayrshare/status/1651601430669664256
X Quote Tweet
Reply Settings
आप पोस्ट के लिए reply settings सेट कर सकते हैं ताकि केवल कुछ प्रकार के उपयोगकर्ताओं द्वारा उत्तर की अनुमति हो।X Reply Settings
replySettings पैरामीटर निम्नलिखित मानों में से एक हो सकता है:
following: केवल वे उपयोगकर्ता जिन्हें X अकाउंट फॉलो कर रहा है, उत्तर दे सकते हैं।mentioned: केवल वे उपयोगकर्ता जिनका पोस्ट में उल्लेख किया गया है, उत्तर दे सकते हैं।subscribers: केवल वे उपयोगकर्ता जो पोस्ट करने वाले X अकाउंट के subscribers हैं, उत्तर दे सकते हैं।verified: केवल वे उपयोगकर्ता जो X पर verified हैं, पोस्ट का उत्तर दे सकते हैं।
Subscribers Only
आपsubscribersOnly पैरामीटर का उपयोग करके पोस्ट को केवल subscribers के लिए दृश्यमान होने के लिए सेट कर सकते हैं।
X Subscribers Only
Subtitles / Captions for Videos
आप SRT फाइल शामिल करके वीडियो में X subtitles, जिन्हें X captions भी कहा जाता है, जोड़ सकते हैं। अपने SRT फाइल के URL को निर्दिष्ट करने के लिएtwitterOptions ऑब्जेक्ट में subTitleUrl फील्ड का उपयोग करें।
X Subtitles
subTitleUrl: एक मान्य SRT फाइल। URLhttps://से शुरू होना चाहिए और.srtमें समाप्त होना चाहिए और एक मान्य SRT फाइल होनी चाहिए।subTitleLanguage: वैकल्पिक: subtitles की भाषा। एक मान्य language code होना चाहिए। डिफ़ॉल्ट: “en”।subTitleName: वैकल्पिक: caption track का नाम। नाम का उद्देश्य playback के दौरान उपयोगकर्ता को एक विकल्प के रूप में दृश्यमान होना है। समर्थित अधिकतम नाम लंबाई 150 अक्षर है। डिफ़ॉल्ट: “English”।
Video Thumbnail
Twitter/X वीडियो के लिए एक थंबनेल (कवर इमेज) सेट करें। थंबनेल वीडियो चलने से पहले प्रदर्शित होता है और उपयोगकर्ताओं को वीडियो सामग्री को समझने में मदद करता है।twitterOptions ऑब्जेक्ट में thumbNail का उपयोग करें।
Twitter/X Video Thumbnail
- “thumbNail”: थंबनेल इमेज का एक URL। समर्थित इमेज फॉर्मेट JPEG, PNG, BMP, और WebP हैं।
- थंबनेल इमेज को वीडियो सामग्री का प्रतिनिधित्व करना चाहिए और सहभागिता को प्रोत्साहित करने के लिए दृश्य रूप से आकर्षक होनी चाहिए।
- इमेज आवश्यकताओं के लिए X Media Guidelines देखें।
Video Metadata
X पर पोस्ट किए गए वीडियो के लिए एक टाइटल और विवरण सेट करें। ये X Media Studio में title और description फील्ड्स से मैप होते हैं।twitterOptions ऑब्जेक्ट में videoTitle और videoDescription फील्ड्स का उपयोग करें।
X Video Metadata
videoTitle: वीडियो के लिए टाइटल, X Media Studio title फील्ड से मैप किया गया।videoDescription: वीडियो के लिए विवरण, X Media Studio description फील्ड से मैप किया गया।
Video Monetization (Pro Media)
Ayrshare X (Twitter) वीडियो मुद्रीकरण का समर्थन X के Pro Media प्रोग्राम के माध्यम से पात्र अकाउंट्स के लिए करता है। यह एक सीमित-पहुँच क्षमता है — यदि आप एक्सेस चाहते हैं तो हमसे संपर्क करें।Thread
एक X Thread, जिसे tweetstorm भी कहा जाता है, X (पहले Twitter) पर पोस्ट्स की एक कनेक्टेड सीरीज़ है जो आपको एकल पोस्ट की अक्षर सीमा से परे लंबे विचार साझा करने की अनुमति देती है, एक साथ देखे जाने पर एक निरंतर narrative के रूप में दिखाई देती है।
एक Thread पोस्ट करना
एक X Thread API के माध्यम से पोस्ट किया जा सकता है। एक thread एक पोस्ट है जो reply threads के एक सेट में विभाजित होता है और X में एक लाइन के साथ जुड़ा होता है। आप या तो पोस्ट को स्वचालित रूप से विभाजित कर सकते हैं या पोस्ट टेक्स्ट में thread breaks निर्दिष्ट कर सकते हैं।X Thread
thread: trueलाइन ब्रेक्स के आधार पर पोस्ट टेक्स्ट को threads में स्वचालित रूप से विभाजित करने के लिए।threadNumber: true1/n के प्रारूप में threads के अंत में स्वचालित रूप से नंबर जोड़ने के लिए। उदाहरण के लिए 5 threads में से 2nd में जोड़ा जाएगा: 2/5mediaUrls: [array of urls]क्रम में एक thread में प्रत्येक मीडिया ऑब्जेक्ट, एक इमेज या वीडियो, जोड़ने के लिए। क्रम में एक thread में केवल एक मीडिया ऑब्जेक्ट जोड़ा जाएगा।
"twitter": []. अधिक जानकारी के लिए Post Analytics 200 Response देखें।
Thread Media
Skip Media
array मेंnull का उपयोग करके thread के लिए मीडिया छोड़ें। उदाहरण के लिए:
["https://site.com/image1.png", null, "https://site.com/image2.png"]
यह पहले Tweet पर image1, दूसरे Tweet पर कोई इमेज नहीं, और तीसरे Tweet पर image2 रखेगा।
एकाधिक Media
mediaUrls array में मीडिया URLs के साथ एक ऑब्जेक्ट {} जोड़कर Thread में एक Tweet में एकाधिक मीडिया ऑब्जेक्ट्स जोड़े जा सकते हैं। कोई भी अद्वितीय ऑब्जेक्ट keys का उपयोग किया जा सकता है। उदाहरण के लिए:
X Thread with Multiple Media URLs
Thread Breaks
Ayrshare स्वचालित रूप से पोस्ट टेक्स्ट को उपयुक्त लंबाई के tweet (> 280 अक्षर) में विभाजित करता है। Threads बनाते समय, जब संभव हो हम एक पोस्ट में पूर्ण वाक्य रखने को प्राथमिकता देते हैं। यदि एक वाक्य फिट नहीं होगा, तो हम वाक्यों के बीच विभाजित करते हैं। बहुत लंबे वाक्यों के लिए, हम शब्दों के बीच विभाजित करते हैं। दुर्लभ मामलों में जहाँ एक शब्द बहुत लंबा होता है, हम स्वयं शब्द को विभाजित करते हैं। आप एक अद्वितीय thread बनाने का संकेत देने के लिए पोस्ट टेक्स्ट में\n\n के साथ पैराग्राफ भी मैन्युअल रूप से जोड़ सकते हैं।
यदि आपके पोस्ट टेक्स्ट में \n\n है, तो हम पोस्ट को threads में स्वचालित रूप से विभाजित नहीं करेंगे।
उदाहरण के लिए:
Example X Thread
\u2063\n\u2063\n का उपयोग करें
X Thread with Paragraphs
एक Thread हटाएं
एक Tweet Storm हटाने के लिए, response में लौटाए गए top level पोस्ट ID के साथ /post delete endpoint को कॉल करें। सभी threads हटा दिए जाएंगे।Character Limits
अधिक जानकारी के लिए कृपया X/Twitter Character Limits देखें।X Video Compatibility
कुछ वीडियो सॉफ्टवेयर MP4 फाइलें बनाते हैं जो X के साथ संगत नहीं हैं। उदाहरण के लिए, 2019.0.9 से पुराने Camtasia संस्करण MP4 फाइलें बनाते हैं जिन्हें X अस्वीकार करता है। इसके अलावा एक से अधिक ऑडियो ट्रैक अक्सर समस्याएँ पैदा करते हैं। यदि आपको पोस्ट करते समय निम्नलिखित संदेश वापस मिलता है, तो यह इंगित करता है कि वीडियो Twitter के साथ संगत नहीं है और इसे फिर से encode करने की आवश्यकता है।"file is currently unsupported"
कृपया अपने वीडियो सॉफ्टवेयर की संगतता जांचें। उदाहरण के लिए, Adobe Media Encoder के पास Twitter 1080p Full HD के लिए एक export preset है।

Subscribers Only
आपsubscribersOnly पैरामीटर का उपयोग करके पोस्ट को केवल subscribers के लिए दृश्यमान होने के लिए सेट कर सकते हैं।
X Subscribers Only
Reply Settings
आप पोस्ट के लिए reply settings सेट कर सकते हैं ताकि केवल कुछ प्रकार के उपयोगकर्ताओं द्वारा उत्तर की अनुमति हो।X Reply Settings
replySettings पैरामीटर निम्नलिखित मानों में से एक हो सकता है:
following: केवल वे उपयोगकर्ता जिन्हें X अकाउंट फॉलो कर रहा है, उत्तर दे सकते हैं।mentioned: केवल वे उपयोगकर्ता जिनका पोस्ट में उल्लेख किया गया है, उत्तर दे सकते हैं।subscribers: केवल वे उपयोगकर्ता जो पोस्ट करने वाले X अकाउंट के subscribers हैं, उत्तर दे सकते हैं।verified: केवल वे उपयोगकर्ता जो X पर verified हैं, पोस्ट का उत्तर दे सकते हैं।
