> ## 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 > Optionen zum Posten mit der X API ## X BYO-API-Schlüssel Ab dem 31. März 2026 erfordern alle X-/Twitter-Vorgänge Ihre eigenen API-Anmeldedaten. Nachdem Sie Ihr X-Konto über OAuth verknüpft haben, fügen Sie in jeder Anfrage, die sich an X richtet, diese 2 Header hinzu: | Header | Wert | | ----------------------------- | ------------------------------------ | | `X-Twitter-OAuth1-Api-Key` | Ihr API-Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Ihr API-Key-Secret (Consumer Secret) | Noch nicht verknüpft? Siehe den [X BYO Key Setup-Leitfaden](/dashboard/connect-social-accounts/x-twitter-byo-keys), um Ihr X-Konto zu verbinden. Ayrshare wendet keine eigenen monatlichen oder täglichen X-/Twitter-Rate-Limits mehr an. Da X-Anfragen Ihre eigenen Anmeldedaten verwenden (BYO), wird Ihre Nutzung ausschließlich durch die Limits Ihrer eigenen X Developer-App bestimmt. Details finden Sie in der [Dokumentation zu den X-API-Rate-Limits](https://developer.x.com/en/docs/x-api/rate-limits). ## Posten auf X (Twitter) JSON für einen einfachen Beitrag mit Link und Bild über die X API (früher bekannt als 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-Optionen Sie können zusätzliche Optionen für einen Beitrag über den Parameter `twitterOptions` festlegen. ```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-Optionen sind optionale Felder, mit denen sich der Beitrag steuern lässt. Alternativtext für Bilder zur Barrierefreiheit und für Screenreader. Maximal 1.000 Zeichen pro Alt-Text. Weitere Informationen finden Sie unter [Alt-Text](/apis/post/social-networks/x-twitter#alt-text). Beschränken Sie Medien auf bestimmte Länder, indem Sie bestimmte Regionen blockieren. Verwenden Sie [Ländercodes](/iso-codes/country). Kann nicht zusammen mit `allowCountries` verwendet werden. Weitere Informationen finden Sie unter [Geo-Beschränkungen](/apis/post/social-networks/x-twitter#geo-restrictions). Beschränken Sie Medien auf bestimmte Länder, indem Sie bestimmte Regionen erlauben. Verwenden Sie [Ländercodes](/iso-codes/country). Kann nicht zusammen mit `blockCountries` verwendet werden. Weitere Informationen finden Sie unter [Geo-Beschränkungen](/apis/post/social-networks/x-twitter#geo-restrictions). Ermöglicht das Posten längerer Beiträge mit bis zu 25.000 Zeichen für Premium-Nutzer. Weitere Informationen finden Sie unter [Long Post](/apis/post/social-networks/x-twitter#long-post). Erlaubt das Posten von Videos, die länger als 2 Minuten und 20 Sekunden sind, für zugelassene Konten. Weitere Informationen finden Sie unter [Long Video](/apis/post/social-networks/x-twitter#long-video). Führen Sie Umfragen mit benutzerdefinierten Optionen und Dauer durch. Pflichtfelder: `duration` (Zahl in Minuten), `options` (Array von Strings). Weitere Informationen finden Sie unter [Umfragen](/apis/post/social-networks/x-twitter#polls). Zitieren Sie einen anderen Tweet, indem Sie die Tweet-ID angeben. Weitere Informationen finden Sie unter [Quote Tweet](/apis/post/social-networks/x-twitter#quote-tweet). Steuern Sie, wer auf den Beitrag antworten kann. Werte: `following`, `mentioned`, `subscribers` oder `verified`. Weitere Informationen finden Sie unter [Antwort-Einstellungen](/apis/post/social-networks/x-twitter#reply-settings). Machen Sie den Beitrag nur für Abonnenten sichtbar. Weitere Informationen finden Sie unter [Nur für Abonnenten](/apis/post/social-networks/x-twitter#subscribers-only). Fügen Sie Videos Untertitel/Captions über SRT-Dateien hinzu. Muss eine gültige SRT-Datei-URL sein, die auf `.srt` endet. Weitere Informationen finden Sie unter [Untertitel/Captions für Videos](/apis/post/social-networks/x-twitter#subtitles-captions-for-videos). Die Sprache der Untertitel. Muss ein gültiger [Sprachcode](/iso-codes/language) sein. Der Name der Untertitelspur. Maximal 150 Zeichen. Legen Sie ein Thumbnail (Titelbild) für Videos fest. Muss eine URL zu einer JPEG-, PNG-, BMP- oder WebP-Bilddatei sein. Weitere Informationen finden Sie unter [Video-Thumbnail](/apis/post/social-networks/x-twitter#video-thumbnail) und in den [X-Medienrichtlinien](/media-guidelines/x_twitter#video-thumbnail) zu den Bildanforderungen. Legen Sie den Titel für ein Video fest. Wird auf das Titelfeld in X Media Studio abgebildet. Weitere Informationen finden Sie unter [Video-Metadaten](/apis/post/social-networks/x-twitter#video-metadata). Legen Sie die Beschreibung für ein Video fest. Wird auf das Beschreibungsfeld in X Media Studio abgebildet. Weitere Informationen finden Sie unter [Video-Metadaten](/apis/post/social-networks/x-twitter#video-metadata). Teilen Sie lange Beiträge in zusammenhängende Thread-Serien mit optionaler Nummerierung und Medien. Weitere Informationen finden Sie unter [Threads](/apis/post/social-networks/x-twitter#thread). Fügt automatisch am Ende von Threads Nummern im Format 1/n hinzu. Erfordert `thread: true`. Fügen Sie Threads Medienobjekte hinzu. Jeweils ein Medienobjekt wird pro Thread in Reihenfolge hinzugefügt. Verwenden Sie `null`, um Medien für einen bestimmten Thread zu überspringen. Verwenden Sie Objekte mit mehreren URLs für mehrere Medien pro Thread. ## Alt-Text Fügen Sie dem Bild eines Tweets einen Alternativtext (Alt-Text) hinzu. Der X-Alt-Text ist eine Barrierefreiheitsfunktion für zusätzliche Nutzerinformationen und Screenreader. Verwenden Sie `altText` im Objekt `twitterOptions`. ```json X Alt Text theme={"system"} { "twitterOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` Jeder Alt-Text muss einem Bild im Array `mediaUrls` entsprechen. Der Alt-Text wird in der angegebenen Reihenfolge auf jedes Bild angewendet. Alt-Text kann nicht auf Videos angewendet werden. Wenn ein Video in `mediaUrls` zusammen mit `altText` enthalten ist, wird das Video nicht gepostet. Alt-Text darf maximal 1.000 Zeichen umfassen. ## Geo-Beschränkungen Sie können X-Medien wie Bilder oder Videos mit den Parametern `blockCountries` und `allowCountries` und [Ländercodes](/iso-codes/country) auf bestimmte Länder beschränken. Der Beitrag wird weiterhin in allen Ländern angezeigt, die Medien sind jedoch in den angegebenen Ländern nicht verfügbar. ```json Block Countries theme={"system"} { "twitterOptions": { "blockCountries": ["US", "CA"] } } ``` ```json Allow Countries theme={"system"} { "twitterOptions": { "allowCountries": ["GB", "IE"] } } ``` Verwenden Sie nur einen der Parameter `blockCountries` oder `allowCountries` gleichzeitig. Wenn beide Parameter verwendet werden oder ein Land von X nicht unterstützt wird, werden die Geo-Beschränkungen ignoriert. ## Long Post Nutzer mit Premium-X-Konten wie Premium oder Premium Plus können längere Beiträge mit bis zu 25.000 Zeichen posten. Ayrshare erlaubt Nutzern mit Premium-X-Konten automatisch Long-Form-Beiträge. Wenn der Nutzer seinen X-Premium-Status ändert, warten Sie bitte 24 Stunden, bis dies in Ayrshare wirksam wird. Sie können den Premium-Abonnementstatus eines Nutzers über die Endpunkte [/user](/apis/user/overview) oder [/analytics](/apis/analytics/social) prüfen. Sie können auch erzwingen, dass ein Long-Form-Beitrag akzeptiert wird, indem Sie den Body-Parameter `longPost` verwenden. Dies können Sie tun, indem Sie das folgende JSON in Ihre Anfrage aufnehmen: ```json X Long Post theme={"system"} { "twitterOptions": { "longPost": true } } ``` Versucht jedoch ein Nutzer ohne Premium-Konto, einen langen Tweet zu posten, gibt das System einen `code: 111`-Fehler zurück. ## Long Video *Business- oder Enterprise-Plan erforderlich.* X schreibt eine [maximale Videolänge](/media-guidelines/x_twitter#video) von 2 Minuten und 20 Sekunden vor. Wenn Sie jedoch von X für längere Videos zugelassen sind, etwa weil das X-Konto des Nutzers ein Premium-Konto ist oder am [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) teilnimmt, können Sie Videos mit einer Länge von 10+ Minuten posten. Prüfen Sie, ob das X-Konto Ihres Nutzers Premium oder Teil des [Amplify Partner Program](https://media.twitter.com/en/articles/products/2018/in-stream-video-ads-for-publishers) ist, bevor Sie den Parameter `longVideo` verwenden. Ist das X-Konto Ihres Nutzers nicht berechtigt, lange Videos zu posten, gibt das System einen Fehler zurück. Verwenden Sie beim Posten eines langen Videos den `longVideo`-Parameter in twitterOptions: ```json X Long Video theme={"system"} { "twitterOptions": { "longVideo": true } } ``` ## Erwähnungen Erwähnen Sie einen anderen X-Handle, indem Sie `@handle` im Beitragstext hinzufügen. Beispiel: ```json X Mention theme={"system"} { "post": "The best social media API @Ayrshare ever!", "platforms": ["twitter"] } ``` Bitte lesen Sie die [wichtigen Regeln](/testing/post-verification#mentions) zu Erwähnungen. ## Umfragen Führen Sie eine X-Umfrage mit dem Parameter `poll` von `twitterOptions` durch. ```json X Poll theme={"system"} { "twitterOptions": { "poll": { "duration": 5, // required. Number in minutes "options": ["yes", "maybe", "no"] // required } } } ``` ## Quote Tweet Sie können einen anderen Tweet zitieren, indem Sie die Low-Level-Tweet-ID angeben. Die ID kann über die [`/post`](/apis/post/post)-Antwort im Feld `postIds`, über [Verlauf abrufen](/apis/history/get-history) oder direkt aus der Tweet-URL abgerufen werden: [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 } } ``` ## Antwort-Einstellungen Sie können die Antwort-Einstellungen eines Beitrags so festlegen, dass nur bestimmte Nutzertypen antworten dürfen. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` Der Parameter `replySettings` kann einen der folgenden Werte annehmen: ## Nur für Abonnenten Sie können einen Beitrag so festlegen, dass er nur für Abonnenten sichtbar ist, indem Sie den Parameter `subscribersOnly` verwenden. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Untertitel/Captions für Videos Sie können X-Untertitel (auch X-Captions genannt) zu Videos hinzufügen, indem Sie eine [SRT-Datei](https://en.wikipedia.org/wiki/SubRip) einbinden. Verwenden Sie das Feld `subTitleUrl` im Objekt `twitterOptions`, um die URL zu Ihrer SRT-Datei anzugeben. ```json X Subtitles theme={"system"} { "twitterOptions": { "subTitleUrl": "https://img.ayrshare.com/012/captions.srt", "subTitleLanguage": "en", "subTitleName": "English" } } ``` ## Video-Thumbnail Legen Sie ein Thumbnail (Titelbild) für Twitter/X-Videos fest. Das Thumbnail wird vor dem Abspielen des Videos angezeigt und hilft Nutzern, den Videoinhalt zu verstehen. Verwenden Sie `thumbNail` im Objekt `twitterOptions`. ```json Twitter/X Video Thumbnail theme={"system"} { "twitterOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` ## Video-Metadaten Legen Sie einen Titel und eine Beschreibung für ein an X gepostetes Video fest. Diese werden auf die Titel- und Beschreibungsfelder in X Media Studio abgebildet. Verwenden Sie die Felder `videoTitle` und `videoDescription` im Objekt `twitterOptions`. ```json X Video Metadata theme={"system"} { "twitterOptions": { "videoTitle": "My Product Demo", "videoDescription": "A short walkthrough of our latest release." } } ``` ## Video-Monetarisierung (Pro Media) Ayrshare unterstützt die X-(Twitter-)Videomonetarisierung für berechtigte Konten über das Pro-Media-Programm von X. Dies ist eine Funktion mit eingeschränktem Zugang – [kontaktieren Sie uns](mailto:support@ayrshare.com), wenn Sie Zugang wünschen. ## Thread Ein X-Thread, auch als Tweetstorm bekannt, ist eine zusammenhängende Serie von Beiträgen auf X (früher Twitter), mit der Sie längere Gedanken über das Zeichenlimit eines einzelnen Beitrags hinaus teilen können. Zusammen betrachtet erscheinen sie als eine durchgehende Erzählung. X Thread ### Einen Thread posten Ein X-Thread kann über die API gepostet werden. Ein Thread ist ein Beitrag, der in eine Reihe von Antwortthreads aufgeteilt und in X mit einer Linie verbunden ist. Sie können den Beitrag entweder automatisch aufteilen oder die [Thread-Umbrüche](/apis/post/social-networks/x-twitter#thread-breaks) im Beitragstext angeben. ```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 } } ``` Wenn der Beitrag als X-Thread gesendet wird, sind die zurückgegebenen Post-Analytics ein Array von Tweets, `"twitter": []`. Weitere Informationen finden Sie unter [Post-Analytics 200-Antwort](/apis/analytics/post). #### Thread-Medien ##### Medien überspringen Überspringen Sie Medien für den Thread, indem Sie `null` im Array verwenden. Beispiel: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Damit wird image1 in den ersten Tweet, kein Bild in den zweiten und image2 in den dritten Tweet eingefügt. ##### Mehrere Medien Mehrere Medienobjekte können einem Tweet in einem Thread hinzugefügt werden, indem im Array `mediaUrls` ein Objekt `{}` mit den Medien-URLs verwendet wird. Es können beliebige eindeutige Objektschlüssel verwendet werden. Beispiel: ```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" ] } } ``` In diesem Beispiel enthält der erste Tweet photo-1.jpg, der zweite Tweet photo-2.jpg und photo-3.jpg und der dritte Tweet photo-4.jpg. #### Thread-Umbrüche Ayrshare teilt den Beitragstext automatisch in Tweets passender Länge (> 280 Zeichen) auf. Beim Erstellen von Threads wird nach Möglichkeit priorisiert, vollständige Sätze in einem Beitrag zu halten. Passt ein Satz nicht, teilen wir zwischen Sätzen. Bei sehr langen Sätzen teilen wir zwischen Wörtern. In seltenen Fällen, in denen ein Wort zu lang ist, teilen wir das Wort selbst. Sie können außerdem Absätze mit `\n\n` manuell im Beitragstext markieren, um anzugeben, dass ein separater Thread erstellt werden soll. Wenn `\n\n` im Beitragstext vorkommt, teilen wir den Beitrag nicht automatisch in Threads. Beispiel: ```json Example X Thread theme={"system"} { "post": "This is tweet 1\n\nThis is tweet 2.", "platforms": ["twitter"], "twitterOptions": { "thread": true } } ``` führt zu zwei Tweets im Thread. Wenn Sie Absätze hinzufügen möchten, ohne den Beitrag in Tweets aufzuteilen, verwenden Sie `\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 } } ``` führt zu einem Tweet mit zwei Absätzen, da der Beitrag weniger als 280 Zeichen umfasst. ### Einen Thread löschen Um einen Tweet Storm zu löschen, rufen Sie den [/post-Delete-Endpunkt](/apis/post/delete-post) mit der obersten Post-ID auf, die in der Antwort zurückgegeben wurde. Alle Threads werden gelöscht. ## Zeichenbeschränkungen Weitere Informationen finden Sie unter [X-/Twitter-Zeichenbeschränkungen](/help-center/technical-support/character_limits#x%2Ftwitter-character-limits). ## X-Videokompatibilität Manche Videosoftware erzeugt MP4-Dateien, die mit X nicht kompatibel sind. Beispielsweise erstellen Camtasia-Versionen älter als 2019.0.9 MP4-Dateien, die X ablehnt. Auch mehr als eine Audiospur verursacht häufig Probleme. Wenn Sie beim Posten die folgende Meldung zurückerhalten, ist das Video nicht mit Twitter kompatibel und muss neu kodiert werden. `"file is currently unsupported"` Prüfen Sie Ihre Videosoftware auf Kompatibilität. Zum Beispiel bietet Adobe Media Encoder ein Export-Preset für Twitter 1080p Full HD. Adobe Media Encoder Weitere [X-API-Beispiele](https://www.ayrshare.com/twitter-api-how-to-post-and-get-analytics-with-the-twitter-api#twitter-api-examples) finden Sie hier. ## Nur für Abonnenten Sie können einen Beitrag so festlegen, dass er nur für Abonnenten sichtbar ist, indem Sie den Parameter `subscribersOnly` verwenden. ```json X Subscribers Only theme={"system"} { "twitterOptions": { "subscribersOnly": true } } ``` ## Antwort-Einstellungen Sie können die Antwort-Einstellungen eines Beitrags so festlegen, dass nur bestimmte Nutzertypen antworten dürfen. ```json X Reply Settings theme={"system"} { "twitterOptions": { "replySettings": "mentioned" } } ``` Der Parameter `replySettings` kann einen der folgenden Werte annehmen: