Threads API Reference
Publish text posts, images, video, and carousels to Threads.
Quick reference
| auth | OAuth 2.0 (Meta) |
| text Limit | 500 characters |
| max Media | 10 items (carousel) |
| media Rule | Text-only posts are allowed |
| max Video Duration | 5 min |
| entity Selection | None |
| first Comment | Supported — 500 chars; thread-target comments supported |
Content types
✓Text
Up to 500 characters
✓Images
JPEG, PNG, WebP. Max 8 MB.
✓Video
MP4 or MOV. Max 1 GB. Up to 5 minutes.
✓Carousel
Up to 10 items
—GIF
Not supported
Media requirements
Constraints enforced by Threads's API. Requests that violate these limits will be rejected.
| Constraint | Value |
|---|---|
| Max image size | 8 MB |
| Max video size | 1 GB |
| Image formats | JPEG, PNG, WEBP |
| Video formats | MP4, QUICKTIME |
| Max video duration | 5 min |
| Image aspect ratio | 4:5 to 1.91:1 |
| Min image dimensions | 320x320 px |
| Max media items | 10 |
| GIF support | No |
Platform settings
Threads does not have platform-specific settings. Use the standard content, mediaItems, and scheduledFor fields.
Code examples
Basic post
curl -X POST https://schedulala.com/api/v1/posts \-H "Authorization: Bearer sk_live_YOUR_KEY" \-H "Content-Type: application/json" \-d '{"content": "Just posted from the API!","platforms": [{ "platform": "threads", "accountId": "acc_thr" }],"publishNow": true}'
Post with media
curl -X POST https://schedulala.com/api/v1/posts \-H "Authorization: Bearer sk_live_YOUR_KEY" \-H "Content-Type: application/json" \-d '{"content": "Thread with media","platforms": [{ "platform": "threads", "accountId": "acc_thr" }],"mediaItems": [{ "type": "image", "url": "https://example.com/photo.jpg" }],"publishNow": true}'
Quirks & gotchas
!
Video max: 1 GB — most generous for video among short-text platforms.
!
Image aspect ratio must be between 4:5 and 1.91:1.
!
Minimum image dimensions: 320x320 px.
!
GIFs are not supported.
!
No platform-specific settings — uses standard post fields only.