Links

Twitter

Options for posting via the API to Twitter

Twitter API Endpoint

Overview

JSON for a basic post with a link and image to Twitter:
{
"post": "The best Tweet ever #best https://www.twitter.com",
"mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
"platforms": ["twitter"]
}
  • Twitter will automatically preview the link in the Tweet unless there is an image or video included. In the above example the image will show. Removing the image will cause the link preview to show.
  • If your video doesn't end in a known video extension such as mp4, please use the isVideo parameter. See the /post endpoint for details.

Upload Long Videos

Business or Enterprise Plan required.
Twitter requires videos have a maximum video length of 2 minutes and 20 seconds. However, if you have a have been approved by Twitter to upload longer videos, such as in the Amplify Partner Program, you can post videos up to 10 minutes in length.
In addition to Twitter approving your account for long videos, your Aryshare account must be enabled for long Twitter videos. Please contact us to enable this feature.
After your Ayrshare account is enabled for long videos and Twitter has approved your access, use the longVideo twitterOptions parameter when posting:
{
"twitterOptions": {
"longVideo": true
}
}

Twitter Mentions

Mention another Twitter handle by adding @handle in the post text. For example:
{
"post": "The best social media API @Ayrshare ever!",
"platforms": ["twitter"]
}
Please review the important rules on mentions.

Post Twitter Thread (TweetStorm)

A Twitter Thread or TweetStorm can be posted via the API. A thread is a post broken up into a set of reply threads and link in Twitter with a line.
  • thread: true to automatically break apart the post text into threads.
  • threadNumber: true to automatically add numbers at the end of threads in the format of 1/n. For example the 2nd of 5 threads will have appended: 2/5
  • mediaUrls: [array of urls] to add each media object, an image or video, to a thread in order. Only one media object will be added to a thread in order.
{
"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
}
}

Skip Images and Multiple Media URLs

Skip an image for the thread by using null in the array. For example:
["https://site.com/image1.png", null, "https://site.com/image2.png"]
This will place image1 on the first Tweet, no image on the second Tweet, and image2 on the third Tweet.
Multiple images can be added to a Tweet in a Thread by adding an object {} with the media URLs in the mediaUrls array. Any unique object keys can be used. For example:
{
"twitterOptions": {
"thread": true,
"threadNumber": true,
"mediaUrls": [
"https://site.com/image1.png",
{"1": "https://site.com/image2.png", "2": "https://site.com/image3.png"},
"https://site.com/image4.png",
...]
}
}
In this example, the first Tweet will contain image1, the second Tweet image2 and image3, and the third Tweet image4.

Thread Output

Ayrshare automatically breaks up the post text into appropriate length tweet (> 280 characters). Add paragraphs to the post text to indicate a unique thread should be created. For example:
{
"post": `This is the first thread.
This is the second thread.
And this is the final thread.`
}

Delete Twitter Thread

To delete a Tweet Storm, call the /post delete endpoint with the top level post ID returned in the response. All threads will be deleted.

Alternative Text for Images

Add alternative text, also known as alt text, to a Tweet's image. Twitter alt text is an accessibility feature used for additional user info and screen readers.
Use the altText in the twitterOptions object.
"twitterOptions": {
"altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
}
Each alt text must correspond to an image in the mediaUrls array. The alt text will be applies to each image in order.
Notes:
  • Alt text can not be applied to videos. If a video is included in the mediaUrls with altText, the video will not be posted.
  • Alt text must be 1,000 characters or less.

Twitter Mentions

Mention other Twitter handles by simply including the handle beginning with the @ symbol in the post text. For example:
{
"post": "Love the @ayrshare social media api"
}
Please see here for more information on mentions.

Twitter Video Compatibility

Some video software creates MP4 files that are not compatible with Twitter. For example, Camtasia versions older than 2019.0.9 create MP4 files that Twitter rejects. Also more than one audio track often causes problems.
If you receive back the following message while posting, it indicates the video is not compatible with Twitter and needs to be re-encoded.
"file is currently unsupported"
Please check your video software for compatibility. For example, Adobe Media Encoder has an export preset for Twitter 1080p Full HD.
Adobe Media Encoder
Last modified 13d ago