Platform Parameters Reference

This document details the platform-specific parameters, media constraints, and post formats available for each supported social network.

Using platform parameters

Pass platform-specific options in the platforms object when creating a post:

{
  "post": {
    "body": "My post content"
  },
  "profiles": ["instagram", "youtube"],
  "media": ["https://example.com/video.mp4"],
  "platforms": {
    "instagram": {
      "format": "reel",
      "first_comment": "Link in bio!"
    },
    "youtube": {
      "title": "My Video Title",
      "privacy_status": "public"
    }
  }
}

Facebook

Formats

Format	Description
`post`	Feed post (default)
`story`	Facebook Story

Feed post parameters

Parameter	Type	Required	Description
`format`	string	No	Set to `"post"` (default)
`first_comment`	string	No	Comment to add after posting
`page_id`	string	No	Page ID when you have multiple pages

Story parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"story"`
`page_id`	string	No	Page ID when you have multiple pages

Media constraints

Feed post

Media Type	Max Size	Formats	Max Count	Duration
Image	10 MB	jpg, png, gif, webp	10	-
Video	4 GB	mp4, mov	1	1s - 4 hours

Text content: Optional
Media required: No
Mix video and image: No

Story

Media Type	Max Size	Formats	Max Count	Duration
Image	10 MB	jpg, png	1	-
Video	4 GB	mp4, mov	1	3s - 60s

Text content: Not allowed
Media required: Yes
Mix video and image: No
Minimum dimensions: 500x500 pixels

Example

{
  "platforms": {
    "facebook": {
      "format": "post",
      "first_comment": "What do you think? Let us know!",
      "page_id": "123456789"
    }
  }
}

Instagram

Formats

Format	Description
`post`	Feed post (default)
`reel`	Instagram Reel
`story`	Instagram Story

Feed post parameters

Parameter	Type	Required	Description
`format`	string	No	Set to `"post"` (default)
`first_comment`	string	No	Comment to add after posting
`collaborators`	array	No	List of collaborator usernames

Reel parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"reel"`
`first_comment`	string	No	Comment to add after posting
`cover_url`	string	No	URL of cover image for the reel
`audio_name`	string	No	Name of the audio
`trial_strategy`	string	No	Trial strategy for trial reels (`"MANUAL"` or `"SS_PERFORMANCE"`)
`collaborators`	array	No	List of up to 3 collaborator usernames
`thumb_offset`	string	No	Thumbnail offset in milliseconds. If both offset and cover_url are provided, cover_url takes precedence

