> ## 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 क्रेडेंशियल्स की आवश्यकता होगी। OAuth के माध्यम से अपने X अकाउंट को लिंक करने के बाद, X को टारगेट करने वाले प्रत्येक अनुरोध में ये 2 headers शामिल करें: | Header | Value | | ----------------------------- | ------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | आपकी API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | आपका API Key Secret (Consumer Secret) | अभी तक लिंक नहीं किया है? अपने X अकाउंट को कनेक्ट करने के लिए [X BYO Key Setup Guide](/dashboard/connect-social-accounts/x-twitter-byo-keys) देखें। Ayrshare अब अपनी स्वयं की मासिक या दैनिक X/Twitter रेट सीमाएँ नहीं लगाता। चूंकि X अनुरोध आपके अपने क्रेडेंशियल्स (BYO) का उपयोग करते हैं, आपका उपयोग केवल आपके अपने X Developer App सीमाओं द्वारा नियंत्रित होता है। विवरण के लिए [X API rate limits documentation](https://developer.x.com/en/docs/x-api/rate-limits) देखें। ## X (Twitter) पर पोस्ट करना X API, जिसे पहले Twitter API के नाम से जाना जाता था, का उपयोग करके एक लिंक और इमेज के साथ बेसिक पोस्ट के लिए JSON: ```json X Post theme={"system"} { "post": "The best Tweet ever #best https://www.twitter.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["twitter"] } ``` ## X Options आप `twitterOptions` पैरामीटर का उपयोग करके पोस्ट के लिए अतिरिक्त विकल्प सेट कर सकते हैं। ```json X Options theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"], "blockCountries": ["US", "CA"], // or "allowCountries": ["GB", "IE"] "longPost": true, "longVideo": true, "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required }, "quoteTweetId": "651601430669664256", "replySettings": "mentioned", "subscribersOnly": true, "thumbNail": "https://img.ayrshare.com/012/gb.jpg", // Video Metadata "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release.", // Subtitles / Captions for Videos "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English", // Thread Options "thread": true, "threadNumber": true, "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], } } ``` X options वैकल्पिक फील्ड हैं जिनका उपयोग पोस्ट को नियंत्रित करने के लिए किया जा सकता है। एक्सेसिबिलिटी और स्क्रीन रीडर्स में सहायता के लिए इमेज के लिए वैकल्पिक टेक्स्ट। प्रति alt text अधिकतम 1,000 अक्षर। अधिक जानकारी के लिए [Alt Text](/apis/post/social-networks/x-twitter#alt-text) देखें। कुछ क्षेत्रों को ब्लॉक करके मीडिया को विशिष्ट देशों तक सीमित करें। [country codes](/iso-codes/country) का उपयोग करें। `allowCountries` के साथ उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए [Geo Restrictions](/apis/post/social-networks/x-twitter#geo-restrictions) देखें। कुछ क्षेत्रों को अनुमति देकर मीडिया को विशिष्ट देशों तक सीमित करें। [country codes](/iso-codes/country) का उपयोग करें। `blockCountries` के साथ उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए [Geo Restrictions](/apis/post/social-networks/x-twitter#geo-restrictions) देखें। Premium उपयोगकर्ताओं के लिए 25,000 अक्षरों तक की लंबी पोस्ट पोस्ट करने की सुविधा सक्षम करें। अधिक जानकारी के लिए [Long Post](/apis/post/social-networks/x-twitter#long-post) देखें। अनुमोदित अकाउंट्स के लिए 2 मिनट 20 सेकंड से अधिक लंबे वीडियो पोस्ट करने की अनुमति दें। अधिक जानकारी के लिए [Long Video](/apis/post/social-networks/x-twitter#long-video) देखें। कस्टम विकल्पों और अवधि के साथ पोल आयोजित करें। आवश्यक फील्ड्स: `duration` (मिनट में संख्या), `options` (स्ट्रिंग्स की array)। अधिक जानकारी के लिए [Polls](/apis/post/social-networks/x-twitter#polls) देखें। Tweet ID निर्दिष्ट करके किसी अन्य tweet को quote करें। अधिक जानकारी के लिए [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 के लिए दृश्यमान बनाएं। अधिक जानकारी के लिए [Subscribers Only](/apis/post/social-networks/x-twitter#subscribers-only) देखें। SRT फाइलों का उपयोग करके वीडियो में subtitles/captions जोड़ें। एक मान्य SRT फाइल URL होना चाहिए जो `.srt` में समाप्त होता हो। अधिक जानकारी के लिए [Subtitles / Captions for Videos](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos) देखें। Subtitles की भाषा। एक मान्य [language code](/iso-codes/language) होना चाहिए। Caption track का नाम। अधिकतम 150 अक्षर। वीडियो के लिए एक थंबनेल (कवर इमेज) सेट करें। JPEG, PNG, BMP, या WebP इमेज फाइल का URL होना चाहिए। अधिक जानकारी के लिए [Video Thumbnail](/apis/post/social-networks/x-twitter#video-thumbnail) और इमेज आवश्यकताओं के लिए [X Media Guidelines](/media-guidelines/x_twitter#video-thumbnail) देखें। वीडियो के लिए टाइटल सेट करें। X Media Studio में title फील्ड से मैप होता है। अधिक जानकारी के लिए [Video Metadata](/apis/post/social-networks/x-twitter#video-metadata) देखें। वीडियो के लिए विवरण सेट करें। X Media Studio में description फील्ड से मैप होता है। अधिक जानकारी के लिए [Video Metadata](/apis/post/social-networks/x-twitter#video-metadata) देखें। वैकल्पिक नंबरिंग और मीडिया के साथ लंबी पोस्ट को कनेक्टेड thread सीरीज़ में विभाजित करें। अधिक जानकारी के लिए [Threads](/apis/post/social-networks/x-twitter#thread) देखें। 1/n के प्रारूप में threads के अंत में स्वचालित रूप से नंबर जोड़ें। `thread: true` की आवश्यकता है। Threads में मीडिया ऑब्जेक्ट्स जोड़ें। क्रम में प्रत्येक thread में एक मीडिया ऑब्जेक्ट जोड़ा जाएगा। किसी विशिष्ट thread के लिए मीडिया छोड़ने के लिए `null` का उपयोग करें। प्रति thread एकाधिक मीडिया के लिए एकाधिक URLs के साथ ऑब्जेक्ट्स का उपयोग करें। ## Alt Text Tweet की इमेज में वैकल्पिक टेक्स्ट, जिसे alt text भी कहा जाता है, जोड़ें। X alt text एक एक्सेसिबिलिटी फीचर है जिसका उपयोग अतिरिक्त उपयोगकर्ता जानकारी और स्क्रीन रीडर्स के लिए किया जाता है। `twitterOptions` ऑब्जेक्ट में `altText` का उपयोग करें। ```json X Alt Text theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` प्रत्येक alt text `mediaUrls` array में एक इमेज के अनुरूप होना चाहिए। Alt text प्रत्येक इमेज पर क्रम में लागू होगा। Alt text वीडियो पर लागू नहीं किया जा सकता। यदि `altText` के साथ `mediaUrls` में एक वीडियो शामिल है, तो वीडियो पोस्ट नहीं किया जाएगा। Alt text 1,000 अक्षर या उससे कम होना चाहिए। ## Geo Restrictions आप [country codes](/iso-codes/country) के साथ `blockCountries` और `allowCountries` पैरामीटर का उपयोग करके X मीडिया, जैसे कि एक इमेज या वीडियो, को विशिष्ट देशों तक सीमित कर सकते हैं। पोस्ट सभी देशों में दिखाई देगी, लेकिन मीडिया निर्दिष्ट देशों में उपलब्ध नहीं होगा। ```json Block Countries theme={"system"} { "twitterOptions": { "blockCountries": ["US", "CA"] } } ``` ```json Allow Countries theme={"system"} { "twitterOptions": { "allowCountries": ["GB", "IE"] } } ``` आपको एक समय में केवल `blockCountries` या `allowCountries` में से एक पैरामीटर का उपयोग करना चाहिए। यदि दोनों पैरामीटर का उपयोग किया जाता है या X द्वारा किसी देश का समर्थन नहीं किया जाता है, तो geo restrictions को अनदेखा कर दिया जाएगा। ## Long Post Premium X अकाउंट्स वाले उपयोगकर्ता, जैसे Premium या Premium Plus, 25,000 अक्षरों तक की लंबी पोस्ट पोस्ट करने की क्षमता रखते हैं। Ayrshare स्वचालित रूप से Premium X अकाउंट्स वाले उपयोगकर्ताओं के लिए लंबी पोस्ट की अनुमति देता है। यदि उपयोगकर्ता अपनी X Premium स्थिति बदलता है, तो कृपया Ayrshare में इसे प्रतिबिंबित होने में 24 घंटे प्रतीक्षा करें। आप [/user](/apis/user/overview) या [/analytics](/apis/analytics/social) endpoints के साथ एक उपयोगकर्ता की Premium सब्सक्रिप्शन स्थिति की जांच कर सकते हैं। आप `longPost` body पैरामीटर के साथ एक long form पोस्ट को स्वीकार करने के लिए भी मजबूर कर सकते हैं। यह आपके अनुरोध में निम्नलिखित JSON शामिल करके किया जा सकता है: ```json X Long Post theme={"system"} { "twitterOptions": { "longPost": true } } ``` हालांकि, यदि Premium अकाउंट के बिना कोई उपयोगकर्ता एक long tweet पोस्ट करने का प्रयास करता है, तो सिस्टम एक `code: 111` एरर लौटाएगा। ## Long Video *Business या Enterprise Plan आवश्यक है।* X के लिए वीडियो में [अधिकतम वीडियो लंबाई](/media-guidelines/x_twitter#video) 2 मिनट और 20 सेकंड होनी चाहिए। हालांकि, यदि आपको X द्वारा लंबे वीडियो अपलोड करने की अनुमोदन प्राप्त है, जैसे कि यदि उपयोगकर्ता का X अकाउंट Premium अकाउंट है या [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) में है, तो आप 10+ मिनट तक की लंबाई के वीडियो पोस्ट कर सकते हैं। कृपया `longVideo` पैरामीटर का उपयोग करने से पहले सत्यापित करें कि आपके उपयोगकर्ता का X अकाउंट Premium या [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) में है। यदि आपके उपयोगकर्ता का X अकाउंट लंबे वीडियो पोस्ट करने के लिए अधिकृत नहीं है, तो सिस्टम एक एरर लौटाएगा। लंबा वीडियो पोस्ट करते समय `longVideo` twitterOptions पैरामीटर का उपयोग करें: ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## Mentions पोस्ट टेक्स्ट में `@handle` जोड़कर किसी अन्य X handle का उल्लेख करें। उदाहरण के लिए: ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` कृपया mentions पर [महत्वपूर्ण नियम](/testing/post-verification#mentions) देखें। ## Polls `twitterOptions` `poll` पैरामीटर के साथ एक X Poll आयोजित करें। ```json X Poll theme={"system"} { "twitterOptions": { "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required } } } ``` ## Quote Tweet आप low-level Tweet ID निर्दिष्ट करके किसी अन्य Tweet को quote कर सकते हैं। ID को [`/post`](/apis/post/post) response में `postIds` फील्ड, [get history](/apis/history/get-history) के माध्यम से, या सीधे Tweet URL से प्राप्त किया जा सकता है: [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 आप पोस्ट के लिए reply settings सेट कर सकते हैं ताकि केवल कुछ प्रकार के उपयोगकर्ताओं द्वारा उत्तर की अनुमति हो। ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` `replySettings` पैरामीटर निम्नलिखित मानों में से एक हो सकता है: ## Subscribers Only आप `subscribersOnly` पैरामीटर का उपयोग करके पोस्ट को केवल subscribers के लिए दृश्यमान होने के लिए सेट कर सकते हैं। ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Subtitles / Captions for Videos आप [SRT फाइल](https://en.wikipedia.org/wiki/SubRip) शामिल करके वीडियो में X subtitles, जिन्हें X captions भी कहा जाता है, जोड़ सकते हैं। अपने SRT फाइल के URL को निर्दिष्ट करने के लिए `twitterOptions` ऑब्जेक्ट में `subTitleUrl` फील्ड का उपयोग करें। ```json X Subtitles theme={"system"} { "twitterOptions": { "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English" } } ``` ## Video Thumbnail Twitter/X वीडियो के लिए एक थंबनेल (कवर इमेज) सेट करें। थंबनेल वीडियो चलने से पहले प्रदर्शित होता है और उपयोगकर्ताओं को वीडियो सामग्री को समझने में मदद करता है। `twitterOptions` ऑब्जेक्ट में `thumbNail` का उपयोग करें। ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## Video Metadata X पर पोस्ट किए गए वीडियो के लिए एक टाइटल और विवरण सेट करें। ये X Media Studio में title और description फील्ड्स से मैप होते हैं। `twitterOptions` ऑब्जेक्ट में `videoTitle` और `videoDescription` फील्ड्स का उपयोग करें। ```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) पर पोस्ट्स की एक कनेक्टेड सीरीज़ है जो आपको एकल पोस्ट की अक्षर सीमा से परे लंबे विचार साझा करने की अनुमति देती है, एक साथ देखे जाने पर एक निरंतर narrative के रूप में दिखाई देती है। X Thread ### एक Thread पोस्ट करना एक X Thread API के माध्यम से पोस्ट किया जा सकता है। एक thread एक पोस्ट है जो reply threads के एक सेट में विभाजित होता है और X में एक लाइन के साथ जुड़ा होता है। आप या तो पोस्ट को स्वचालित रूप से विभाजित कर सकते हैं या पोस्ट टेक्स्ट में [thread breaks](/apis/post/social-networks/x-twitter#thread-breaks) निर्दिष्ट कर सकते हैं। ```json X Thread theme={"system"} { "twitterOptions": { "thread": true, // required for TweetStorm "threadNumber": true, // optional to add numbers to each thread "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...] // optional one media object is added to a thread in order } } ``` यदि पोस्ट को X Thread के रूप में भेजा जाता है, तो लौटाए गए पोस्ट analytics Tweets की एक array होंगे, `"twitter": []`. अधिक जानकारी के लिए [Post Analytics 200 Response](/apis/analytics/post) देखें। #### 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 का उपयोग किया जा सकता है। उदाहरण के लिए: ```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 Breaks Ayrshare स्वचालित रूप से पोस्ट टेक्स्ट को उपयुक्त लंबाई के tweet (> 280 अक्षर) में विभाजित करता है। Threads बनाते समय, जब संभव हो हम एक पोस्ट में पूर्ण वाक्य रखने को प्राथमिकता देते हैं। यदि एक वाक्य फिट नहीं होगा, तो हम वाक्यों के बीच विभाजित करते हैं। बहुत लंबे वाक्यों के लिए, हम शब्दों के बीच विभाजित करते हैं। दुर्लभ मामलों में जहाँ एक शब्द बहुत लंबा होता है, हम स्वयं शब्द को विभाजित करते हैं। आप एक अद्वितीय thread बनाने का संकेत देने के लिए पोस्ट टेक्स्ट में `\n\n` के साथ पैराग्राफ भी मैन्युअल रूप से जोड़ सकते हैं। यदि आपके पोस्ट टेक्स्ट में `\n\n` है, तो हम पोस्ट को threads में स्वचालित रूप से विभाजित नहीं करेंगे। उदाहरण के लिए: ```json Example X Thread theme={"system"} { "post": "This is tweet 1\n\nThis is tweet 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` thread में दो 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 } } ``` चूंकि पोस्ट 280 अक्षरों से कम है, दो पैराग्राफ के साथ एक Tweet में परिणाम देगा। ### एक Thread हटाएं एक Tweet Storm हटाने के लिए, response में लौटाए गए top level पोस्ट ID के साथ [/post delete endpoint](/apis/post/delete-post) को कॉल करें। सभी threads हटा दिए जाएंगे। ## Character Limits अधिक जानकारी के लिए कृपया [X/Twitter Character Limits](/help-center/technical-support/character_limits#x%2Ftwitter-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 है। 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` पैरामीटर का उपयोग करके पोस्ट को केवल subscribers के लिए दृश्यमान होने के लिए सेट कर सकते हैं। ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Reply Settings आप पोस्ट के लिए reply settings सेट कर सकते हैं ताकि केवल कुछ प्रकार के उपयोगकर्ताओं द्वारा उत्तर की अनुमति हो। ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` `replySettings` पैरामीटर निम्नलिखित मानों में से एक हो सकता है: