Threads

What you can post

Type	Supported	Max media	Notes
Text only	✅	0	First URL in text becomes a link preview
Single image	✅	1	JPEG, PNG. Max 8 MB
Single video	✅	1	MP4/MOV. Max 1 GB, max 5 min
Carousel	✅	20	Mix of images and videos. Min 2 items

Limitations

500 character limit. Emojis count as their UTF-8 byte length, not as 1 character. A single emoji like 🚀 uses 4 bytes, so heavy emoji use reduces your effective limit.
250 API-published posts per 24-hour moving period. Carousels count as 1 post. This is a Threads API limit, not a PublishQ limit.

Posting to Threads alongside other platforms

Threads has a 500-character limit, but platforms like Facebook or LinkedIn allow much longer content. You don't need to create a separate post — use postOverrides on the Threads account entry to provide shorter content just for Threads while keeping the full text for other platforms.

{
  "content": "Your long-form content for Facebook, LinkedIn, etc...",
  "accounts": [
    { "accountId": "facebook-account-id" },
    { "accountId": "linkedin-account-id" },
    {
      "accountId": "threads-account-id",
      "postOverrides": {
        "content": "Short version for Threads 🧵"
      }
    }
  ],
  "publishNow": true
}

Quick start

Post text

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "First post from the API 🚀",
    "accounts": [
      { "accountId": "your-threads-account-id" }
    ],
    "publishNow": true
  }'

Post an image with text

Get your media ready

You can upload new media or use existing media from your library.

curl -X POST https://publishq.com/api/v1/media \
  -H "Authorization: Bearer pq_live_..." \
  -F "[email protected]"

curl https://publishq.com/api/v1/media \
  -H "Authorization: Bearer pq_live_..."

Pick the id of the media you want to use from the response.

Create the post

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Check this out",
    "mediaIds": ["media-id-from-step-1"],
    "accounts": [
      { "accountId": "your-threads-account-id" }
    ],
    "publishNow": true
  }'

Post a carousel

Attach 2–20 media items. You can mix uploaded and existing media. Photos and videos can also be mixed.

Get your media ready

Upload new files or list your existing media using the steps above. You need at least 2 media IDs.

Create the post

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Photo dump",
    "mediaIds": ["media-id-1", "media-id-2", "media-id-3"],
    "accounts": [
      { "accountId": "your-threads-account-id" }
    ],
    "publishNow": true
  }'

Platform-specific settings

Pass these inside platformSpecificSettings on the Threads account entry.

Field	Type	Description
`topicTag`	`string (optional)`	A topic tag for the post (without the # prefix). Max 50 characters. Periods (.) and ampersands (&) are not allowed. Overrides any auto-detected topic from inline hashtags.

Full schema: ThreadsPlatformSpecificSettings

{
  "content": "My best shots from this week",
  "mediaIds": ["media-id-1", "media-id-2", "media-id-3"],
  "accounts": [
    {
      "accountId": "threads-account-id",
      "platformSpecificSettings": {
        "topicTag": "photography"
      }
    }
  ],
  "publishNow": true
}

Media specs

Images

Spec	Value
Formats	JPEG, PNG
Max file size	8 MB
Max width	1440px (downscaled if larger)
Min width	320px (upscaled if smaller)
Aspect ratio	Up to 10:1

Videos

Spec	Value
Formats	MP4, MOV
Max file size	1 GB
Duration	0–300 seconds (5 min)
Frame rate	23–60 FPS
Max resolution	1920px wide
Aspect ratio	0.01:1 to 10:1 (9:16 recommended)
Video codec	H.264 or HEVC
Audio codec	AAC, max 48kHz, mono or stereo

Not yet supported

GIF attachments — Threads only supports GIFs from GIPHY. Personal GIF uploads are not allowed by the Threads API.
First comment (coming soon)
Reposts and quote posts
Polls
Spoiler tags

On this page