> ## 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 اعتبارًا من 31 مارس 2026، تتطلب جميع عمليات X/Twitter استخدام بيانات اعتماد API الخاصة بك. بعد ربط حساب X الخاص بك عبر OAuth، قم بتضمين هذين الرأسين في كل طلب يستهدف X: | Header | Value | | ----------------------------- | ------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Your API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Your API Key Secret (Consumer Secret) | لم تقم بالربط بعد؟ راجع [دليل إعداد X BYO Key](/dashboard/connect-social-accounts/x-twitter-byo-keys) لربط حساب X الخاص بك. لم تعد Ayrshare تفرض حدود معدلها الشهرية أو اليومية الخاصة على X/Twitter. نظرًا لأن طلبات X تستخدم بيانات الاعتماد الخاصة بك (BYO)، فإن استخدامك يخضع فقط لحدود تطبيق X Developer الخاص بك. راجع [توثيق حدود معدل 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", // empty string is allowed "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"], // 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 هي حقول اختيارية يمكن استخدامها للتحكم في المنشور. نص بديل للصور للمساعدة في إمكانية الوصول وقارئات الشاشة. الحد الأقصى 1,000 حرف لكل نص بديل. راجع [النص البديل](/apis/post/social-networks/x-twitter#alt-text) لمزيد من المعلومات. تقييد الوسائط لبلدان معينة بحظر مناطق معينة. استخدم [رموز البلدان](/iso-codes/country). لا يمكن استخدامه مع `allowCountries`. راجع [القيود الجغرافية](/apis/post/social-networks/x-twitter#geo-restrictions) لمزيد من المعلومات. تقييد الوسائط لبلدان معينة بالسماح لمناطق معينة. استخدم [رموز البلدان](/iso-codes/country). لا يمكن استخدامه مع `blockCountries`. راجع [القيود الجغرافية](/apis/post/social-networks/x-twitter#geo-restrictions) لمزيد من المعلومات. تفعيل نشر المنشورات الطويلة حتى 25,000 حرف لمستخدمي Premium. راجع [المنشور الطويل](/apis/post/social-networks/x-twitter#long-post) لمزيد من المعلومات. السماح بنشر مقاطع فيديو أطول من دقيقتين و20 ثانية للحسابات المعتمدة. راجع [الفيديو الطويل](/apis/post/social-networks/x-twitter#long-video) لمزيد من المعلومات. إجراء استطلاعات رأي مع خيارات مخصصة ومدة محددة. الحقول المطلوبة: `duration` (رقم بالدقائق)، `options` (مصفوفة من السلاسل). راجع [الاستطلاعات](/apis/post/social-networks/x-twitter#polls) لمزيد من المعلومات. اقتبس تغريدة أخرى بتحديد معرف التغريدة. راجع [اقتباس التغريدة](/apis/post/social-networks/x-twitter#quote-tweet) لمزيد من المعلومات. التحكم فيمن يمكنه الرد على المنشور. القيم: `following`, `mentioned`, `subscribers`, أو `verified`. راجع [إعدادات الرد](/apis/post/social-networks/x-twitter#reply-settings) لمزيد من المعلومات. جعل المنشور مرئيًا للمشتركين فقط. راجع [للمشتركين فقط](/apis/post/social-networks/x-twitter#subscribers-only) لمزيد من المعلومات. إضافة ترجمات/تعليقات إلى مقاطع الفيديو باستخدام ملفات SRT. يجب أن يكون عنوان URL صالحًا لملف SRT ينتهي بـ `.srt`. راجع [الترجمات / التعليقات لمقاطع الفيديو](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos) لمزيد من المعلومات. لغة الترجمات. يجب أن تكون [رمز لغة](/iso-codes/language) صالحًا. اسم مسار التعليق. الحد الأقصى 150 حرفًا. تعيين صورة مصغرة (صورة غلاف) لمقاطع الفيديو. يجب أن يكون عنوان URL يشير إلى ملف صورة JPEG أو PNG أو BMP أو WebP. راجع [الصورة المصغرة للفيديو](/apis/post/social-networks/x-twitter#video-thumbnail) لمزيد من المعلومات و[إرشادات وسائط X](/media-guidelines/x_twitter#video-thumbnail) لمتطلبات الصورة. تعيين عنوان لفيديو. يتم تعيينه إلى حقل العنوان في X Media Studio. راجع [بيانات وصف الفيديو](/apis/post/social-networks/x-twitter#video-metadata) لمزيد من المعلومات. تعيين وصف لفيديو. يتم تعيينه إلى حقل الوصف في X Media Studio. راجع [بيانات وصف الفيديو](/apis/post/social-networks/x-twitter#video-metadata) لمزيد من المعلومات. تقسيم المنشورات الطويلة إلى سلاسل thread متصلة مع ترقيم ووسائط اختيارية. راجع [Threads](/apis/post/social-networks/x-twitter#thread) لمزيد من المعلومات. إضافة أرقام تلقائيًا في نهاية الـ threads بتنسيق 1/n. يتطلب `thread: true`. إضافة كائنات وسائط إلى الـ threads. سيتم إضافة كائن وسائط واحد إلى كل thread بالترتيب. استخدم `null` لتخطي الوسائط لـ thread معين. استخدم كائنات مع عناوين URL متعددة لعدة وسائط لكل thread. ## النص البديل أضف نصًا بديلًا، يُعرف أيضًا بـ alt text، إلى صورة تغريدة. النص البديل في X هو ميزة إمكانية الوصول المستخدمة لمعلومات المستخدم الإضافية وقارئات الشاشة. استخدم `altText` في كائن `twitterOptions`. ```json X Alt Text theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` يجب أن يتوافق كل نص بديل مع صورة في مصفوفة `mediaUrls`. سيتم تطبيق النص البديل على كل صورة بالترتيب. لا يمكن تطبيق النص البديل على مقاطع الفيديو. إذا تم تضمين فيديو في `mediaUrls` مع `altText`, فلن يتم نشر الفيديو. يجب أن يكون النص البديل 1,000 حرف أو أقل. ## القيود الجغرافية يمكنك تقييد وسائط 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 بلدًا معينًا، فسيتم تجاهل القيود الجغرافية. ## المنشور الطويل يتمتع المستخدمون الذين لديهم حسابات X Premium، مثل Premium أو Premium Plus، بالقدرة على نشر منشورات أطول تصل إلى 25,000 حرف. تسمح Ayrshare تلقائيًا بالمنشورات الطويلة للمستخدمين الذين لديهم حسابات X Premium. إذا قام المستخدم بتغيير حالة 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`. ## الفيديو الطويل *يتطلب Business أو Enterprise Plan.* تتطلب X أن يكون لمقاطع الفيديو [حد أقصى لطول الفيديو](/media-guidelines/x_twitter#video) قدره دقيقتان و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](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) قبل استخدام معامل `longVideo`. إذا لم يكن حساب X الخاص بالمستخدم مصرحًا له بنشر مقاطع فيديو طويلة، فسيقوم النظام بإرجاع خطأ. استخدم معامل `longVideo` في twitterOptions عند نشر فيديو طويل: ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## الإشارات اذكر مقبض X آخر بإضافة `@handle` في نص المنشور. على سبيل المثال: ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` يرجى مراجعة [القواعد المهمة](/testing/post-verification#mentions) بشأن الإشارات. ## الاستطلاعات قم بإجراء استطلاع X باستخدام معامل `poll` في `twitterOptions`. ```json X Poll theme={"system"} { "twitterOptions": { "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required } } } ``` ## اقتباس التغريدة يمكنك اقتباس تغريدة أخرى بتحديد معرّف التغريدة منخفض المستوى. يمكن استرداد المعرّف عبر استجابة [`/post`](/apis/post/post) في حقل `postIds`، أو [الحصول على السجل](/apis/history/get-history)، أو مباشرة من عنوان 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 } } ``` ## إعدادات الرد يمكنك تعيين إعدادات الرد لمنشور للسماح بالردود فقط من قِبل أنواع معينة من المستخدمين. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` يمكن أن يكون معامل `replySettings` واحدًا من القيم التالية: ## للمشتركين فقط يمكنك تعيين منشور ليكون مرئيًا للمشتركين فقط باستخدام معامل `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" } } ``` ## الصورة المصغرة للفيديو تعيين صورة مصغرة (صورة غلاف) لمقاطع فيديو Twitter/X. يتم عرض الصورة المصغرة قبل تشغيل الفيديو وتساعد المستخدمين على فهم محتوى الفيديو. استخدم `thumbNail` في كائن `twitterOptions`. ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## بيانات وصف الفيديو قم بتعيين عنوان ووصف لفيديو منشور على 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." } } ``` ## تحقيق الدخل من الفيديو (Pro Media) تدعم Ayrshare تحقيق الدخل من فيديو X (Twitter) للحسابات المؤهلة عبر برنامج X's Pro Media. هذه إمكانية محدودة الوصول — [تواصل معنا](mailto:support@ayrshare.com) إذا كنت ترغب في الوصول. ## Thread Thread X، المعروف أيضًا باسم tweetstorm، هو سلسلة متصلة من المنشورات على X (المعروفة سابقًا باسم Twitter) والتي تسمح لك بمشاركة أفكار أطول تتجاوز حد أحرف المنشور الواحد، وتظهر كسرد متواصل عند عرضها معًا. X Thread ### نشر Thread يمكن نشر X Thread عبر API. الـ thread هو منشور مقسم إلى مجموعة من ردود threads ومرتبط في X بخط. يمكنك إما تقسيم المنشور تلقائيًا أو تحديد [فواصل thread](/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، فستكون تحليلات المنشور المرجعة عبارة عن مصفوفة من التغريدات، `"twitter": []`. راجع [استجابة تحليلات المنشور 200](/apis/analytics/post) لمزيد من المعلومات. #### وسائط Thread ##### تخطي الوسائط تخطي الوسائط لـ thread باستخدام `null` في المصفوفة. على سبيل المثال: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` سيؤدي ذلك إلى وضع image1 في التغريدة الأولى، ولا صورة في التغريدة الثانية، و image2 في التغريدة الثالثة. ##### وسائط متعددة يمكن إضافة كائنات وسائط متعددة إلى تغريدة في 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" ] } } ``` في هذا المثال، ستحتوي التغريدة الأولى على photo-1.jpg، والتغريدة الثانية على photo-2.jpg و photo-3.jpg، والتغريدة الثالثة على photo-4.jpg. #### فواصل Thread تقوم Ayrshare تلقائيًا بتقسيم نص المنشور إلى تغريدات بطول مناسب (> 280 حرفًا). عند إنشاء threads، نعطي الأولوية للحفاظ على الجمل الكاملة في منشور واحد كلما أمكن. إذا كانت الجملة لا تناسب، نقوم بالتقسيم بين الجمل. للجمل الطويلة جدًا، نقوم بالتقسيم بين الكلمات. في الحالات النادرة التي تكون فيها الكلمة طويلة جدًا، نقوم بتقسيم الكلمة نفسها. يمكنك أيضًا إضافة فقرات يدويًا باستخدام `\n\n` إلى نص المنشور للإشارة إلى ضرورة إنشاء thread فريد. إذا كان لديك `\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. إذا كنت تريد إضافة فقرات، ولكن دون التقسيم إلى تغريدات، استخدم `\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 حرفًا. ### حذف Thread لحذف Tweet Storm، اتصل بـ [نقطة نهاية /post delete](/apis/post/delete-post) مع معرف المنشور من المستوى الأعلى المرجع في الاستجابة. سيتم حذف جميع الـ threads. ## حدود الأحرف يرجى الاطلاع على [حدود أحرف 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). ## للمشتركين فقط يمكنك تعيين منشور ليكون مرئيًا للمشتركين فقط باستخدام معامل `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## إعدادات الرد يمكنك تعيين إعدادات الرد لمنشور للسماح بالردود فقط من قِبل أنواع معينة من المستخدمين. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` يمكن أن يكون معامل `replySettings` واحدًا من القيم التالية: