Skip to main content

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
X options वैकल्पिक फील्ड हैं जिनका उपयोग पोस्ट को नियंत्रित करने के लिए किया जा सकता है।
array of strings
एक्सेसिबिलिटी और स्क्रीन रीडर्स में सहायता के लिए इमेज के लिए वैकल्पिक टेक्स्ट। प्रति alt text अधिकतम 1,000 अक्षर।अधिक जानकारी के लिए Alt Text देखें।
array of strings
कुछ क्षेत्रों को ब्लॉक करके मीडिया को विशिष्ट देशों तक सीमित करें। country codes का उपयोग करें।allowCountries के साथ उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए Geo Restrictions देखें।
array of strings
कुछ क्षेत्रों को अनुमति देकर मीडिया को विशिष्ट देशों तक सीमित करें। country codes का उपयोग करें।blockCountries के साथ उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए Geo Restrictions देखें।
boolean
डिफ़ॉल्ट:false
Premium उपयोगकर्ताओं के लिए 25,000 अक्षरों तक की लंबी पोस्ट पोस्ट करने की सुविधा सक्षम करें।अधिक जानकारी के लिए Long Post देखें।
boolean
डिफ़ॉल्ट:false
अनुमोदित अकाउंट्स के लिए 2 मिनट 20 सेकंड से अधिक लंबे वीडियो पोस्ट करने की अनुमति दें।अधिक जानकारी के लिए Long Video देखें।
object
कस्टम विकल्पों और अवधि के साथ पोल आयोजित करें।आवश्यक फील्ड्स: duration (मिनट में संख्या), options (स्ट्रिंग्स की array)।अधिक जानकारी के लिए Polls देखें।
string
Tweet ID निर्दिष्ट करके किसी अन्य tweet को quote करें।अधिक जानकारी के लिए Quote Tweet देखें।
string
नियंत्रित करें कि पोस्ट का उत्तर कौन दे सकता है।मान: following, mentioned, subscribers, या verifiedअधिक जानकारी के लिए Reply Settings देखें।
boolean
डिफ़ॉल्ट:false
पोस्ट को केवल subscribers के लिए दृश्यमान बनाएं।अधिक जानकारी के लिए Subscribers Only देखें।
boolean
डिफ़ॉल्ट:false
यह प्रकट करने के लिए कि पोस्ट में AI-generated media शामिल है, X का “Made with AI” लेबल लागू करें।true और "true" दोनों लेबल लागू करते हैं। कोई भी अन्य मान लेबल को लागू नहीं करता है। पोस्ट फिर भी प्रकाशित होती है और response में एक warnings entry जोड़ी जाती है जो कारण बताती है।
यह लेबल केवल उन पोस्ट पर लागू होता है जिनमें media शामिल है, और पोस्ट करने के बाद इसे बदला नहीं जा सकता। यह तत्काल, scheduled और threaded पोस्ट पर लागू होता है।
Media type: image, videoअधिक जानकारी के लिए Made with AI देखें।
string
SRT फाइलों का उपयोग करके वीडियो में subtitles/captions जोड़ें। एक मान्य SRT फाइल URL होना चाहिए जो .srt में समाप्त होता हो।अधिक जानकारी के लिए Subtitles / Captions for Videos देखें।
string
डिफ़ॉल्ट:"en"
Subtitles की भाषा। एक मान्य language code होना चाहिए।
string
Caption track का नाम। अधिकतम 150 अक्षर।
string
वीडियो के लिए एक थंबनेल (कवर इमेज) सेट करें। JPEG, PNG, BMP, या WebP इमेज फाइल का URL होना चाहिए।अधिक जानकारी के लिए Video Thumbnail और इमेज आवश्यकताओं के लिए X Media Guidelines देखें।
string
वीडियो के लिए टाइटल सेट करें। X Media Studio में title फील्ड से मैप होता है।अधिक जानकारी के लिए Video Metadata देखें।
string
वीडियो के लिए विवरण सेट करें। X Media Studio में description फील्ड से मैप होता है।अधिक जानकारी के लिए Video Metadata देखें।
boolean
डिफ़ॉल्ट:false
वैकल्पिक नंबरिंग और मीडिया के साथ लंबी पोस्ट को कनेक्टेड thread सीरीज़ में विभाजित करें।अधिक जानकारी के लिए Threads देखें।
boolean
डिफ़ॉल्ट:false
1/n के प्रारूप में threads के अंत में स्वचालित रूप से नंबर जोड़ें।thread: true की आवश्यकता है।
array of strings
Threads में मीडिया ऑब्जेक्ट्स जोड़ें। क्रम में प्रत्येक thread में एक मीडिया ऑब्जेक्ट जोड़ा जाएगा।किसी विशिष्ट thread के लिए मीडिया छोड़ने के लिए null का उपयोग करें। प्रति thread एकाधिक मीडिया के लिए एकाधिक URLs के साथ ऑब्जेक्ट्स का उपयोग करें।

Alt Text

Tweet की इमेज में वैकल्पिक टेक्स्ट, जिसे alt text भी कहा जाता है, जोड़ें। X alt text एक एक्सेसिबिलिटी फीचर है जिसका उपयोग अतिरिक्त उपयोगकर्ता जानकारी और स्क्रीन रीडर्स के लिए किया जाता है। twitterOptions ऑब्जेक्ट में altText का उपयोग करें।
X Alt Text
प्रत्येक 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
हालांकि, यदि Premium अकाउंट के बिना कोई उपयोगकर्ता एक long tweet पोस्ट करने का प्रयास करता है, तो सिस्टम एक code: 111 एरर लौटाएगा।

