Platform Guide

Twitter / X

Twitter/X is the strongest thread and first-comment platform in UniPost today. Use it when you need fast text publishing, reply chains, and media-aware posts with precise limits.

Overview

Twitter/X supports text-only posts, image posts, video posts, and multi-post threads. It is also one of the networks where first-comment style publishing works well because UniPost can create a self-reply after the main tweet lands.

Supported capabilities

Capability	Supported	Notes
Text posts	✓	Up to 280 characters
Image posts	✓	Up to 4 images
Video posts	✓	Exactly 1 video
GIF posts	✓	Exactly 1 GIF
Threads	✓	Use `thread_position`
First comment	✓	Posted as a reply after publish

Requirements

Field	Required	Limits	Notes
caption	Optional	280 chars	Required unless media-only flow is valid
media_urls	Optional	1-4 images OR 1 video OR 1 GIF	Do not mix media types
thread_position	Optional	1-indexed	Use on each thread entry
first_comment	Optional	text	Supported as a self-reply

Example requests

The examples below are intentionally small and copyable. They show the request body only, assuming a standard POST /v1/social-posts call with Bearer auth.

Image post

{
  "caption": "Launching today 🚀",
  "account_ids": ["sa_twitter_1"],
  "media_urls": [
    "https://cdn.example.com/hero.jpg",
    "https://cdn.example.com/screenshot.png"
  ]
}

Video post

{
  "caption": "Watch the demo 👇",
  "account_ids": ["sa_twitter_1"],
  "media_urls": ["https://cdn.example.com/demo.mp4"]
}

Thread with first comment

If you want a follow-up comment rather than a thread, send `first_comment` on a single post instead of using `thread_position`.

{
  "platform_posts": [
    {
      "account_id": "sa_twitter_1",
      "caption": "1/ Here is what changed",
      "thread_position": 1
    },
    {
      "account_id": "sa_twitter_1",
      "caption": "2/ Here is why it matters",
      "thread_position": 2
    }
  ]
}

Common validation errors

Code	What it means
caption_too_long	Caption exceeds 280 characters
too_many_media	More than 4 images or unsupported media mix
thread_unsupported	Invalid thread shape or missing `thread_position` ordering

Once you know the correct request shape for this platform, move to the API reference for the full endpoint contract, response schema, and validation payload shape.