Networks
Detailed platform-specific capabilities, content support, and limitations for all social networks available via the Publer API.
Supported Networks
Network
Provider
Content Types
Media Support
Character Limit
facebook
status, photo, video, link, carousel
Images, videos, links
10,000
instagram
photo, video, carousel, story, reel
Images, videos
2,200
Twitter/X
twitter
status, photo, video, link
Images, videos, links, polls
280 (25,000 for premium)
linkedin
status, photo, video, link, document, polls
Images, videos, documents, links
3,000
pinterest
photo, video
Images, videos, links
500
Google Business
google
status, photo, video, link
Images, videos, links
1,500
TikTok
tiktok
video, single or multi-photo/carousel posts
Videos
2,200
YouTube
youtube
video, shorts
Videos
No fixed limit (100 chars min)
Telegram
telegram
status, photo, video, link
Images, videos, links
4,096
Mastodon
mastodon
status, photo, video, link, polls, gif
Images, videos, links
500+ (server dependent)
Threads
threads
status, photo, video
Images, videos
500
Bluesky
bluesky
status, photo, video
Images, videos
300
Network-Specific Details
Facebook
Provider: facebook
Content Types:
Text posts
Text posts with background color
Photo posts (single or multiple)
Video posts
Link posts
Carousel posts
Stories
Limitations:
Text: 10,000 characters
Photos: Up to 10 per post
Videos: Up to 240 minutes, 10GB max file size
Link previews: Automatically generated from URL
Special Considerations:
Page permissions required for business pages
Video aspect ratio: 16:9 to 9:16 supported
Image aspect ratio: 1.91:1 to 1:1 recommended
Hashtags supported but used less frequently than other platforms
Example:
"facebook": {
"type": "status",
"text": "Facebook-specific content with more detailed formatting"
}Instagram
Provider: instagram
Content Types:
Photo posts (single or multiple)
Video posts
Carousel posts
Stories
Reels
Limitations:
Text (caption): 2,200 characters
Photos: Up to 10 per carousel
Videos: Up to 60 minutes, 10GB max file size
Stories: 15 seconds per segment
Reels: 3-90 seconds
Special Considerations:
Business account required for API posting
Image aspect ratio: Between 1.91:1 and 4:5 (square 1:1 recommended)
Cannot post links in captions (they won't be clickable)
First comments can be auto-posted with hashtags
Example:
"instagram": {
"type": "carousel",
"text": "Instagram caption with #hashtags",
"media": [
{"id": "media_id_1", "type": "image"},
{"id": "media_id_2", "type": "image"}
]
}Twitter/X
Provider: twitter
Content Types:
Text posts
Photo posts (single or multiple)
Video posts
Link posts
Polls
Limitations:
Text: 280 characters (25,000 for premium accounts)
Photos: Up to 4 per tweet
Videos: Up to 140 seconds for standard users
URLs count as 23 characters regardless of length
GIFs limited to 15MB
Special Considerations:
Developer account required for API access
Hashtags and @mentions count toward character limit
Media attachments no longer count toward the 280 character limit
Alt text for images highly recommended
Example:
"twitter": {
"type": "status",
"text": "Concise Twitter post with #hashtags and @mentions"
}LinkedIn
Provider: linkedin
Content Types:
Text posts
Photo posts
Video posts
Link posts
Document posts (PDFs)
Limitations:
Text: 3,000 characters
Photos: Up to 9 per post
Videos: Up to 15 minutes, 5GB max file size
Documents: PDF format, 100MB max
Special Considerations:
Supports markdown-style formatting (bold, italic, bullets)
Company page access requires admin privileges
More formal tone typically recommended
Professional content performs best
Example:
"linkedin": {
"type": "status",
"text": "**Professional announcement** with formatted text:\n\n• Point one\n• Point two\n• Point three"
}Pinterest
Provider: pinterest
Content Types:
Photo pins
Video pins
Limitations:
Description: 500 characters
Images: 20MB max, 1000x1500px recommended
Videos: 30 seconds minimum, 15 minutes maximum
Special Considerations:
Must include an image or video (no text-only posts)
Vertical images (2:3 ratio) perform best
Board selection required when posting
Alt text important for search optimization
Example:
"pinterest": {
"type": "photo",
"text": "Pin description with #hashtags",
"board_id": "board_id_here",
"media": [{"id": "media_id", "type": "image"}]
}Google Business Profile
Provider: google
Content Types:
Text posts
Photo posts
Video posts
Link posts
Limitations:
Text: 1,500 characters
Photos: Up to 10 per post
Videos: Up to 30 seconds
Special Considerations:
Location ID required for multi-location businesses
Posts expire after 7 days by default
Call-to-action buttons available (Learn more, Book, Order, etc.)
Location-specific content recommended
Example:
"google": {
"type": "status",
"text": "Local business update with important information",
"location_id": "location_id_here",
"cta": {
"type": "LEARN_MORE",
"url": "https://example.com/details"
}
}TikTok
Provider: tiktok
Content Types:
Video posts
Single or multi-photo/carousel posts
Limitations:
Caption: 2,200 characters
Videos: 3 seconds to 10 minutes
File size: 500MB maximum
Carousels can be up to 10 photos. At the moment, videos cannot be included in a carousel post.
Special Considerations:
Business account required for API posting
Vertical video format (9:16) required
Sound/music highly recommended
Cannot edit video after posting
Example:
"tiktok": {
"type": "video",
"text": "Caption with #hashtags #fyp",
"media": [{"id": "video_id", "type": "video"}]
}YouTube
Provider: youtube
Content Types:
Video posts
Shorts
Limitations:
Title: 100 characters
Description: 5,000 characters
Tags: Up to 500 characters total
Videos: Up to 12 hours, 256GB maximum
Shorts need to be shot vertically and be up to 3 minutes long.
Special Considerations:
Channel verification required for longer videos
Thumbnail image can be specified
Category selection required
Privacy setting options (public, private, unlisted)
Example:
"youtube": {
"type": "video",
"text": "Video description with timestamps and links",
"title": "Video Title Here",
"media": [{"id": "video_id", "type": "video"}],
"privacy": "public",
"category": "22" // People & Blogs category
}Telegram
Provider: telegram
Content Types:
Text posts
Photo posts
Video posts
Link posts
Limitations:
Text: 4,096 characters per message
Photos: Up to 10 per post
Videos: Up to 2GB per file
File attachments: Up to 2GB
Special Considerations:
Bot API token required
Channel or group specified by chat ID
Markdown and HTML formatting supported
Silent posting option available
Example:
"telegram": {
"type": "status",
"text": "Telegram message with *bold* and _italic_ formatting",
"disable_notification": false
}Mastodon
Provider: mastodon
Content Types:
Text posts
Photo posts
Video posts
Link posts
Gif Posts
Limitations:
Text: 500 characters minimum (varies by server)
Photos: Up to 4 per post
Videos: Format and size limits vary by server
GIFs need to be less than 8 MB and have a resolution up to 1280x720 pixels.
Special Considerations:
Instance URL required for posting
Content warnings can be specified
Visibility options: public, unlisted, private, direct
Alt text essential for accessibility
Example:
"mastodon": {
"type": "status",
"text": "Mastodon post with #hashtags",
"visibility": "public",
"content_warning": "Optional content warning"
}Threads
Provider: threads
Content Types:
Text posts
Photo posts
Video posts
Limitations:
Text: 500 characters
Photos: Up to 10 per post
Videos: Up to 5 minutes
Special Considerations:
Requires Instagram business account connection
Cannot schedule posts for specific times via API
No direct link posting (links are non-clickable)
Hashtags supported but used differently than Instagram
Example:
"threads": {
"type": "status",
"text": "Threads update with conversational tone"
}Bluesky
Provider: bluesky
Content Types:
Text posts
Photo posts
Limitations:
Text: 300 characters
Photos: Up to 4 per post
Special Considerations:
Decentralized platform in beta stage
API access requires developer invitation
Custom domains and handles supported
Limited media format support
Example:
"bluesky": {
"type": "status",
"text": "Bluesky post with limited characters but #tags",
"media": [{"id": "image_id", "type": "image"}]
}Media Specifications
Image Requirements
Network
Optimal Dimensions
Aspect Ratio
Max File Size
1200x630px
1.91:1
8MB
1080x1080px
1:1 to 4:5
8MB
1200x675px
16:9
5MB
1200x627px
1.91:1
5MB
1000x1500px
2:3
20MB
Google Business
1200x900px
4:3
5MB
Telegram
1280x720px
16:9
10MB
Mastodon
1200x900px
4:3
Server dependent
Threads
1080x1080px
1:1 to 4:5
8MB
Bluesky
1200x675px
16:9
5MB
Video Requirements
Network
Optimal Dimensions
Aspect Ratio
Duration
Max File Size
1280x720px
16:9
1s - 240m
10GB
1080x1920px
9:16
3s - 60m
650MB
1280x720px
16:9
0.5s - 140s
512MB
1920x1080px
16:9
3s - 15m
5GB
1080x1920px
9:16
4s - 15m
2GB
TikTok
1080x1920px
9:16
3s - 10m
500MB
YouTube
1920x1080px
16:9
No minimum - 12h
256GB
Telegram
1280x720px
16:9
No limits
2GB
Threads
1080x1920px
9:16
3s - 5m
650MB
Best Practices
Cross-Platform Posting
Provide network-specific overrides under
networksfor optimal formatting.Adjust media dimensions to each platform’s specs.
Tailor text length to char limits.
Platform Selection
Choose networks based on audience and content type.
Leverage visual platforms (Instagram, Pinterest) for images/video-heavy campaigns.
Use LinkedIn for professional announcements; Facebook/Instagram for broad reach.
Error Prevention
Pre-validate media compatibility via upload responses’
validityflags.Poll job status to catch and handle errors early.
Related Topics
Content Types - Detailed information about different content formats
Media Handling - Guide to uploading and managing media files
Publishing Methods - Options for publishing to different networks
Last updated
Was this helpful?