Long Video

Business या Enterprise Plan आवश्यक है। X के लिए वीडियो में अधिकतम वीडियो लंबाई 2 मिनट और 20 सेकंड होनी चाहिए। हालांकि, यदि आपको X द्वारा लंबे वीडियो अपलोड करने की अनुमोदन प्राप्त है, जैसे कि यदि उपयोगकर्ता का X अकाउंट Premium अकाउंट है या Amplify Partner Program में है, तो आप 10+ मिनट तक की लंबाई के वीडियो पोस्ट कर सकते हैं।
कृपया longVideo पैरामीटर का उपयोग करने से पहले सत्यापित करें कि आपके उपयोगकर्ता का X अकाउंट Premium या Amplify Partner Program में है। यदि आपके उपयोगकर्ता का X अकाउंट लंबे वीडियो पोस्ट करने के लिए अधिकृत नहीं है, तो सिस्टम एक एरर लौटाएगा।
लंबा वीडियो पोस्ट करते समय longVideo twitterOptions पैरामीटर का उपयोग करें:
X Long Video

Mentions

पोस्ट टेक्स्ट में @handle जोड़कर किसी अन्य X handle का उल्लेख करें। उदाहरण के लिए:
X Mention
कृपया mentions पर महत्वपूर्ण नियम देखें।

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

Made with AI

यह प्रकट करने के लिए कि किसी पोस्ट में AI-generated media शामिल है, X का native “Made with AI” लेबल लागू करें। twitterOptions ऑब्जेक्ट में isAIGenerated फील्ड को true पर सेट करें।
X Made with AI

Accepted Values

boolean true और string "true" दोनों लेबल लागू करते हैं; false और "false" इसे लागू नहीं करते। कोई भी अन्य मान, उदाहरण के लिए "yes" या 1, भी लेबल लागू नहीं करता, लेकिन request कभी विफल नहीं होती। पोस्ट सामान्य रूप से प्रकाशित होती है और response में एक warnings entry जोड़ी जाती है जो स्वीकार्य मानों की सूची देती है।
Ayrshare का MCP Server isAIGenerated को strict boolean के रूप में लेता है। "true" नहीं, true पास करें।
यह लेबल केवल उन पोस्ट पर लागू होता है जिनमें media (image या video) शामिल हो। केवल-text पोस्ट पर इसका कोई प्रभाव नहीं पड़ता, और पोस्ट प्रकाशित होने के बाद इसे बदला नहीं जा सकता।
यह तत्काल, scheduled और threaded पोस्ट पर लागू होता है। एक scheduled पोस्ट उसी “Made with AI” लेबल के साथ प्रकाशित होती है जो उसे तत्काल पोस्ट करने पर मिलता। किसी thread पर, media युक्त प्रत्येक भाग को लेबल किया जाता है।

Subtitles / Captions for Videos

आप SRT फाइल शामिल करके वीडियो में X subtitles, जिन्हें X captions भी कहा जाता है, जोड़ सकते हैं। अपने SRT फाइल के URL को निर्दिष्ट करने के लिए twitterOptions ऑब्जेक्ट में subTitleUrl फील्ड का उपयोग करें।
X Subtitles
  • subTitleUrl: एक मान्य SRT फाइल। URL https:// से शुरू होना चाहिए और .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 के रूप में दिखाई देती है। X Thread

एक Thread पोस्ट करना

एक X Thread API के माध्यम से पोस्ट किया जा सकता है। एक thread एक पोस्ट है जो reply threads के एक सेट में विभाजित होता है और X में एक लाइन के साथ जुड़ा होता है। आप या तो पोस्ट को स्वचालित रूप से विभाजित कर सकते हैं या पोस्ट टेक्स्ट में thread breaks निर्दिष्ट कर सकते हैं।
X Thread
  • thread: true लाइन ब्रेक्स के आधार पर पोस्ट टेक्स्ट को threads में स्वचालित रूप से विभाजित करने के लिए।
  • threadNumber: true 1/n के प्रारूप में threads के अंत में स्वचालित रूप से नंबर जोड़ने के लिए। उदाहरण के लिए 5 threads में से 2nd में जोड़ा जाएगा: 2/5
  • mediaUrls: [array of urls] क्रम में एक thread में प्रत्येक मीडिया ऑब्जेक्ट, एक इमेज या वीडियो, जोड़ने के लिए। क्रम में एक thread में केवल एक मीडिया ऑब्जेक्ट जोड़ा जाएगा।
यदि पोस्ट को X Thread के रूप में भेजा जाता है, तो लौटाए गए पोस्ट analytics Tweets की एक array होंगे, "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
इस उदाहरण में, पहला 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 में स्वचालित रूप से विभाजित नहीं करेंगे। उदाहरण के लिए:
Example X Thread
thread में दो Tweets में परिणाम देगा। यदि आप पैराग्राफ जोड़ना चाहते हैं, लेकिन Tweets में विभाजित नहीं करना चाहते हैं, तो \u2063\n\u2063\n का उपयोग करें
X Thread with Paragraphs
चूंकि पोस्ट 280 अक्षरों से कम है, दो पैराग्राफ के साथ एक Tweet में परिणाम देगा।

एक 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 है। Adobe Media Encoder कृपया यहाँ अधिक X API उदाहरण देखें।

Subscribers Only

आप subscribersOnly पैरामीटर का उपयोग करके पोस्ट को केवल subscribers के लिए दृश्यमान होने के लिए सेट कर सकते हैं।
X Subscribers Only

Reply Settings

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