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)
`reel`	Facebook Reel
`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	Yes	Page ID when you have multiple pages. Leave blank if you only have one page

Character limit: 63,206 characters

Reel Parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"reel"`
`title`	string	No	Title of the reel
`page_id`	string	No	Page ID when you have multiple pages. Use `/api/profiles/:id/placements` to get available pages

Character limit: 63,206 characters

Story parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"story"`
`page_id`	string	Yes	Page ID when you have multiple pages. Use `/api/profiles/:id/placements` to get available 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 (max 2,196 characters)
`collaborators`	array	No	List of collaborator usernames

Character limit: 2,200 characters

Reel parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"reel"`
`first_comment`	string	No	Comment to add after posting (max 2,196 characters)
`cover_url` / `cover_file`	string / file	No	Cover image for the reel. Pass `cover_url` (URL) in JSON or `cover_file` (file upload) in multipart. See Cover Images
`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

Character limit: 2,200 characters

Story parameters

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

Rate limits

100 posts per day per user (24-hour rolling window, across all Instagram formats)
Instagram can also limit too frequent posting with an error saying “User is performing too many actions”. In this case you need to slow down your posting and wait for some time.

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
Image	-	-	0	-
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
`video`	Video post (default)
`image`	Image post (up to 35 images)

Video parameters

Parameter	Type	Required	Description
`format`	string	No	Set to `"video"` (default)
`privacy_status`	string	Yes	Privacy setting for the video
`made_with_ai`	boolean	No	Mark content as AI-generated
`disable_comment`	boolean	No	Disable comments
`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

Character limit: 2,200 characters

Image parameters

Parameter	Type	Required	Description
`format`	string	Yes	Set to `"image"`
`privacy_status`	string	Yes	Privacy setting for the post
`photo_cover_index`	integer	No	Index (0-based) of photo to use as cover
`auto_add_music`	boolean	No	Enable automatic music
`disable_comment`	boolean	No	Disable comments
`brand_content_toggle`	boolean	No	Mark post as paid partnership promoting a third-party business
`brand_organic_toggle`	boolean	No	Mark post as paid partnership promoting your own brand

Character limit: 2,200 characters

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

Video

Media Type	Max Size	Formats	Max Count	Duration
Video	4 GB	mp4, mov, av, webm	1	3s - 10min

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

Image

Media Type	Max Size	Formats	Max Count	Duration
Image	20 MB	jpg, gif	35	-

Text content: Optional (caption)
Media required: Yes

Examples

// Video post
{
  "platforms": {
    "tiktok": {
      "format": "video",
      "privacy_status": "PUBLIC_TO_EVERYONE",
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false,
      "made_with_ai": false,
      "brand_content_toggle": false,
      "brand_organic_toggle": false
    }
  }
}

// Image post
{
  "platforms": {
    "tiktok": {
      "format": "image",
      "privacy_status": "PUBLIC_TO_EVERYONE",
      "photo_cover_index": 0,
      "auto_add_music": true
    }
  }
}

Formats

Format	Description
`post`	Feed post (default)

Parameters

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

Character limit: 3,000 characters

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
Document	100 MB	pdf, doc, docx, ppt, pptx	1	-

Text content: Optional
Media required: No
Mix video and image: No
Mix documents with images/videos: No
Minimum image dimensions: 552x276 pixels
Document max pages: 300

Example

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

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

// Post with document
{
  "post": {
    "body": "Check out our latest report"
  },
  "profiles": ["linkedin"],
  "media": ["https://example.com/report.pdf"],
  "platforms": {
    "linkedin": {
      "organization_id": "12345678"
    }
  }
}

YouTube

Formats

Format	Description
`post`	Channel video (default)

Parameters

Parameter	Type	Required	Description
`title`	string	No	Video title (max 100 characters)
`privacy_status`	string	Yes	Video visibility setting
`cover_url` / `cover_file`	string / file	No	Custom thumbnail image (requires a verified YouTube account). Pass `cover_url` (URL) in JSON or `cover_file` (file upload) in multipart. See Cover Images
`made_for_kids`	boolean	No	Whether the video is made for kids
`tags`	array	No	List of tags for the video
`category_id`	string	No	YouTube video category ID (defaults to `"22"` / People & Blogs)
`contains_synthetic_media`	boolean	No	Disclose if the video contains altered or synthetic (AI-generated) content

Character limit: 5,000 characters (description)

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
Image	0	-	0	-
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",
      "made_for_kids": false
    }
  }
}

X (Twitter)

Formats

Format	Description
`post`	Tweet (default)

Parameters

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

Threads

X supports threads (tweet chains). See the Threads section in the Posts API docs for details.

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
Character limit: 280 characters (free accounts) or 25,000 characters (paid accounts)

Example

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

Threads

Formats

Format	Description
`post`	Feed post (default)

Parameters

Threads does not have custom parameters.

Character limit: 500 characters

Threads (Conversations)

Threads supports thread conversations (sequential replies). See the Threads section in the Posts API docs for details.

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": {}
  }
}

Formats

Format	Description
`pin`	Pin (default)

Parameters

Parameter	Type	Required	Description
`title`	string	No	Title of the pin (max 100 characters)
`board_id`	string	Yes	ID of the board. Use `/api/profiles/:id/placements` to get available boards
`destination_link`	string	No	URL of the destination link (max 2,048 characters)
`cover_url` / `cover_file`	string / file	No	Cover image (video only). Pass `cover_url` (URL) in JSON or `cover_file` (file upload) in multipart. See Cover Images
`thumb_offset`	integer	No	Thumbnail image offset in seconds (video only)

Character limit: 500 characters (description)

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	32 MB	jpg, gif, png, webp	1	-
Video	2 GB	mp4, mov	1	4s - 15min

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

Example

{
  "platforms": {
    "pinterest": {
      "title": "10 Tips for Better Photography",
      "board_id": "987654321",
      "destination_link": "https://example.com/blog/photography-tips"
    }
  }
}

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"
    }
  }
}

Thread posts

Supported on: X (Twitter), Threads

{
  "post": {
    "body": "1/ Here is a thread about our launch"
  },
  "profiles": ["twitter", "threads"],
  "thread": [
    {
      "body": "2/ First, we built the foundation...",
      "media": ["https://example.com/screenshot.jpg"]
    },
    { "body": "3/ Then we added the features..." },
    { "body": "4/ Check it out at example.com" }
  ]
}

Thread children can also include media arrays. See the Threads section in the Posts API docs for full details.

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
”Documents are not supported for feed post on Twitter”	Platform doesn’t support document uploads
”Too many documents for Feed post on LinkedIn (max: 1)“	LinkedIn allows max 1 document per post
”Cannot mix documents with images or videos for feed post on LinkedIn”	Documents must be posted alone

Platform Parameters Reference

Using platform parameters

Facebook

Formats

Feed post parameters

Reel Parameters

Story parameters

Media constraints

Feed post

Story

Example

Instagram

Formats

Feed post parameters

Reel parameters

Story parameters

Rate limits

Media constraints

Feed post

Reel

Story

Examples

TikTok

Formats

Video parameters

Image parameters

Privacy status values

Media constraints

Video

Image

Examples

LinkedIn

Formats

Parameters

Media constraints

Example

YouTube

Formats

Parameters

Privacy status values

Media constraints

Example

X (Twitter)

Formats

Parameters

Threads

Media constraints

Example

Threads

Formats

Parameters

Threads (Conversations)

Media constraints

Example

Pinterest

Formats

Parameters

Media constraints

Example

Cross-platform posting tips

Text-only posts

Image carousel

Video content

Thread posts

Validation errors