Threads API

Threads has the following requirements and restrictions:

• Threads profiles are limited to 250 API-published posts within a 24-hour moving period.
• Threads only allows 1 hashtag per post.
• @mention Threads users will receive a notification.
• Maximum 500 post characters.

• Multi-image/videos posts are supported and sent as a carousel. You may send up to 20 videos and images.

• Threads does not support deletes via an API. Deletes must occur manually using the Threads app.

• 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.

• Threads also supports sending media without post text. If you do not want post text included send an empty String post: "".

• See Threads Media Guidelines and Threads Authorization for more information.

JSON for a basic post with an image and hashtags to Threads:

{
  "post": "The best Threads post ever #best #awesome https://www.threads.net",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}

​

Carousel of Images and Videos

You can post multiple images or videos to Threads as a carousel; up to a combined total of 20 images or videos may be use in a carousel. Just add your additional images or videos to the mediaUrls array and the carousel will automatically be created.

"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos

Video URLs must end in a known extension such as mp4.

​

Threads Mentions

Mention another Threads handle by adding @handle in the post text. For example:

{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}

If the quota has been reached, an error message will be returned.

​

Adding line breaks or rich text to an Threads post

Threads line breaks can be added to a post with a special new line character.

Rich text, such as bold or italic lettering, can be added to a Threads post with a few html elements.