Skip to content
Docs

Guide

Post to X without living in the developer console.

platform: x

Schedule posts, threads, polls and media to X through Socialit. We run the OAuth app, the media upload steps and the rate limits. X bills API usage per call, so we pass it through at cost from prepaid credits.

Connect

Sign in with X (OAuth). Socialit refreshes tokens in the background.

Use the hosted or headless flow described in Connecting accounts. Once connected, the account appears in GET /v1/accounts?platform=x.

Publish

Post typeLimits and notes
TextUp to 280 characters. Up to 25,000 characters with X Premium
ImagesUp to 4 per post
Video–
Threads–
Polls–
POST /v1/posts
curl https://api.socialit.com/v1/posts \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Focus mode is live. Open one account, use everything.",
    "account_ids": [
      "sa_x…"
    ],
    "scheduled_at": "2026-10-14T09:00:00.000Z",
    "platform_options": {
      "x": {
        "reply_settings": "following"
      }
    }
  }'

Network-specific options go under platform_options.x (schemas: GET /v1/posts/platform-options). Socialit validates them before publishing and returns 422 with per-field errors otherwise.

Capabilities

PublishingYes
Direct messagesYes
CommentsYes
ReviewsNo
MentionsYes
AnalyticsPost and account metrics
Edit after publishingYes
Delete or unpublishYes
First commentNo
AdsX Ads

Focus mode

In Focus mode a X account exposes:

  • Threads, quote posts, replies and polls
  • Likes, reposts and bookmarks
  • Follows, lists and mutes
  • Direct messages
  • Mentions and search
  • Post metrics: impressions, engagements, link clicks

Each resource is also available at /v1/accounts/{id}/focus/{resource}.