> ## 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. # Threads API > Optionen zum Posten mit der Threads API Beim Veröffentlichen auf Threads werden Medien über den serverseitigen Crawler von Meta von Ihrer URL abgerufen. Wenn Sie den Ayrshare-Fehlercode 379 sehen — insbesondere zusammen mit einem Instagram-Fehler 440 oder 138 in derselben Veröffentlichung — siehe [Meta Media Crawler blockiert](/help-center/technical-support/meta_media_crawler_blocked). ## Posten auf Threads JSON für einen einfachen Beitrag mit Link und Bild über die Threads API: ```json Threads Post theme={"system"} { "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["threads"] } ``` Die Threads API hat die folgenden Anforderungen und Einschränkungen: ## Threads-Optionen Sie können zusätzliche Optionen für einen Beitrag über den Parameter `threadsOptions` festlegen. ```json Threads Options theme={"system"} { "threadsOptions": { "allowCountries": ["US", "CA"], "thread": true, "threadNumber": true, "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads } } ``` Threads-Optionen sind optionale Felder, mit denen sich der Beitrag steuern lässt. Beschränken Sie Beiträge auf bestimmte Länder anhand von Ländercodes. Verwenden Sie [Ländercodes](/iso-codes/country). Nur verfügbar, wenn Meta Geo-Beschränkungen für Ihr Konto aktiviert hat. Weitere Informationen finden Sie unter [Threads-Geo-Beschränkungen](/apis/post/social-networks/threads#geo-restrictions). Teilen Sie lange Beiträge in eine zusammenhängende Thread-Serie mit optionaler Nummerierung und Medien. Weitere Informationen finden Sie unter [Thread](/apis/post/social-networks/threads#thread). Fügt automatisch am Ende jedes Threads Nummern im Format 1/n hinzu. Erfordert `thread: true`. Fügen Sie einem Thread aus 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. Weitere Informationen finden Sie unter [Thread-Medien](/apis/post/social-networks/threads#thread-media). ## Zeilenumbrüche oder Rich Text in einem Threads-Beitrag hinzufügen Threads-Zeilenumbrüche können mit einem speziellen [Zeilenumbruchszeichen](/apis/post/post#line-breaks) zu einem Beitrag hinzugefügt werden. Rich Text, etwa fette oder kursive Schrift, lässt sich mit einigen [HTML-Elementen](/apis/post/overview#rich-text-posts) zu einem Threads-Beitrag hinzufügen. ## Karussell aus Bildern und Videos Sie können mehrere Bilder oder Videos als Karussell auf Threads posten; insgesamt können bis zu 20 Bilder oder Videos kombiniert in einem Karussell verwendet werden. Fügen Sie einfach weitere Bilder oder Videos zum Array `mediaUrls` hinzu, und das Karussell wird automatisch erstellt. ```json theme={"system"} "mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...]; // Max 20 images or videos ``` Video-URLs müssen mit einer bekannten Endung wie mp4 enden. ## Zeichenbeschränkungen Weitere Informationen finden Sie unter [Threads-Zeichenbeschränkungen](/help-center/technical-support/character_limits#threads-character-limits). ## Geo-Beschränkungen Sie können einen Beitrag mit dem Array `allowCountries` auf ein bestimmtes Land oder mehrere Länder beschränken. ```json theme={"system"} { "threadsOptions": { "allowCountries": ["US", "CA"] } } ``` Geo-Beschränkungen (Geo-Gating) auf Threads sind nur verfügbar, wenn Meta diese Funktion für Ihr Konto aktiviert hat. Meta entscheidet anhand von Faktoren wie Kontoverifizierung, Follower-Zahl oder Content-Creator-Status, welche Threads-Konten für Geo-Beschränkungen berechtigt sind. Wenn Ihr Konto berechtigt ist, sehen Sie beim Erstellen eines neuen Threads-Beitrags im Beitragseditor die geografischen Einstellungen (Globus-Symbol). Sie können prüfen, ob ein Nutzerprofil für Threads-Geo-Beschränkungen berechtigt ist, indem Sie die Eigenschaft `isEligibleForGeoRestrictions` im [/user](/apis/user/profile-details)-Endpunkt abrufen. ## Threads-Erwähnungen Erwähnen Sie einen anderen Threads-Handle, indem Sie @handle im Beitragstext hinzufügen. Beispiel: ```json theme={"system"} { "post": "The best social media API @Ayrshare ever!", "mediaUrls": ["https://images.com"], "platforms": ["threads"] } ``` Der erwähnte Nutzer (@mention) wird über die Erwähnung benachrichtigt. Bitte lesen Sie die [wichtigen Regeln](/testing/post-verification#mentions) zu Erwähnungen. Wenn das Kontingent erreicht ist, wird eine Fehlermeldung zurückgegeben. ## Thread Ein Threads-Thread, auch bekannt als „Threadstorm", ist eine zusammenhängende Serie von Beiträgen auf Threads, mit der Sie längere Gedanken über die Zeichenbegrenzung eines einzelnen Beitrags hinaus teilen können. Zusammen betrachtet erscheinen sie als eine durchgehende Erzählung. ### Einen Thread posten Ein Threads-Thread kann über die API gepostet werden. Ein Thread ist ein Beitrag, der in eine Reihe zusammengehöriger Antwortbeiträge auf Threads aufgeteilt ist. Sie können den Beitrag entweder automatisch aufteilen oder die [Thread-Umbrüche](/apis/post/social-networks/threads#thread-breaks) im Beitragstext angeben. ```json Threads Thread theme={"system"} { "threadsOptions": { "thread": true, // required for threadstorm "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 } } ``` #### Thread-Medien ##### Medien überspringen Überspringen Sie Medien für einen 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 Beitrag, kein Bild in den zweiten und image2 in den dritten Beitrag eingefügt. ##### Mehrere Medien Mehrere Medienobjekte können einem einzelnen Beitrag 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 Threads Thread with Multiple Media URLs theme={"system"} { "threadsOptions": { "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 Beitrag photo-1.jpg, der zweite Beitrag photo-2.jpg und photo-3.jpg, und der dritte Beitrag photo-4.jpg. #### Thread-Umbrüche Ayrshare teilt den Beitragstext automatisch in für Threads passende Längen (> 500 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 Threads Thread theme={"system"} { "post": "This is post 1\n\nThis is post 2.", "platforms": ["threads"], "threadsOptions": { "thread": true } } ``` führt zu zwei Beiträgen im Thread. Wenn Sie Absätze hinzufügen möchten, ohne den Beitrag aufzuteilen, verwenden Sie `\u2063\n\u2063\n`. ```json Threads Thread with Paragraphs theme={"system"} { "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.", "platforms": ["threads"], "threadsOptions": { "thread": true } } ``` führt zu einem Beitrag mit zwei Absätzen, da der Beitrag weniger als 500 Zeichen umfasst. ### Einen Thread löschen Threads unterstützt keine Löschungen über eine API. Löschungen müssen manuell in der Threads-App erfolgen.