Media & Text Validation
Understanding platform-specific validation requirements for media files and text content when using PostPulse API.
Important Notice
PostPulse Web enforces rich, platform-specific validations automatically. However, API clients must currently validate content themselves. Server-side validations for API clients are planned for future releases.
When using the PostPulse API directly or through n8n integration, you are responsible for ensuring your content meets each platform's requirements. This page provides a comprehensive reference of all validation rules you need to implement.
Platform Validation Requirements
The following table shows validation requirements across all supported platforms:
| Validation Rule | PostPulse Web | PostPulse API (Current) |
|---|---|---|
| Twitter/X | ||
| Standard users can post up to 280 characters per tweet | UI warning | You must validate |
| Supported image formats are JPG, PNG, and WEBP | Enforced | Enforced |
| Image size should be less than or equal 5MB | Enforced | Enforced |
| Video size should be less than or equal 512MB | Enforced | Enforced |
| Maximum 4 media attachments | Enforced | Enforced |
| Video duration must be between 0.5 sec and 140 sec | Enforced | You must validate |
| Media aspect ratio between 1:3 and 3:1 | Enforced | You must validate |
| Threads | ||
| Users can post up to 500 characters | Enforced | Enforced |
| Topic tag should be less than 100 characters | Enforced | Enforced |
| When no topic tag is specified and content contains a word with # - the first word with # will be used as topic tag (except cases with numbers, like #1) | UI warning | You must validate |
| Image size should be less than or equal 8MB | Enforced | Enforced |
| Media aspect ratio between 0.01:1 and 10:1 | Enforced | You must validate |
| Video duration must be less than 5 min | Enforced | You must validate |
| Supported video format is MP4 | Enforced | Enforced |
| YouTube | ||
| Title should be less than 100 characters | Enforced | Enforced |
| Description should be less than 5000 characters | Enforced | Enforced |
| TikTok | ||
| Title should be less than 2200 characters for video post | Enforced | Enforced |
| Title should be less than 90 characters for image post | Enforced | Enforced |
| Description should be less than 4000 characters for image post | Enforced | Enforced |
| Image size should be less than or equal 20MB | Enforced | Enforced |
| Image picture size must not exceed 1080p (shorter side at most 1080px) | To Do | Enforced |
| Supported image formats are JPG, PNG, and WEBP | Enforced | Enforced |
| Supported video formats are MP4, MOV, and WebM | Enforced | Enforced |
| Video duration as per individual limits (typically 1 hour) | Enforced | You must validate |
| One post is either 1 video or up to 10 images | Enforced | Enforced |
| Video should have between 360 and 4096 pixels for both height and width | To Do | You must validate |
| Video frame rate must be between 23 and 60 fps | To Do | Enforced |
| User can post up to 3000 characters | Enforced | Enforced |
| One post can contain either 1 video or up to 9 images (or no media at all) | Enforced | Enforced |
| Supported video format is MP4 | Enforced | Enforced |
| Video size should be less than or equal 500MB | Enforced | Enforced |
| Video duration must be between 3 sec and 30 min | Enforced | You must validate |
| User can post up to 63206 characters | Enforced | Enforced |
| Supported image formats are JPG and PNG | Enforced | Enforced |
| Image size should be less than or equal 10MB | Enforced | Enforced |
| A feed post can contain either up to 20 images (in a carousel) or up to 1 video, or no media at all | Enforced | Enforced |
| Feed post media aspect ratio between 1.91:1 and 4:5 | Enforced | You must validate |
| Supported video formats are MP4 and MOV | Enforced | Enforced |
| Video size should be less than or equal 4GB | Enforced | Enforced |
| Feed and Story post video duration must be between 3 sec and 15 min | Enforced | You must validate |
| Reels video duration must be between 3 sec and 90 sec | Enforced | You must validate |
| Reels and Story post media aspect ratio between 0.01:1 and 10:1 | Enforced | You must validate |
| Reels and Story recommended aspect ratio is 9:16 | UI Warning | You must validate |
| Video should have no more than 1920 horizontal pixels | Enforced | You must validate |
| The video should have a bitrate of 25 Mbps or less | To Do | You must validate |
| User can post up to 2200 characters | Enforced | Enforced |
| Supported image formats are JPG and PNG | Enforced | Enforced |
| Image size should be less than or equal 8MB | Enforced | Enforced |
| Feed post can contain up to 10 media (carousel) | Enforced | Enforced |
| Feed post media aspect ratio between 1.91:1 and 4:5 | Enforced | You must validate |
| Supported video formats are MP4 and MOV | Enforced | Enforced |
| Video size should be less than or equal 300MB | Enforced | Enforced |
| Feed and Story post video duration must be between 3 sec and 15 min | Enforced | You must validate |
| Reels video duration must be between 3 sec and 15 min | Enforced | You must validate |
| Reels and Story post media aspect ratio between 0.01:1 and 10:1 | Enforced | You must validate |
| Reels and Story recommended aspect ratio is 9:16 | UI Warning | You must validate |
| Video should have no more than 1920 horizontal pixels | Enforced | You must validate |
| The video should have a bitrate of 25 Mbps or less | To Do | You must validate |
| Bluesky | ||
| Users can post up to 300 characters | Enforced | Enforced |
| Post may contain up to 4 images | Enforced | Enforced |
| Telegram | ||
| Users can post up to 4096 characters | Enforced | Enforced |
| Standard user can post up to 1024 characters if post contains media as well | Enforced | Enforced |
| One post may contain up to 10 media | Enforced | Enforced |
| Supported image formats are JPG, PNG, and WEBP | Enforced | Enforced |
| Supported video format is MP4 | Enforced | Enforced |
Implementation Guidelines
📝 Text Validation
- Always check character limits before posting
- Consider platform-specific features (hashtags, mentions)
- Account for emoji characters which may count differently
- Validate special fields like titles and topic tags
🖼️ Image Validation
- Check file format compatibility with target platforms
- Validate file size limits for each platform
- Verify aspect ratio requirements
- Ensure image dimensions meet platform standards
🎥 Video Validation
- Verify video format support (MP4, MOV, WebM)
- Check duration limits for each platform
- Validate file size restrictions
- Ensure resolution meets platform requirements
📊 Multi-Media Posts
- Respect maximum media count per post
- Understand platform-specific media mixing rules
- Consider carousel vs. single media requirements
- Account for thumbnail requirements where applicable
Best Practices
🔍 Pre-Upload Validation
Always validate content before uploading to PostPulse. This saves API calls and prevents failed posts.
📋 Platform-Specific Checks
Implement validation logic that checks requirements for each target platform in your publication list.
⚠️ Error Handling
Provide clear error messages when validation fails, indicating which platform requirements weren't met.
🔄 Future-Proofing
Stay updated with platform changes and monitor PostPulse release notes for validation updates.
🚀 Coming Soon
We're working on implementing server-side media validations for API clients. This will provide the same robust validation experience as our web application. Follow our release notes for updates.