Story parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"story"`

Media constraints

Feed post

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png	10	-
Video	300 MB	mp4, mov	1	3s - 60min

Text content: Optional (caption)
Media required: Yes
Mix video and image: Yes (carousel)
Minimum dimensions: 200x200 pixels

Reel

Media Type	Max Size	Formats	Max Count	Duration
Video	300 MB	mp4, mov	1	3s - 90min

Text content: Optional (caption)
Media required: Yes (video only)
Mix video and image: No

Story

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png	1	-
Video	100 MB	mp4, mov	1	1s - 60min

Text content: Not allowed
Media required: Yes
Mix video and image: No
Minimum dimensions: 200x200 pixels

Examples

// Feed post with carousel
{
  "platforms": {
    "instagram": {
      "format": "post",
      "first_comment": "Follow for more content!",
      "collaborators": ["username1", "username2"]
    }
  }
}

// Reel
{
  "platforms": {
    "instagram": {
      "format": "reel",
      "first_comment": "Full tutorial on our channel!",
      "cover_url": "https://example.com/thumbnail.jpg",
      "audio_name": "Trending Audio Track",
      "trial_strategy": "MANUAL",
      "collaborators": ["username1", "username2"],
      "thumb_offset": "5000"
    }
  }
}

TikTok

Formats

Format	Description
`post`	Feed post (default)

Parameters

Parameter	Type	Required	Description
`privacy_status`	string	No	Privacy setting for the video
`photo_cover_index`	integer	No	Index (0-based) of photo to use as cover
`auto_add_music`	boolean	No	Enable automatic music
`made_with_ai`	boolean	No	Mark content as AI-generated
`disable_comment`	boolean	No	Disable comments on the post
`disable_duet`	boolean	No	Disable duets
`disable_stitch`	boolean	No	Disable stitches
`brand_content_toggle`	boolean	No	Mark video as paid partnership promoting a third-party business
`brand_organic_toggle`	boolean	No	Mark video as paid partnership promoting your own brand

Privacy status values

Value	Description
`PUBLIC_TO_EVERYONE`	Visible to all users
`MUTUAL_FOLLOW_FRIENDS`	Visible to mutual followers
`FOLLOWER_OF_CREATOR`	Visible to followers only
`SELF_ONLY`	Private (only you)

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	20 MB	jpg, gif	35	-
Video	4 GB	mp4, mov, av, webm	1	3s - 10min

Text content: Optional (caption)
Media required: Yes
Mix video and image: No
Minimum video dimensions: 720x1280 pixels

Example

{
  "platforms": {
    "tiktok": {
      "privacy_status": "PUBLIC_TO_EVERYONE",
      "auto_add_music": true,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false,
      "made_with_ai": false,
      "brand_content_toggle": false,
      "brand_organic_toggle": false
    }
  }
}

Formats

Format	Description
`post`	Feed post (default)

Parameters

Parameter	Type	Required	Description
`organization_id`	string	No	Post on behalf of an organization/company page

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png, gif	20	-
Video	5 GB	mp4, mov, avi	1	0 - 15min

Text content: Optional
Media required: No
Mix video and image: No
Minimum image dimensions: 552x276 pixels

Example

// Post to personal profile
{
  "platforms": {
    "linkedin": {}
  }
}

// Post to company page
{
  "platforms": {
    "linkedin": {
      "organization_id": "12345678"
    }
  }
}

YouTube

Formats

Format	Description
`post`	Channel video (default)

Parameters

Parameter	Type	Required	Description
`title`	string	No	Video title
`privacy_status`	string	No	Video visibility setting
`cover_url`	string	No	URL of custom thumbnail image

Privacy status values

Value	Description
`public`	Visible to everyone
`unlisted`	Only accessible via link
`private`	Only visible to you

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Video	256 GB	mp4, mov, avi, wmv, flv, 3gp	1	1s+

Text content: Optional (description)
Media required: Yes (video only)
Mix video and image: No
Note: The post body becomes the video description

Example

{
  "platforms": {
    "youtube": {
      "title": "How to Build an API Integration",
      "privacy_status": "public",
      "cover_url": "https://example.com/custom-thumbnail.jpg"
    }
  }
}

X (Twitter)

Formats

Format	Description
`post`	Tweet (default)

Parameters

X (Twitter) does not have custom parameters. Content format is determined automatically based on media.

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	5 MB	jpg, png, webp, gif	4	-
Video	512 MB	mp4, mov	1	1s - 140s

Text content: Optional
Media required: No
Mix video and image: No
Minimum image dimensions: 4x4 pixels
Minimum video dimensions: 32x32 pixels
Maximum text length: 280 characters (standard accounts)

Example

{
  "platforms": {
    "twitter": {}
  }
}

Threads

Formats

Format	Description
`post`	Feed post (default)

Parameters

Threads does not have custom parameters.

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png, gif, webp	20	-
Video	1 GB	mp4, mov	1	0 - 5min

Text content: Optional
Media required: No
Mix video and image: Yes
Minimum dimensions: 200x200 pixels

Example

{
  "platforms": {
    "threads": {}
  }
}

Cross-platform posting tips

Text-only posts

Supported on: Twitter, LinkedIn, Facebook, Threads

{
  "post": {
    "body": "Exciting announcement coming soon!"
  },
  "profiles": ["twitter", "linkedin", "threads"]
}

Image carousel

Supported on: Instagram, Facebook, Twitter (up to 4), LinkedIn (up to 20)

{
  "post": {
    "body": "Check out these photos!"
  },
  "profiles": ["instagram", "facebook"],
  "media": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg",
    "https://example.com/photo3.jpg"
  ]
}

Video content

When posting the same video to multiple platforms, use platform-specific parameters:

{
  "post": {
    "body": "New video is live!"
  },
  "profiles": ["youtube", "tiktok", "instagram"],
  "media": ["https://example.com/video.mp4"],
  "platforms": {
    "youtube": {
      "title": "Tutorial: Getting Started",
      "privacy_status": "public"
    },
    "tiktok": {
      "privacy_status": "PUBLIC_TO_EVERYONE"
    },
    "instagram": {
      "format": "reel"
    }
  }
}

Validation errors

The API validates media against platform constraints before publishing. Common validation errors:

Error	Cause
”Media is required for feed post on Instagram”	Instagram posts need at least one image or video
”Too many images for Feed post on Twitter (max: 4)“	Twitter allows max 4 images
”Content is not allowed for story on Instagram”	Stories don’t support text content
”Cannot mix video and image for feed post on Facebook”	Some platforms don’t allow mixed media