Threads Upload API Videos, Images & Text

Post content to Threads programmatically. Meta's Threads API simplified.

Start Free
threads-upload.ts 
import { UploadPost } from 'upload-post';

const uploader = new UploadPost('your-api-key');

await uploader.upload('video.mp4', {
  title: 'My Threads post',
  platforms: ['threads']
});

Can you post to Threads via API?

Yes. Meta opened an official Threads API, and Upload-Post wraps it into one REST call (platform[]=threads) for text posts, photos, videos and mixed carousels. No Meta developer app or app review needed. Posts respect Threads’ 500-character limit and support scheduling and a first comment.

Threads API Features

Video Posts

Upload native videos to Threads feeds.

Image Posts

Share images with captions.

Carousels

Post multi-image carousels.

Text Posts

Create text-only posts and conversations.

Scheduling

Schedule posts for optimal engagement.

Analytics

Track likes, reposts and engagement.

How do you post to Threads with one request?

One POST to /api/upload. Send a file or a public URL

Request (cURL) 
curl -X POST https://api.upload-post.com/api/upload \
  -H 'Authorization: Apikey your-api-key-here' \
  -F 'user=my-profile' \
  -F 'platform[]=threads' \
  -F 'video=@/path/to/clip.mp4' \
  -F 'title=Shipping week: everything new in 60 seconds'
Response (200 OK) 
{
  "success": true,
  "results": {
    "threads": {
      "success": true,
      "url": "https://www.threads.net/@you/post/..."
    }
  },
  "usage": { "count": 11, "limit": 100 }
}

Long uploads switch to background automatically; poll the Upload Status endpoint with your request_id. Full reference in the Upload API docs.

What are the Threads content requirements and limits?

What the API accepts for Threads: sizes, formats and platform limits

Requirement Value
Text Up to 500 characters per post
Images JPEG/PNG, up to 8 MB; width 320-1440 px; aspect ratio 10:1 to 1:10
Video MP4/MOV, up to 5 minutes; 9:16 recommended for feed reach
Carousels Up to 10 items per post; photos and videos can be mixed in one carousel
Color space sRGB (other color spaces are converted automatically)
Scheduling scheduled_date (ISO-8601) up to 365 days ahead, or add_to_queue

Threads limits verified July 2026: 500-character posts, 5-minute videos, 10-item carousels. Need to reformat a video first? Use the FFmpeg API.

Threads API Parameters

The most-used fields for the Threads upload endpoint

Parameter Type Required Description
threads_title String No Threads-specific text (max 500 chars). Falls back to the global title field.
photos[] / video File / URL No Media to publish: single image, video, or up to 10 items as a carousel (mixed photos + videos allowed).
first_comment String No Automatically reply to your own post. Useful for links, since link posts get less reach.
scheduled_date String No ISO-8601 date to schedule the post up to 365 days ahead.

Full parameter reference in the API documentation.

Start posting to Threads in minutes

Three steps to integrate the Threads API

1

Create your account

Sign up for Upload-Post and grab your API key from the dashboard.

2

Connect Threads

Link your Threads destination once from the dashboard. We handle auth and delivery for you.

3

Upload programmatically

POST to the API with your content and you're live. Schedule or queue posts the same way.

Threads API FAQ

Common questions about posting to Threads programmatically

Does Threads have an official API?

Yes, Meta released the official Threads API in 2024. Using it directly requires a Meta developer app and review. Upload-Post operates an approved integration, so you connect your Threads account once and publish with a single REST call, with no app review on your side.

What is the Threads character limit for API posts?

500 characters per post, the same as in the app. If your text is longer, shorten it or move the overflow to a first_comment. Upload-Post returns a clear validation error rather than silently truncating.

Can I post carousels with photos and videos mixed?

Yes. Threads (like Instagram) supports mixed carousels, and Upload-Post lets you combine up to 10 photos and videos in a single post via the photos/video fields.

Can I schedule Threads posts via API?

Yes. Add scheduled_date (ISO-8601, up to 365 days ahead, optional timezone) and the API returns a job_id you can edit or cancel, or use add_to_queue for your preset posting slots.

Can the same API call post to Threads, X and Bluesky at once?

Yes. Text-first networks pair naturally: send one request with platform[] set to threads, x and bluesky and each network receives an adapted version (Threads 500 chars, X threads split at 280, Bluesky 300).

Prefer an AI agent? Use the Threads MCP server. Plans and limits are in the pricing section.

Ready to automate your Threads presence?

Start posting to Threads programmatically today.

Create Free Account