publora-threads（公共话题）

Publora — Threads

Threads platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.

Base URL: https://api.publora.com/api/v1 Header: x-publora-key: sk_YOUR_KEY Platform ID format: threads-{accountId}

⚠️ Temporary Restriction — Thread Nesting Unavailable

Multi-threaded nested posts are temporarily unavailable on Threads due to Threads app reconnection status.

This means: content over 500 characters that would normally auto-split into connected reply chains does not work right now.

What still works normally:

• Single posts (text, images, videos, carousels)
• Standalone posts under 500 characters

Contact support@publora.com for updates on when thread nesting will be restored.

Platform Limits (API)

Post a Single Thread

await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Building in public is the best marketing strategy. Here\'s why 👇',
    platforms: ['threads-17841412345678']
  })
});

Schedule a Post

body: JSON.stringify({
  content: 'Your Threads post here',
  platforms: ['threads-17841412345678'],
  scheduledTime: '2026-03-20T10:00:00.000Z'
})

Post with Image

// Step 1: Create post
const post = await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Caption for your image post',
    platforms: ['threads-17841412345678']
  })
}).then(r => r.json());

// Step 2: Get upload URL
const upload = await fetch('https://api.publora.com/api/v1/get-upload-url', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postGroupId: post.postGroupId,
    fileName: 'photo.jpg',
    contentType: 'image/jpeg',
    type: 'image'
  })
}).then(r => r.json());

// Step 3: Upload to S3
await fetch(upload.uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': 'image/jpeg' },
  body: imageBytes
});

Thread Nesting (temporarily unavailable)

When restored, long content auto-splits into connected posts. Three methods:

Auto-split (content > 500 chars): Publora splits at paragraphs/sentences/words, adds (1/N) markers.

Manual --- separator:

body: JSON.stringify({
  content: 'First post.\
\
---\
\
Second post.\
\
---\
\
Third post.',
  platforms: ['threads-17841412345678']
})

Explicit [n/m] markers: Publora detects [1/3], [2/3] format and splits at those points exactly.

⚠️ Currently all nested threading is disabled. Single posts, images, carousels work normally.

Media in threads: Images/video attach to the first post only. Subsequent posts are text-only.

Reply Control (platformSettings)

Control who can reply to posts:

body: JSON.stringify({
  content: 'Your post here',
  platforms: ['threads-17841412345678'],
  platformSettings: {
    threads: {
      replyControl: 'mentioned_only'  // or: 'accounts_you_follow', 'everyone', '' (default)
    }
  }
})

Platform Quirks

• Connected via Meta OAuth — same account as Instagram
• Max 1 hashtag per post — more than 1 may be ignored or rejected by Threads
• 5 links per post max — enforced at the API level
• PNG supported — unlike Instagram, Threads accepts PNG images; WebP auto-converted
• Video carousels limited — video support in carousels is limited; use images for carousels
• Nested threading disabled — see the notice at the top of this skill