X API

​

X BYO-API-Schlüssel

​

Posten auf X (Twitter)

{
  "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 zeigt automatisch eine Vorschau des Links im Tweet an, sofern kein Bild oder Video enthalten ist. Im obigen Beispiel wird das Bild angezeigt. Wenn Sie das Bild entfernen, wird die Link-Vorschau angezeigt.
• Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter isVideo. Weitere Informationen finden Sie unter /post-Endpunkt.
• X unterstützt auch das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten, senden Sie einen leeren String post: "".
• Sie können bis zu 4 Bilder oder Videos in einem einzelnen Tweet hochladen. Beachten Sie die wichtigen Richtlinien und Einschränkungen beim Posten von Twitter-Videos.
• Weitere Informationen finden Sie unter X-Medienrichtlinien und X-Autorisierung.

​

X-Optionen

{
  "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"],
  }
}

​

Alt-Text

{
  "twitterOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}

​

Geo-Beschränkungen

{
  "twitterOptions": {
    "blockCountries": ["US", "CA"]
  }
}

{
  "twitterOptions": {
    "allowCountries": ["GB", "IE"]
  }
}

• blockCountries: Ein Array von zu blockierenden Ländercodes. Siehe Ländercodes.
• allowCountries: Ein Array von zulässigen Ländercodes. Siehe Ländercodes.

​

Long Post

{
  "twitterOptions": {
    "longPost": true
  }
}

​

Long Video

{
  "twitterOptions": {
    "longVideo": true
  }
}

​

Erwähnungen

{
  "post": "The best social media API @Ayrshare ever!",
  "platforms": ["twitter"]
}

​

Umfragen

{
  "twitterOptions": {
    "poll": {
      "duration": 5, // required. Number in minutes
      "options": ["yes", "maybe", "no"] // required
    }
  }
}

• duration: Eine Zahl in Minuten, die die Dauer der Umfrage angibt.
• options: Ein Array von Strings mit den Umfrageoptionen.

​

Quote Tweet

{
  "twitterOptions": {
    "quoteTweetId": "651601430669664256" // low-level Tweet Id
  }
}

​

Antwort-Einstellungen

{
  "twitterOptions": {
    "replySettings": "mentioned"
  }
}

• following: Nur Nutzer, denen das X-Konto folgt, können antworten.
• mentioned: Nur Nutzer, die im Beitrag erwähnt werden, können antworten.
• subscribers: Nur Nutzer, die Abonnenten des postenden X-Kontos sind, können antworten.
• verified: Nur auf X verifizierte Nutzer können auf den Beitrag antworten.

​

Nur für Abonnenten

{
  "twitterOptions": {
    "subscribersOnly": true
  }
}

​

Untertitel/Captions für Videos

{
  "twitterOptions": {
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English"
  }
}

• subTitleUrl: Eine gültige SRT-Datei. Die URL muss mit https:// beginnen und mit .srt enden und eine gültige SRT-Datei sein.
• subTitleLanguage: Optional: Die Sprache der Untertitel. Muss ein gültiger Sprachcode sein. Standard: „en”.
• subTitleName: Optional: Der Name der Untertitelspur. Der Name wird dem Nutzer als Auswahl während der Wiedergabe angezeigt. Maximal 150 Zeichen unterstützt. Standard: „English”.

​

Video-Thumbnail

{
  "twitterOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

• thumbNail: Eine URL zum Thumbnail-Bild. Unterstützte Bildformate sind JPEG, PNG, BMP und WebP.
• Das Thumbnail-Bild sollte den Videoinhalt repräsentieren und visuell ansprechend sein, um Engagement zu fördern.
• Bildanforderungen finden Sie unter X-Medienrichtlinien.

​

Video-Metadaten

{
  "twitterOptions": {
    "videoTitle": "My Product Demo",
    "videoDescription": "A short walkthrough of our latest release."
  }
}

• videoTitle: Der Titel für das Video, abgebildet auf das Titelfeld in X Media Studio.
• videoDescription: Die Beschreibung für das Video, abgebildet auf das Beschreibungsfeld in X Media Studio.

​

Video-Monetarisierung (Pro Media)

​

Thread

​

Einen Thread posten

{
    "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
    }
}

• thread: true, um den Beitragstext automatisch anhand von Zeilenumbrüchen in Threads aufzuteilen.
• threadNumber: true, um automatisch am Ende der Threads Nummern im Format 1/n hinzuzufügen. Zum Beispiel wird der 2. von 5 Threads mit 2/5 versehen.
• mediaUrls: [array of urls], um jedem Thread der Reihe nach ein Medienobjekt (ein Bild oder Video) hinzuzufügen. Es wird jeweils nur ein Medienobjekt pro Thread in Reihenfolge hinzugefügt.

​

Thread-Medien

Medien überspringen

Mehrere Medien

{
  "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"
    ]
  }
}

​

Thread-Umbrüche

{
  "post": "This is tweet 1\n\nThis is tweet 2.",
  "platforms": ["twitter"],
  "twitterOptions": {
    "thread": true
  }
}

{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["twitter"],
  "twitterOptions": {
    "thread": true
  }
}

​

Einen Thread löschen

​

Zeichenbeschränkungen

​

X-Videokompatibilität

​

Nur für Abonnenten

{
  "twitterOptions": {
    "subscribersOnly": true
  }
}

​

Antwort-Einstellungen

{
  "twitterOptions": {
    "replySettings": "mentioned"
  }
}

• following: Nur Nutzer, denen das X-Konto folgt, können antworten.
• mentioned: Nur Nutzer, die im Beitrag erwähnt werden, können antworten.
• subscribers: Nur Nutzer, die Abonnenten des postenden X-Kontos sind, können antworten.
• verified: Nur auf X verifizierte Nutzer können auf den Beitrag antworten.