Write

Post content to one or more platforms simultaneously. Per-platform formatting is handled automatically.

POST/v1/social/write

Example request

result = client.write(
    platforms=["x", "instagram"],
    content={
        "text": "Markets today 📈",
        "media": "chart.jpg"
    }
)

for r in result.results:
    if r.success:
        print(f"Posted to {r.platform}: {r.url}")
    else:
        print(f"Failed on {r.platform}: {r.error}")

Request body

Field	Type	Description
platformsrequired	string[]	Array of target platforms. Each platform must be authenticated for your account.
contentrequired	object	Post content. Must include text, media, or both.
content.text	string	Post body. Auto-truncated per platform limits (280 chars on X, etc).
content.media	string \| string[]	URL or array of URLs to media files. Images, videos, GIFs supported.
content.alt_text	string	Accessibility alt text for media. Recommended for compliance.
options	object	Per-platform overrides. e.g. options.instagram.format = 'feed' \| 'stories'.

Example body

{
  "platforms": ["x", "instagram"],
  "content": {
    "text": "Markets looking spicy today 🌶️",
    "media": "https://example.com/chart.png",
    "alt_text": "Stock chart showing 15% gain"
  },
  "options": {
    "x": { "reply_to": null },
    "instagram": {
      "format": "feed",
      "first_comment": "#stocks #trading"
    }
  }
}

Response

Field	Type	Description
results	array	One result object per requested platform, in the same order as the request.
results[].platform	string	Platform identifier.
results[].success	boolean	Whether the post succeeded on this platform.
results[].post_id	string \| null	Platform-native post ID. Null on failure.
results[].url	string \| null	Direct URL to the published post. Null on failure.
results[].error	string \| null	Error message if success is false.
credits_used	number	Total credits consumed for this multi-platform write.

Example response

{
  "results": [
    {
      "platform": "x",
      "success": true,
      "post_id": "1234567890",
      "url": "https://x.com/user/status/1234567890",
      "published_at": "2026-04-25T14:22:00Z"
    },
    {
      "platform": "instagram",
      "success": true,
      "post_id": "ig_abc123",
      "url": "https://instagram.com/p/abc123",
      "published_at": "2026-04-25T14:22:01Z"
    }
  ],
  "credits_used": 0.015
}