Publish posts to Threads with support for images, videos, and mixed media. Simple API, powerful results.
One API call handles Threads posts with flexible media support.
Combine videos and images in a single post
Publish text-only or media-rich content
Create carousel posts with up to 20 images
Upload videos up to 1 GB and 5 minutes long
curl -X POST "https://api.postproxy.dev/api/posts" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "post": { "body": "Exciting announcement coming soon! Stay tuned." }, "profiles": ["threads"], "media": ["https://example.com/image.jpg"], "platforms": { "threads": {} } }'| Format | Description |
|---|---|
post | Feed post (default) |
| Media Type | Max Size | Formats | Max Count | Duration |
|---|---|---|---|---|
| Image | 8 MB | jpg, png, gif, webp | 20 | - |
| Video | 1 GB | mp4, mov | 1 | 0 - 5min |
View full documentation for all platform-specific features for Threads
No need to handle Threads API, OAuth flows, or rate limits. Postproxy handles it all.
Threads rate limits are managed automatically with intelligent retry logic.
Publish text posts, images, videos, or mixed media through one unified API.
Automatic retries and clear status reporting ensure your content reaches Threads.
Threads uses Meta's Threads API, which follows a container-based publishing flow similar to Instagram's. You create a media container with your content (text, image, or video), wait for it to process, then publish it. Unlike Instagram, Threads supports text-only posts without media attachments. The API is tied to Instagram accounts — you publish to Threads through the Instagram user ID. Postproxy handles the container creation and publishing steps in a single request.
Threads supports four content types: text-only posts (up to 500 characters), single image posts, single video posts, and carousel posts with up to 10 mixed media items. Each type uses a slightly different container creation flow, and carousels require creating individual item containers before wrapping them in a carousel container. Postproxy detects the content type from your request and handles the correct flow automatically.
Threads' API has a few non-obvious constraints: the 500-character text limit, a rate limit of 250 posts per 24-hour window, and a requirement that media containers finish processing before you can publish them (with no webhook — you must poll). Videos have specific format requirements and a 5-minute maximum duration. The API also returns different error codes for rate limiting vs. content policy violations, which can be confusing. Postproxy validates content constraints upfront, manages polling, and provides clear error messages.
Each Threads post can specify who can reply: everyone, accounts_you_follow, or mentioned_only. This is set at container creation time and can't be changed after publishing. Postproxy exposes this as a simple reply_control parameter, defaulting to everyone if not specified.
Common questions about Threads integration
Start with our free plan and scale as your needs grow. No credit card required.