> ## 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. # API X > Options de publication à l'aide de l'API X ## Clés d'API X BYO À partir du 31 mars 2026, toutes les opérations X/Twitter nécessitent vos propres identifiants API. Après avoir associé votre compte X via OAuth, incluez ces 2 en-têtes dans chaque requête ciblant X : | En-tête | Valeur | | ----------------------------- | -------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Votre API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Votre API Key Secret (Consumer Secret) | Pas encore associé ? Consultez le [guide de configuration des clés BYO pour X](/dashboard/connect-social-accounts/x-twitter-byo-keys) pour connecter votre compte X. Ayrshare n'impose plus ses propres limites de débit mensuelles ou quotidiennes pour X/Twitter. Puisque les requêtes X utilisent vos propres identifiants (BYO), votre utilisation est régie uniquement par les limites de votre propre X Developer App. Consultez la [documentation des limites de débit de l'API X](https://developer.x.com/en/docs/x-api/rate-limits) pour plus de détails. ## Publier sur X (Twitter) JSON pour une publication de base avec un lien et une image à l'aide de l'API X, anciennement connue sous le nom d'API Twitter : ```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"] } ``` ## Options X Vous pouvez définir des options supplémentaires pour une publication en utilisant le paramètre `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"], } } ``` Les options X sont des champs facultatifs qui peuvent être utilisés pour contrôler la publication. Texte alternatif pour les images afin de faciliter l'accessibilité et les lecteurs d'écran. Maximum 1 000 caractères par alt text. Consultez [Alt Text](/apis/post/social-networks/x-twitter#alt-text) pour plus d'informations. Restreignez le média à des pays spécifiques en bloquant certaines régions. Utilisez les [codes pays](/iso-codes/country). Ne peut pas être utilisé avec `allowCountries`. Consultez [Restrictions géographiques](/apis/post/social-networks/x-twitter#geo-restrictions) pour plus d'informations. Restreignez le média à des pays spécifiques en autorisant certaines régions. Utilisez les [codes pays](/iso-codes/country). Ne peut pas être utilisé avec `blockCountries`. Consultez [Restrictions géographiques](/apis/post/social-networks/x-twitter#geo-restrictions) pour plus d'informations. Active la publication de posts plus longs, jusqu'à 25 000 caractères, pour les utilisateurs Premium. Consultez [Long Post](/apis/post/social-networks/x-twitter#long-post) pour plus d'informations. Autorise la publication de vidéos de plus de 2 minutes et 20 secondes pour les comptes approuvés. Consultez [Long Video](/apis/post/social-networks/x-twitter#long-video) pour plus d'informations. Réalisez des sondages avec des options et une durée personnalisées. Champs obligatoires : `duration` (nombre en minutes), `options` (tableau de chaînes). Consultez [Sondages](/apis/post/social-networks/x-twitter#polls) pour plus d'informations. Citez un autre tweet en spécifiant l'ID du Tweet. Consultez [Quote Tweet](/apis/post/social-networks/x-twitter#quote-tweet) pour plus d'informations. Contrôlez qui peut répondre à la publication. Valeurs : `following`, `mentioned`, `subscribers` ou `verified`. Consultez [Paramètres de réponse](/apis/post/social-networks/x-twitter#reply-settings) pour plus d'informations. Rend la publication visible uniquement par les abonnés. Consultez [Abonnés uniquement](/apis/post/social-networks/x-twitter#subscribers-only) pour plus d'informations. Ajoutez des sous-titres/légendes aux vidéos à l'aide de fichiers SRT. Doit être une URL de fichier SRT valide se terminant par `.srt`. Consultez [Sous-titres / Légendes pour vidéos](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos) pour plus d'informations. La langue des sous-titres. Doit être un [code de langue](/iso-codes/language) valide. Le nom de la piste de sous-titres. Maximum 150 caractères. Définit une miniature (image de couverture) pour les vidéos. Doit être une URL vers un fichier image JPEG, PNG, BMP ou WebP. Consultez [Miniature vidéo](/apis/post/social-networks/x-twitter#video-thumbnail) pour plus d'informations et [X Media Guidelines](/media-guidelines/x_twitter#video-thumbnail) pour les exigences d'image. Définit le titre d'une vidéo. Correspond au champ title dans X Media Studio. Consultez [Métadonnées vidéo](/apis/post/social-networks/x-twitter#video-metadata) pour plus d'informations. Définit la description d'une vidéo. Correspond au champ description dans X Media Studio. Consultez [Métadonnées vidéo](/apis/post/social-networks/x-twitter#video-metadata) pour plus d'informations. Divise de longues publications en une série de threads connectés avec numérotation et médias facultatifs. Consultez [Threads](/apis/post/social-networks/x-twitter#thread) pour plus d'informations. Ajoute automatiquement des numéros à la fin des threads au format 1/n. Nécessite `thread: true`. Ajoutez des objets média aux threads. Un objet média sera ajouté à chaque thread dans l'ordre. Utilisez `null` pour ignorer le média d'un thread spécifique. Utilisez des objets avec plusieurs URLs pour plusieurs médias par thread. ## Alt Text Ajoutez du texte alternatif, également appelé alt text, à l'image d'un Tweet. L'alt text X est une fonctionnalité d'accessibilité utilisée pour fournir des informations supplémentaires aux utilisateurs et aux lecteurs d'écran. Utilisez `altText` dans l'objet `twitterOptions`. ```json X Alt Text theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` Chaque alt text doit correspondre à une image du tableau `mediaUrls`. L'alt text est appliqué à chaque image dans l'ordre. L'alt text ne peut pas être appliqué aux vidéos. Si une vidéo est incluse dans `mediaUrls` avec un `altText`, la vidéo ne sera pas publiée. L'alt text doit faire 1 000 caractères ou moins. ## Restrictions géographiques Vous pouvez restreindre les médias X, tels qu'une image ou une vidéo, à des pays spécifiques en utilisant les paramètres `blockCountries` et `allowCountries` avec des [codes pays](/iso-codes/country). La publication sera toujours visible dans tous les pays, mais le média ne sera pas disponible dans les pays spécifiés. ```json Block Countries theme={"system"} { "twitterOptions": { "blockCountries": ["US", "CA"] } } ``` ```json Allow Countries theme={"system"} { "twitterOptions": { "allowCountries": ["GB", "IE"] } } ``` Vous ne devez utiliser qu'un seul des paramètres `blockCountries` ou `allowCountries` à la fois. Si les deux paramètres sont utilisés ou si un pays n'est pas pris en charge par X, les restrictions géographiques seront ignorées. ## Long Post Les utilisateurs disposant d'un compte X Premium, tel que Premium ou Premium Plus, ont la possibilité de publier des posts plus longs, jusqu'à 25 000 caractères. Ayrshare autorise automatiquement les long posts pour les utilisateurs disposant d'un compte X Premium. Si l'utilisateur modifie son statut X Premium, attendez 24 heures pour que ce changement soit reflété dans Ayrshare. Vous pouvez vérifier le statut d'abonnement Premium d'un utilisateur avec les points de terminaison [/user](/apis/user/overview) ou [/analytics](/apis/analytics/social). Vous pouvez également forcer l'acceptation d'un long form post avec le paramètre de corps `longPost`. Cela peut être fait en incluant le JSON suivant dans votre requête : ```json X Long Post theme={"system"} { "twitterOptions": { "longPost": true } } ``` Cependant, si un utilisateur sans compte Premium tente de publier un long tweet, le système renverra une erreur `code: 111`. ## Long Video *Business Plan ou Enterprise Plan requis.* X exige que les vidéos aient une [longueur maximale](/media-guidelines/x_twitter#video) de 2 minutes et 20 secondes. Toutefois, si vous avez été approuvé par X pour téléverser des vidéos plus longues, par exemple si le compte X de l'utilisateur est un compte Premium ou fait partie du [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers), vous pouvez publier des vidéos jusqu'à 10 minutes ou plus. Vérifiez que le compte X de votre utilisateur est Premium ou fait partie du [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) avant d'utiliser le paramètre `longVideo`. Si le compte X de votre utilisateur n'est pas autorisé à publier de longues vidéos, le système renverra une erreur. Utilisez le paramètre `longVideo` de twitterOptions lors de la publication d'une longue vidéo : ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## Mentions Mentionnez un autre handle X en ajoutant `@handle` dans le texte de la publication. Par exemple : ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` Consultez les [règles importantes](/testing/post-verification#mentions) concernant les mentions. ## Sondages Réalisez un sondage X avec le paramètre `poll` de `twitterOptions`. ```json X Poll theme={"system"} { "twitterOptions": { "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required } } } ``` ## Quote Tweet Vous pouvez citer un autre Tweet en spécifiant l'ID de Tweet de bas niveau. L'ID peut être récupéré via la réponse [`/post`](/apis/post/post) dans le champ `postIds`, via [get history](/apis/history/get-history), ou directement depuis l'URL du 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 } } ``` ## Paramètres de réponse Vous pouvez définir les paramètres de réponse d'une publication pour n'autoriser les réponses que de certains types d'utilisateurs. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` Le paramètre `replySettings` peut prendre l'une des valeurs suivantes : ## Abonnés uniquement Vous pouvez rendre une publication visible uniquement par les abonnés en utilisant le paramètre `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Sous-titres / Légendes pour vidéos Vous pouvez ajouter des sous-titres X, également appelés légendes X, aux vidéos en incluant un [fichier SRT](https://en.wikipedia.org/wiki/SubRip). Utilisez le champ `subTitleUrl` dans l'objet `twitterOptions` pour spécifier l'URL de votre fichier SRT. ```json X Subtitles theme={"system"} { "twitterOptions": { "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English" } } ``` ## Miniature vidéo Définissez une miniature (image de couverture) pour les vidéos Twitter/X. La miniature est affichée avant la lecture de la vidéo et aide les utilisateurs à comprendre le contenu vidéo. Utilisez `thumbNail` dans l'objet `twitterOptions`. ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## Métadonnées vidéo Définissez un titre et une description pour une vidéo publiée sur X. Ils correspondent aux champs titre et description dans X Media Studio. Utilisez les champs `videoTitle` et `videoDescription` dans l'objet `twitterOptions`. ```json X Video Metadata theme={"system"} { "twitterOptions": { "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release." } } ``` ## Monétisation vidéo (Pro Media) Ayrshare prend en charge la monétisation vidéo X (Twitter) pour les comptes éligibles via le programme Pro Media de X. Il s'agit d'une capacité à accès limité — [contactez-nous](mailto:support@ayrshare.com) si vous souhaitez y accéder. ## Thread Un X Thread, également appelé tweetstorm, est une série connectée de publications sur X (anciennement Twitter) qui vous permet de partager des idées plus longues au-delà de la limite de caractères d'une seule publication, apparaissant comme un récit continu lorsqu'elles sont vues ensemble. X Thread ### Publier un Thread Un X Thread peut être publié via l'API. Un thread est une publication divisée en un ensemble de threads de réponse et associées dans X par une ligne. Vous pouvez soit diviser automatiquement la publication, soit spécifier les [ruptures de thread](/apis/post/social-networks/x-twitter#thread-breaks) dans le texte de la publication. ```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 } } ``` Si la publication est envoyée en tant que X Thread, les statistiques de publication renvoyées seront un tableau de Tweets, `"twitter": []`. Consultez [Post Analytics 200 Response](/apis/analytics/post) pour plus d'informations. #### Média de thread ##### Ignorer un média Ignorez le média du thread en utilisant `null` dans le tableau. Par exemple : `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Cela placera image1 dans le premier Tweet, aucune image dans le deuxième et image2 dans le troisième. ##### Plusieurs médias Plusieurs objets média peuvent être ajoutés à un Tweet d'un Thread en ajoutant un objet `{}` avec les URLs de média dans le tableau `mediaUrls`. Toutes clés d'objet uniques peuvent être utilisées. Par exemple : ```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" ] } } ``` Dans cet exemple, le premier Tweet contiendra photo-1.jpg, le deuxième photo-2.jpg et photo-3.jpg, et le troisième photo-4.jpg. #### Ruptures de thread Ayrshare divise automatiquement le texte de la publication en tweets de longueur appropriée (> 280 caractères). Lors de la création de threads, nous privilégions le maintien de phrases complètes dans une même publication quand c'est possible. Si une phrase ne rentre pas, nous coupons entre les phrases. Pour les phrases très longues, nous coupons entre les mots. Dans les rares cas où un mot est trop long, nous coupons le mot lui-même. Vous pouvez également ajouter manuellement des paragraphes avec `\n\n` dans le texte de la publication pour indiquer qu'un nouveau thread doit être créé. Si `\n\n` figure dans le texte de la publication, nous ne diviserons pas automatiquement la publication en threads. Par exemple : ```json Example X Thread theme={"system"} { "post": "This is tweet 1\n\nThis is tweet 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` produira deux Tweets dans le thread. Si vous souhaitez ajouter des paragraphes sans diviser en Tweets, utilisez `\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 } } ``` produira un Tweet avec deux paragraphes puisque la publication fait moins de 280 caractères. ### Supprimer un Thread Pour supprimer un Tweet Storm, appelez le [point de terminaison de suppression /post](/apis/post/delete-post) avec l'ID de publication de premier niveau renvoyé dans la réponse. Tous les threads seront supprimés. ## Limites de caractères Consultez [X/Twitter Character Limits](/help-center/technical-support/character_limits#x%2Ftwitter-character-limits) pour plus d'informations. ## Compatibilité vidéo X Certains logiciels vidéo créent des fichiers MP4 qui ne sont pas compatibles avec X. Par exemple, les versions de Camtasia antérieures à 2019.0.9 créent des fichiers MP4 que X rejette. La présence de plusieurs pistes audio pose également souvent problème. Si vous recevez le message suivant lors de la publication, cela indique que la vidéo n'est pas compatible avec Twitter et doit être ré-encodée. `"file is currently unsupported"` Vérifiez la compatibilité de votre logiciel vidéo. Par exemple, Adobe Media Encoder dispose d'un préréglage d'exportation pour Twitter 1080p Full HD. Adobe Media Encoder Consultez ici pour [plus d'exemples d'API X](https://www.ayrshare.com/twitter-api-how-to-post-and-get-analytics-with-the-twitter-api#twitter-api-examples). ## Abonnés uniquement Vous pouvez rendre une publication visible uniquement par les abonnés en utilisant le paramètre `subscribersOnly`. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Paramètres de réponse Vous pouvez définir les paramètres de réponse d'une publication pour n'autoriser les réponses que de certains types d'utilisateurs. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` Le paramètre `replySettings` peut prendre l'une des valeurs suivantes :