X (Twitter) APIthrough Siar.

At a glance

Account needed: Any X account. X charges for API usage, so X actions draw from a prepaid credit balance.

Media rules

What Siar can do on X (Twitter)

Siar can create comments and replies up to 280 characters, and import the comments people leave on your posts.

Publish a post

Put X (Twitter)'s payload under data.TWITTER and list TWITTER in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "X (Twitter) post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "TWITTER"
    ],
    "data": {
      "TWITTER": {
        "text": "Hello from Siar",
        "uploadIds": [
          "UPLOAD_ID"
        ],
        "mediaItems": [
          {
            "uploadId": "UPLOAD_ID"
          }
        ]
      }
    }
  }'

X (Twitter) fields

• text string nullable
• uploadIds string[] nullable
• mediaItems object[] nullable
  2 fields

  • uploadId string required
  • altText string nullable max length 1,000
• replySettings string nullable
  One of: EVERYONE FOLLOWING MENTIONED_USERS SUBSCRIBERS VERIFIED
• poll object nullable
  2 fields

  • options string[] required min 2 itemsmax 4 itemseach: min length 1each: max length 25
  • durationMinutes integer required ≥ 5≤ 10080
• quoteTweetId string nullable
• replyToTweetId string nullable
• subscribersOnly boolean nullable
• thread object[] nullable max 25 items
  2 fields

  • text string nullable max length 25,000
  • uploadIds string[] nullable
• tweetStorm boolean nullable
• tweetStormNumbering boolean nullable
• isAiGenerated boolean nullable default false

Daily caps

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a X (Twitter) account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

• tweet.read
• tweet.write
• users.read
• offline.access
• media.write
• like.read
• like.write
• tweet.moderate.write

X pricing

X bills each API call, so these actions are paid from a prepaid credit balance at X's price with no markup. Everything not listed is free.

X (Twitter)-specific operations

These exist for X (Twitter) only and live under /misc/twitter.

When X (Twitter) says no

Siar relays X (Twitter)'s error code and message verbatim on the post, next to a status you can act on. The X (Twitter) error reference covers 13 common cases with what each one means and the fix. Open the X (Twitter) error reference.